This update brings the all-new Filterable Lists feature, a set of new developer events for deeper integration, significant UX improvements to the tag/select dropdowns, and full XenForo 2.1 compatibility. It is recommended for all customers running Filter add-ons and is fully backward compatible.
New Features
Filterable Lists support for XenForo 2.3
Fields can now be rendered as searchable, AJAX-powered dropdowns (via Select2 / Tagify on XenForo 2.3) instead of loading every option at once. This drastically reduces page weight and load times for content types with hundreds or thousands of options.
Numeric Field Support
Numeric custom fields can now be used as filters.
Location Field Support
A new event allows add-ons to integrate location-based fields with the framework.
New Elasticsearch DSL Logging
When an Elasticsearch query fails, the full DSL query and exception message are now logged at error level, making it much easier to diagnose ES issues.
New Developer Events
Four new code events give add-on developers fine-grained control over filtering behavior:
- filter_framework_enable_filterable_lists — Enable filterable lists per field and specify the API endpoint that supplies the options.
- filter_framework_filter_active_choices — Reduce the loaded choices to active ones only (recommended when Filterable Lists are enabled).
- filter_framework_display_formatter_active_filters — Customize how a field is rendered in the Active Filters area (template, phrase, params, label visibility).
- filter_framework_format_field_for_display — Override the default display formatting of any field value.
Bug Fixes & Improvements
- Fixed the "match any / match all" option container disappearing in certain configurations.
- Resolved XenForo 2.1 compatibility issues across templates and JS.
- Removed a class-extension hack for a cleaner, more maintainable integration.
Compatibility
Fully backward compatible with existing Filter add-ons and configurations. No configuration changes are required to upgrade — Filterable Lists and the new events are opt-in via add-on listeners.
The release is recommended to upgrade for all filter add-ons.