Event finder
The Event finder component lists upcoming events. Customers can browse, search or filter events through the event finder.
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 can't be added on any other page types. See how to create a Landing Page.
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 Event finder to a landing page
- On the layout view of a landing page, select Add block, then select the Event Finder block.
- Once the block has been added onto the page, you can configure the following:
- Options
- Results listings
- Keyword search
- Location search
- Tag filters.
Options
- Select the Event: Default option in the Content type drop down
- Select the agency responsible for the events shown on the Events 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 Events 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 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 Events 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.
Results listings
- 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 a message that will be shown if the user's current location can't be found in the Location Error Message field. If this is left blank, a default message will be shown instead.
Keyword search
- 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'.
Location search
If you want to show a location filter on the events finder tick the Enable location search checkbox. You can leave the other location fields with their default text or customer the labels and help text.
Tag filters
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'
- Click the Update button
How the component displays
You can see live examples of how agencies have applied the component to their content.