Search & Filter Block
The Search & Filter block (eventonomy/search-filter) is the control bar for your events page: keyword search, a category list, a date range, and the view switcher.
When to Use It
Add it to your Events page, above the Calendar or Events List block, so visitors can narrow down events before browsing.
This is where the view switcher lives. Grid / List / Month / Upcoming (plus Week and Day with Pro) are rendered by this block, not by Events List. Leave it off the page and visitors are stuck on whichever view is active.
How to Add It
Block Editor:
- Open your Events page in the Block Editor.
- Click + and search for Eventonomy Search & Filter.
- Insert the block, ideally above your Calendar or Events List block.
There is nothing to configure; the block renders automatically.
Shortcode:
[eventonomy_search]
Settings
This block has no settings of its own. What it shows is driven by your site settings and your content:
| Control | Appears when |
|---|---|
| View switcher | Show a view switcher on the archive is on (Settings → Appearance) and more than one view is enabled. |
| Category list | At least one event category exists. See Categories & Tags. |
| Search box | Always. |
| From / To dates | Always. |
| Create event | The visitor is allowed to create events. |
What Visitors Can Do
Visitors type a keyword, pick a category, or set a date range; the events shown by the Events List block below update in place, without a full page reload. Typing filters as you go, and Enter applies immediately. Every filter is reflected in the address bar, so a filtered view is shareable.
Arriving from a tag link on an event page shows that tag as a removable pill, so the narrowed list always explains itself and there is an obvious way back.
Switching view is different: each view is a real page (/events/grid/,
/events/month/, and so on), so clicking a view loads that page. Your search,
category and date filters ride along with you.
Event Search (for sidebars)
Eventonomy Event Search is a small version of this block made for sidebars and widget areas. Search for it in the block inserter.
It shows a search box, a category list, a date list (Today, This weekend, This week, This month) and one Search button. Searching opens your Events page with the results, so it works on any page of the site.
| Setting | Attribute | Default | Description |
|---|---|---|---|
| Title | title |
Find events | The heading above the form. Clear it to hide the heading. |