[AL] Filter Framework 1.4.8

This release fixes a fatal error (Call to undefined method Psr\Log\NullLogger::addRecord()) that occurred on some hosting environments — in particular XenForo Cloud — when Enable faceted search is switched on. On such environments, opening a category page with faceted search enabled could return a server error if Elasticsearch reported an error while counting the facet values, and the actual Elasticsearch error was not recorded in the server error log.

With this release:

• Faceted search no longer causes a server error, regardless of the logging library available in the hosting environment.
• Errors returned by Elasticsearch during facet counting are now written to the server error log with the actual exception message, making the root cause of search issues visible.

The release is recommended for all customers using faceted search and is required for XenForo Cloud installations running it. It is backward compatible with the previous release of the framework and can be updated without reindexing the content.

This release is fixing a warning logged in XenForo Server Error Logs when a malformed URL is used related to multiple-select fields.

The release is recommended to upgrade for all filter add-ons.

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.

The release fixes the regression introduced with support for multiple keywords. It is recommended for all customers running Filter add-ons. It is backward compatible with XenForo 2.2.x

The releases prevents throwing an error when custom field value is for some reason invalid (e.g. a previous field with the same name but different value was saved and now does not have the correct data type).

The release is recommended to upgrade for all filter add-ons.

This fixes an issue related to our Location field add-on where the filter form reloads when entering the address.

This release implements the fixes required for our Filter add-ons to be compatabile with XenForo 2.3.x. The package is backward-compatible and can be used to upgrade on 2.2.x boards as well. The support for 2.3.x version for each individual filter add-on will be released soon.

Thank you!

This release contains several fixes reproduced on PHP 8.0+ versions. It is recommended to upgrade for all customers using the package.

The update fixes an issue reported at https://xenforo.com/community/threads/rms-filter-by-addonslab-paid.178429/page-2#post-1659962 It is recommended for all Filter add-ons.

The version fixes a bug causing Auto-reload to be broken due to a JavaScript error, when the filter form does not contain any Filterable lists.

The update is recommended for all customers using the package.