Case study finder
Use this component to create a listing of case studies with the ability to search and filter through them.
On this page
Before you start
You'll need to have created some case studies to display in your Case study finder. To create case studies see the guide to the case study template.
How to use the component
Do
- Use on landing pages to list large amounts of case studies with the ability to search and filter them.
- Limit other components on your page. The page should mostly be dedicated to the Case study finder component. If you add other elements to the page, such as a summary or call out, position the Case study finder component last on the page.
Don't
- Add more than 1 Case study finder component to your landing page.
How to add the Case study finder block
To add the Case study finder component to your landing page:
- Create a new full width section and click Add block.
- In the Choose a block screen, search for DCS Case Study Finder Block and select the component from the search results. The Configure block screen will open and you can adjust the settings.
- The Title can be left with the default text as this is only visible to editors.
- The Related Case Study Subtype can be left on the default dropdown of Case study default.
- In the Agency field select your agency. You will need to have case studies that have been tagged with this agency for the component to generate results.
- In the Keyword settings accordion you can leave the default text of 'Keyword', or enter custom text to create a stronger call-to-action such as 'Search case studies.'
- You can choose to add filters for Category, Region and Council, although this is optional. You must have tagged your individual case studies with these optional tags for these filters to function in the Case study finder. If you haven’t added category tags to individual case studies, see how to tag a case study. If you are adding these filters:
- You can choose to customise the title, helper text and tag expand fields or leave the default text.
- You must use the values field to look up and select the options you want to display for the filter with a comma after each filter. For example, in the Council values field you could select 'Albury City Council' and 'Byron Shire Council', which would appear as 'Albury City Council (967), Byron Shire Council (946)'.
- Click the Update button.
How the component displays
Live agency case study finder
Case study finder with filters added
This is an example of the Case study finder with the following filters added:
- Agency: Smart Places, Cities and Active Transport, Transport for NSW
- Category:
- Environment and Sustainability
- Transport and Mobility
- Wellbeing and Safety
- Region:
- Statewide initiative
- Regional Initiative
- Council:
- Albury City Council
- Byron Shire Council
Case study finder without filters
This is an example of the Case study finder with only the mandatory agency field used.
Agency tagged as: Smart Places, Cities and Active Transport, Transport for NSW.