Case study finder

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:

1. Create a new full width section and click Add block.  
2. 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.
3. The Title can be left with the default text as this is only visible to editors.
4. The Related Case Study Subtype can be left on the default dropdown of Case study default.
5. 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.
6. 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.'
7. 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)'.
8. Click the Update button.

How the component displays

Live agency case study finder

• SmartNSW Case Study Library

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