Understanding filtered lists
You can create filtered list pages to help users find related content on the University website.
The Events list is an example of a simple filtered list. This shows all the pages on the website that use the Event content type.
This list of tuition fees pages is more complex, showing pages filtered by their:
- owning organisation (University of Bath)
- subtype (Factsheet)
- Labels (taughtpostgraduate and previousfees)
A filtered list page can only show published pages in a single content type. For example, you can't show Campaign pages and Case studies in the same filtered list.
The filtered list for each content type shows the pages in alphabetical order, apart from the list for:
- Announcements, which lists the pages by the date they were first published, showing the most recent first
- Events, which lists pages by the event's start date, with the next event first - past events don't appear in the list
Filtered list URL structure
Filtered list pages have their own URLs, which change as you add more filters.
If you look at each section of the URL, you can see which information is being filtered.
|https://www.bath.ac.uk/events/||the content type used|
|f.Department+or+group%7CX=Human+Resources||the owner of the content|
|f.Type%7CY=Courses+and+workshops||the subtype used|
|meta_label_and=learninganddevelopment||the Label used|
|f.Audience%7CZ=Staff||the audience for the content (Event pages only)|
|f.Month%7CU=January||the month the event takes place (Event pages only)|
|f.Year%7CV=2023||the year the event takes place (Event pages only)|
Create a filtered list
You can create filtered lists for most content types. These are the basic filtered list pages for each one:
- Announcements - bath.ac.uk/announcements/
- Campaigns - bath.ac.uk/campaigns/
- Case studies - bath.ac.uk/case-studies/
- Corporate information - bath.ac.uk/corporate-information/
- Events - bath.ac.uk/events/
- Guides - bath.ac.uk/guides/
- Locations - bath.ac.uk/locations/
- Person profiles - bath.ac.uk/profiles/
- Projects - bath.ac.uk/projects/
- Publications - bath.ac.uk/publications/
- Service starts - bath.ac.uk/services/
- Team profiles - bath.ac.uk/teams/
There are two ways of creating a filtered list. You can:
- select the filters you need from a basic list page
- construct the list page's URL to add the filters you need
Using either method, you can add:
- filters in any order
- as many filters as you need to make the list more specific
- more than one of the same filter - for example, you can show Events with the subtypes Exhibitions, Conferences, and Presentations
Selecting filters on the list page
To create a filtered list by selecting the filters:
- Open the basic filtered list page for the content type of the pages you want to list.
- Select the filters you need from under the heading 'Refine your results'.
The filters you can choose depend on the content in the filtered list. For example, if the list is filtered to show events starting in March, you can only choose from the subtypes of pages for events that start in March.
You can't select Labels as a filter. If you want to add a filter for a Label, follow the instructions for constructing the filtered list page URL.
Constructing the filtered list page URL
If you can't create the list you need using the filters on the basic list page, you can edit the URL in your browser's address bar until the page shows the content you need.
To do this:
- Open the basic list page for the content type of your pages.
- In your browser's address bar, add '?' after the URL, for example, 'bath.ac.uk/events/?'
- Copy and paste the URL code for the filter you want to add from the 'URL codes' table on this page - use the same uppercase and lowercase characters as in the table or the URL won't work.
- After the '=' symbol, add the filter information, like the name of the owning organisation, subtype, or Label you want to filter the list by - if the filter information is more than one word, replace the space between each word with '+'
- To add a new filter, add '&' after the filter information and repeat steps 3 and 4.
|Filter||URL code||Examples of URL codes with filter information|
|Audience (Events only)||f.Audience%7CZ=||f.Audience%7CZ=staff+and+students|
|Month (Events only)||f.Month%7CU=||f.Month%7CU=march|
|Year (Events only)||f.Year%7CV=||f.Year%7CV=2023|
Filtered list URL examples
Simple filtered lists:
- Corporate information pages filtered by the owning organisation, 'University of Bath -
- Campaign pages filtered by the Label, 'taughtpostgraduate' -
- Event pages filtered by the audience, 'Staff and students' -
Complex filtered lists:
- Corporate information pages filtered by the owning organisation, 'University of Bath' and the subtype 'Factsheet' -
- Event pages filtered by the subtypes 'Exhibitions',
'Conferences', and 'Presentations' -
Using filtered lists in your content
When you've created the filtered list you need, you can copy the filtered list's URL from your browser and use it to create links, directing users to the list from other pages.
We often link to filtered lists from:
- Navigation sections
- Related content buttons, for example, in Text and image sections on Campaign pages and Pinned items sections on Landing pages and Case studies