Version 1.5.2 — Calendar Filtering #
Taxonomy filtering, interactive filter shortcodes, multiple calendars per page, native filter mode, and frontend translation support.
17 Feb 2026
Version 1.5.2 introduces a complete filtering system for the calendar, letting visitors interactively filter events by taxonomy. It supports multiple approaches — inline native filters, standalone shortcodes, or both working together.
Calendar Taxonomy Filtering
Filter which events appear on a calendar by taxonomy terms using the new taxonomy and terms shortcode attributes. For example, [lre_calendar taxonomy="event_category" terms="yoga,pilates"] displays only events in those categories. Supports both term slugs and numeric IDs.
- Multiple taxonomy filtering — Filter by more than one taxonomy at once using the
taxonomiesattribute with pipe-separated groups, e.g.[lre_calendar taxonomies="event_category:yoga|event_tag:beginner"]. Events must match all specified taxonomy conditions. - Multiple calendars per page — Display several calendars on the same page, each showing different event categories or types. Combine
taxonomy,terms, andpost_typeattributes for full control over each calendar's content. - Custom calendar ID — Use the
idattribute on[lre_calendar]to assign a stable, human-readable identifier for targeting and styling, e.g.[lre_calendar id="yoga-calendar"].
Interactive Calendar Filter Shortcode
New [lre_calendar_filter] shortcode lets visitors dynamically filter which events appear on a calendar. Supports dropdown, button, and pill display modes. Place it anywhere on the same page as your calendar — filter changes instantly update the calendar without reloading the page.
- Filter targeting — When using multiple calendars, use the
targetattribute to control which calendar a filter affects, e.g.[lre_calendar_filter target="yoga-cal" taxonomy="event_category"]. With a single calendar, targeting is automatic. - Filter options — Supports
show_countsto display event counts,show_allfor an "All" reset option,termsto limit which terms are shown,hide_emptyto hide unused terms, andmultiplefor multi-select dropdowns.
Native Calendar Filter Mode
Add filter="event_category" directly to the [lre_calendar] shortcode to render filter controls inline in the calendar header. Supports pills (default), buttons, and dropdown display modes. No separate shortcode needed — everything is self-contained.
- Coexisting filter modes — Native mode and manual mode can work together on the same calendar. Use native mode for one taxonomy in the header and a separate
[lre_calendar_filter]shortcode for a second taxonomy elsewhere on the page. - Inline loading spinner — Clicking a pill or button filter shows a subtle inline spinner that expands within the button while the calendar grid dims, providing clear visual feedback during event refetching.
Improvements
- Wider settings page — The plugin settings page now uses a wider layout (1400px) for better readability on modern displays.
- Consistent settings layout — All tabs now use the full content width and left-hand label columns are aligned to a uniform 200px across every settings section.
- Calendar filter shortcode styling — The
[lre_calendar_filter]shortcode renders with the same polished styling as the Bricks Builder filter elements. - Frontend JavaScript translation support — Filter labels ("This Week", "Next 7 Days", "Today", etc.), event type labels, Active Filters UI labels, and calendar export strings are now fully translatable through standard .po/.mo files.
Fixes
- Page scrolled to top when clicking calendar filter buttons — The AJAX filtering system was intercepting native filter button clicks via document-level event delegation. Native filter buttons are now excluded from AJAX filter delegation.
- Native filter not visible in Bricks Builder editor — The calendar preview in the Bricks editor now displays native mode filter controls in the header, matching the frontend appearance.
- Bricks editor calendar preview used outdated event styling — Events in the editor preview now render with the current frontend layout: left border accent with time above title, recurring event icons, and per-event category colours.
- Calendar shortcode reference showed a non-functional
categoryattribute — Replaced with the correcttaxonomyandtermssyntax, plus new examples for multiple taxonomy filtering, custom calendar IDs, and the filter shortcode.