Filter Builder

Build dynamic collection filters and sort orders through the control panel. Let editors control what content appears without touching templates.

2.0.0

March 2nd, 2026

What's New

Complete rewrite for Statamic v6, Laravel 12, Vue 3, and PHP 8.2+.

Breaking Changes

  • Namespace changed from Tv2regionerne\StatamicFilterBuilder to Cbox\FilterBuilder
  • Requires Statamic 5.x (v6 addon API)
  • Requires PHP 8.2+

Highlights

  • Vue 3 Composition API — all components migrated to <script setup> with composables
  • Statamic v6 UI components — uses DragHandle, PublishFields, PublishFieldsProvider, Combobox, SortableList from @statamic/cms/ui
  • Redesigned card layout — filter/sort items match Statamic v6 replicator card pattern with proper header, drag-and-drop reordering, collapsible cards with preview text
  • Dark mode support — full dark mode styling for all components
  • Validation error display — red border on items with validation errors
  • Duplicate prevention — already-added fields are hidden from the dropdown
  • Collapse All / Expand All — toggle button when 2+ items exist
  • Collection switch memory — switching collections and back restores previous items
  • Empty state messaging — read-only mode shows helpful text when no items exist
  • Dynamic Values — "Variables" field renamed to "Dynamic Values" with inline instructions and Antlers syntax example
  • Input validation & null safety — defensive guards in scope, augment, and field resolution
  • Scope field alignment — scope now intersects fields across collections, matching fieldtype behavior
  • PHPStan level 9 — strict static analysis compliance
  • Pest 3 test suite — 19 tests covering scopes, variable parsing, and collection tag hooks
  • Full Danish translations

Migration from v1.x

See DOCUMENTATION.md for full migration guide.

Note: This package is a fork of tv2regionerne/statamic-filter-builder.