Install
Works with Drupal: ^11 || ^12Using Composer to manage Drupal site dependencies
Alternative installation files
Release notes
Requirements
Drupal 11 or 12 and Better Exposed Filters ^7.1. Drupal 10 support is dropped; Drupal 12 requires BEF 7.2 or newer. #3602880
Search API and Views Reference Filter support now live in the optional submodules sbef_search_api and sbef_verf.
Changes in 4.0.x
- Support taxonomy filters with depth, Views Reference Filter, and YearOnly dropdowns. YearOnly requires its dropdown functionality described in #2903879. Filters with an exposed operator are now trimmed too, including collapsible ones. #3132493, #3501300, #3571854
- Support filters without a field, such as core's "Has taxonomy term", by checking each option instead of failing the page.
- Add optional hiding when one choice remains and themeable option counts. Option counts now also work with hierarchical select lists. Hidden filters keep the visitor's current selection, including "Hide if
no options". #3580494, #3624523 - Fix BEF widget discovery and complete selective-settings schema coverage. #3544573, #3463824, #3569257
- Preserve contextual arguments, exposed input, defaults, and required selections. #3524941, #3613907, #3503636, #3573461
- Correct duplicate counts, missing relationship handling, and choices in aggregated SQL Views. #3475819, #3421349, #3518255
- Fix empty-filter hiding, empty collapsible wrappers, and Apply visibility. #3536021, #3420917, #3432551
- Fix unloaded Search API entities and indexed-field resolution, loading result items in batches. Avoid Solr's default row cap for unlimited helper queries while preserving the displayed pager; backends that
extend Search API Solr are covered too. #3442789 - Optimize simple bundle-filter queries without counts, also when the Search API integration is enabled; document helper hooks and Search API query costs. #3482643, #3425836, #3457937
- Add regression coverage for multiple selective filters and repeated AJAX selections. #3605967, #3418302
- Internal cleanup: the three widgets share one trait, and repeated logic moved into shared helpers. The public static API of
SelectiveFilterBaseis unchanged.
Upgrade notes
Run database updates (drush updb) and rebuild caches after updating. Update 11001 enables sbef_search_api and sbef_verf for views that already use "Show only used items"
on Search API or Views Reference Filter filters. Without it, those filters show all options.
The new one-choice hiding option is disabled by default. Review theme overrides for the items-count span. Solr helper queries now add a count request and may load more entities than before;
complex Views and large result sets can still be expensive.
Verification: 273 tests and 3,316 assertions passed, including real Solr integration tests. Remaining deprecation notices come from Drupal core and contributed modules. An upgrade from 3.0.3 was tested: after
drush updb, taxonomy, Search API and Views Reference Filter views showed the same options and counts as before.