Add a filter bar to the top to let visitors refine what events are displayed by category, tag, venue, country, state/province, city, and date.
The filter bar option is included in The Events Calendar Shortcode & Block!
Custom Filters
Use Additional Fields from Events Calendar Pro, or create your own custom filters.
Display options
Change the order the filters are displayed in, and which filters you want to show.
Responsive Design
The filter bar is responsive and will adjust to the width of the screen.
Demos
[ecs-list-events filterbar="true" filterorder="country, state, city, tag, category, venue, fromdate, todate" fromdate="today"]
Rock Concert
January 22 @ 8:00 pm - 11:30 pmPortland, 97214 United States
Rock Concert
February 1 @ 8:00 pm - 11:30 pmPortland, 97214 United States
[ecs-list-events design="calendar" filterbar="true"]
Change Filter Order
Use the filterorder option to change what order filters are displayed.
[ecs-list-events design="calendar" filterbar="true" filterorder="country, state, tag, category, venue"]
Hide Filter Options
Omit filter(s) from the filterorder option to remove them from the display completely.
Filters available are:
- country - Country
- state - State/Province
- category - Category
- venue - Venue
- tag - Tag
- fromdate - Starting date
- todate - Ending date
[ecs-list-events design="calendar" filterbar="true" filterorder="category, state"]
Change Filter Titles
Alter the title of any filter with the filterbar-(filter name)-title option (venue, category, state, country, tag, fromdate).
- filterbar-country-title - Country
- filterbar-state-title - State/Province
- filterbar-category-title - Category
- filterbar-venue-title - Venue
- filterbar-tag-title - Tag
- filterbar-fromdate-title - Events From
- filterbar-todate-title - Events To
[ecs-list-events filterbar="true" filterbar-category-title="My Category Title" filterbar-venue-title="Location" filterbar-tag-title="Event Tag" filterbar-fromdate-title="Starting Date" filterbar-todate-title="Ending Date" filterorder="category, venue, state, country, tag, fromdate" fromdate="today"]
Rock Concert
January 22 @ 8:00 pm - 11:30 pmPortland, 97214 United States
Rock Concert
February 1 @ 8:00 pm - 11:30 pmPortland, 97214 United States
Change Available Filter Values
Alter the values available with a filter with the filterbar-(filter name) option (venue_id, cat, state, country, tag).
- filterbar-country - Country
- filterbar-state - State/Province
- filterbar-cat - Category
- filterbar-venue_id - Venue
- filterbar-tag - Tag
>[ecs-list-events filterbar="true" filterbar-country="United States, France" filterbar-venue_id="33" filterbar-tag="community, outdoor" filterbar-state="CA, IL, MO" filterbar-cat="meeting, nightlife"]
Rock Concert
January 22 @ 8:00 pm - 11:30 pmPortland, 97214 United States
Rock Concert
February 1 @ 8:00 pm - 11:30 pmPortland, 97214 United States
Change Date Format
Use the filterbar-dateformat option to change how the date fields (Events From, Events To) appears.
[ecs-list-events design="default" filterbar="true" filterbar-dateformat="dd/mm/yy" filterorder="fromdate, todate" fromdate="today"]
Rock Concert
January 22 @ 8:00 pm - 11:30 pmPortland, 97214 United States
Rock Concert
February 1 @ 8:00 pm - 11:30 pmPortland, 97214 United States
Additional Fields from Events Calendar PRO
You can filter by any of the Additional Fields you've set up for your events! More detail here.
Use With Other Designs
In addition to the Calendar and Default designs shown above, the filter can also be used with the Compact, Columns/Photo, Table and Grouped designs!