Creating a page for posts
- Either use the page wizard or right click on the navigation tree to create a new page.
- Right click on the new page in the tree and select edit page properties.
- From the content layout drop down select one of the layouts prefixed with 'posts:' there will be one of these for each of your post types.
- Click publish to save and publish your changes.
The following section relates to editing your new posts page. Double click on the newly created post page to open it in a popup window.
The top field is a rich text block labeled 'introduction' which you can use to add some textual context to the top of your post page (10.2).
Next is a button labeled 'Edit <your posttype name> properties' opens a pop up allowing you to configure the relevant post type. This is the same popup as you see in the post type configuration.
Below the properties button are the following fields:
- Format drop down: the options for this are:
- List: This is a straight ordered list of all the posts.
- Calendar: This is a grid based calendar.
- Diary: this is a columnar month view.
- A to Z: This is an A to Z list create using either the 'fieldname' field or 'tag' field for that post, the choice being made via the 'alphabetise by' drop down below.
- Order by drop down: This doesn't appear if the format above is calendar. The options for this are:
- Name: order by the post type Fieldname.
- Start Date (newest first)
- Start Date (oldest first)
- Alphabetise by: If the format selected was A to Z, then this drop down allows you to choose between creating and A to Z from the post fieldname or the posts assocated tags (10.3)
- Categorise By: If one of your post type's fields is itself a post type then it will appear here as an option to create categorisation on. This will appear as a category filter in the page display.
- Facet by: a multi select drop down based on the related post types to the post in question. It's used to create an ajax based faceted search via check boxes, complete with the relevant counts of related data (10.3)
- Page size: the numbers of items per page or leave blank to show the whole list (10.2). We recommend that you always paginate with 10 or 20 in this value as it help performance for large datasets.
- XSL URL for list page: this allows you to override the standard XSL used to display the list output and customise it for your own use.
- XSL URL for post page: most of the post pages have an option to click through to get more details on an individual post. This allows you to override the standard XSL used to display the detailed output on this page and customise it for your own use.
- Include related items checkbox: Again if one your post type's fields is itself a post type and one of your resulting posts contains a reference to another post then ticking this box will allow a click though on the data display to that second associated post.
- Additional XML parameters - These parameters get passed to the XML when the 'list' version of the page is generated front-end. The list page is produced by the searchposts web service defined here so this feature can be used to apply additional fixed filtering to the page. For example, you may have a post type of 'festival', which has a custom field of 'genre'. A 'Folk Festival Page' can then be made that only lists the folk festivals by adding the XML parameter '&custom_genre=folk' to this field.
- Cache period in minutes - Added in 10.5 used to improve performance the default cache period is 60 minutes. When a cache period is entered, the post searches that are used to generate the front-end markup are cached for the specified period. No caching is done when a user is logged in. When the post page is published, the cache is flushed for that page.
Finally after you've made any changes click publish to save and publish.