The Event finder block allows site visitors to browse, filter and search for events that they are interested in. This block is configurable and you can choose what events are shown and what filters are made available on the finder. These events can be imported from a third party (like the Australian Tourism Data Warehouse), or manually created. Once an event is created, it will show up on the Event finder and visitors can learn more about a specific event on its dedicated event details page.
To ensure the parent page of the events is set up correctly, a configuration needs to be done by a Content Administrator. If you are from an external agency, please raise a Help Hub ticket so the appropriate team can make this configuration for you.
On this page
- Before you start
- Using the Event finder
- Add Event finder to a landing page
- See this live in the CMS Components Guide
Before you start
- Make sure you have events that link to this Events finder, otherwise no events will show.
- Create a landing page. The Event finder cannot be added on any other page types.
Using the Event finder
Do
- Only include filters that are relevant and meaningful
- Add images to your event listings or add a default image in the Event finder if you want images to be shown on the Event finder. If you don't know how to add images to events, see how to set up your event listings
- Ensure event pages are configured to show on the Event finder
Don't
- Use the finder if it will show less than five events
- Use if new events aren't being added regularly
Add an Event finder to a landing page
On the layout view of a landing page, select Add block, then select the Event finder.
Once the block has been added onto the page, you can configure the following:
- Options
- Results listings
- Keyword search
- Location search
- Tag filters
- Select the Event: Default option in the Content type drop down
- Select the agency responsible for the events shown on the Event finder in the Agency field. You can add more than 1 Agency tag but it will be the first Agency listed that will be the main agency for the article and will receive the Google Analytics data for the events.
- Select 1 or more topics that are relevant to the Event finder in the Topic field.
- If you want to show a filter for online and in person filters tick the Enable online/in person filter checkbox.
- If you want to include a map view option on the Event finder tick the Enable map display checkbox.
- If you want to show images for the events in the Event finder tick the Show card images checkbox. If an event does not have an image but the Event finder is configured to show card images, a default image can be shown instead. To add a default image, upload an image using the Add media button
- Add a message that will be shown if there are no results found for a customer's search or filter in the No Results Message field. If this is left blank, a default message will be shown instead
- Add the label for the keyword search in the Keyword label field. This can be left with the default text of 'Keyword'.
- You can add text in the Keyword placeholder field, but this field is optional.
- Add helper text and instructions for the keyword search in the Keyword help text field. For example, 'Search for an event'
If you want to show a location filter on the Event finder tick the Enable location search checkbox. You can leave the other location fields with their default text or custom the labels and help text.
If you want to add more filters you can, although this is optional. To add another filter:
- Select the Add more button to add a category filter.
- Add the title for the filter in the Tag filter label field that will relate to your new filter, for example, 'facilities'
- Search and select the Category option in the Vocabulary field.
- Search and select the category filters you would want to show in the Terms field for example 'BBQ facilities'
Optional configuration
Category Filters
ATDW events will derive the categories from the 'Category settings' accordion. For all other events, follow the instructions below:
- Expand the 'Category settings' and uncheck 'Enable category filters.
- Expand the 'Tag filters' accordion and then do the following:
- Tag filter label: enter the title you would want the filters to have. This will show on the Event Finder
- Vocabulary: Enter 'Category (category)' so any term from the Category taxonomy can be used
- Terms: Enter the individual terms you would want to include in the filter. If you do not see the terms you want to use, reach out to the Content team to add those terms to the Category taxonomy
See this live on nsw.gov.au
Visit Event finder to see a live example of this component.
You can also see live examples of how agencies have applied the component to their content.
Need any more help?
If you have any questions, or require assistance with anything mentioned on this article, submit a request via the webform.