Filter Builder Icon

Filter Builder

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.