Live Category Filter allows the System User to create a list of pages which exist in one or more categories.
Lister element
Drag and drop the Lister element onto the page or template.
1. Configure the element and select the Live Category Filter source type. The following view will be presented:
2. Edit/Configure:
Include Restricted Results
By default the Lister will only present pages that the end user has permission to view. If required, check to allow restricted pages to appear in the Lister. Note: the user will be prompted to login when clicking on a restricted page.
Filter By
Select either System Categories or Page Categorisation, as required. Note that System Categories generates a list of pages based on one or more selected categories, as detailed below. Page Categories returns a list of pages which match the categories which have been applied to the page containing the Lister element. In effect, the Lister is auto-populated.
System Categorisation
1. Select a Path Filter to restrict the Lister to returning pages beneath a nominated parent page. This could be a specific landing page or the welcome page.
2. Click Add to add categories to the Must be in Any/All/None of fields as required in order to create a custom list of pages.
Page Categorisation
1. Select a Path Filter to restrict the Lister to returning pages beneath a nominated parent page. This could be a specific landing page or the welcome page.
2. Select a starting point in the category tree. Easysite will return pages which exist in categories below this starting point.
In the example below, if the System User selected the News Landing page and the Location parent category, the Lister would return pages which exist beneath the News page, but are in any categories below Location which the page containing the Lister have been added to.
Order By
Select appropriate option
Direction
Select appropriate option.
Display Tab
3. Click on the Display tab. The following view will be presented:
5. Edit/Configure
View
Select to display the list of pages as either a vertical List or a Dropdown list.
Maximum Items
Enter an appropriate value.
Randomise
By default the pages are listed as ordered above. If required, check to randomise the list. The list will be updated on each page refresh.
Header/Title
Enter an appropriate heading for the list of pages.
Footer
If required, enter appropriate Footer text.
Style
Select appropriate Theme for the Lister.
Alternating Row Style
If created via the Theme, select an appropriate style.
Num. Columns
By default the Lister displays a single list of pages. if required, the Lister may be divided into a number of columns.
More Information Page
Select if required.
More Information Text
If required, add appropriate linking text for the More Information page.
Show Title
By default, the title of the page will be exposed as a link.
Show Images
If required, an image may be selected to illustrate the page in the Lister. Select an appropriate Custom Size for the image. If required, check to use the page Avatar as the image. Alternatively, leave blank to use the image nearest the top left hand corner of the page.
Show Author
Check if required
Show Summary
If required check to expose the page Summary as introductory text for the article. Note that a character limit may be applied.
Show Published Date
Check if required, and format the date appropriately.
Display No Results Message
If required, check and enter an appropriate message.
Open Links in New Window
Check if required.
Paging
4. Click on the Paging tab. The following view will be presented
Enable Paging
If required, check to paginate the list of pages and enter the number of articles to be displayed on each page.
