cooper/filament-dcat-filters

Bring Dcat Admin's powerful filter features to Filament - including Scope filters, Range filters, SelectTable, and more quick filters

dev-master 2025-11-18 06:00 UTC

Requires

• php: ^8.3
• filament/filament: ^4.0

Requires (Dev)

• laravel/pint: ^1.0
• nunomaduro/larastan: ^3.0
• orchestra/testbench: ^10.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpstan/phpstan: ^2.0
• phpstan/phpstan-deprecation-rules: ^2.0

MIT

• Cooper

• laravel
• filters
• admin-panel
• dcat-admin
• filament
• filament-plugin
• filament-filter
• scope-filter
• range-filter

README

Bring Dcat Admin's powerful filter features to Filament. This package provides a collection of enhanced filters that make building admin panels faster and more intuitive.

English Documentation | 中文文档

Features

Core Filters

• 🎯 Scope Filter - Tab-style quick filters for common queries
• 📊 Range Filter - Simplified date/number range filtering (3 lines of code!)
• 📅 Date Component Filter - Filter by year, month, or day separately
• 🔍 SelectTable Filter - Modal table selector with search and pagination
• 🎭 Modal Select Filter - Dcat Admin style modal with full table display
• 🔢 Between Filter - Numeric range filtering shortcut
• 🙈 Hidden Filter - URL parameter-based filtering without UI

Quick Filters

• ⚡ LIKE Filter - Text search with wildcard control (supports NOT LIKE)
• 📋 IN Filter - Multiple value selection (supports NOT IN)
• 🔢 Comparison Filter - Comparison operators (>, <, >=, <=, =, !=)

Additional Features

• 🎨 Highly Customizable - Extensive customization options for each filter
• 📱 Mobile Friendly - Responsive design for all screen sizes
• 🌐 Bilingual Docs - Complete English and Chinese documentation

Version Compatibility

Filament	Filament Dcat Filters	PHP	Laravel
4.x	1.x	^8.3	^12.0

Installation

You can install the package via composer:

composer require cooper/filament-dcat-filters

Optionally, you can publish the config file:

php artisan vendor:publish --tag="filament-dcat-filters-config"

Optionally, you can publish the views:

php artisan vendor:publish --tag="filament-dcat-filters-views"

Quick Start

Scope Filter

Perfect for quick filtering with tab-style buttons:

use Cooper\FilamentDcatFilters\Filters\ScopeFilter;

ScopeFilter::make('status')
    ->scopes([
        'all' => 'All',
        'active' => 'Active',
        'inactive' => 'Inactive',
    ])

View detailed documentation →

Range Filter

Simplified date/number range filtering:

use Cooper\FilamentDcatFilters\Filters\RangeFilter;

RangeFilter::make('created_at')->datetime()

View detailed documentation →

SelectTable Filter

Modal table selector with search and pagination:

use Cooper\FilamentDcatFilters\Filters\SelectTableFilter;

SelectTableFilter::make('user_id')
    ->relationship('user', 'name')
    ->multiple()

View detailed documentation →

Date Component Filter

Filter by year, month, or day components:

use Cooper\FilamentDcatFilters\Filters\DateComponentFilter;

DateComponentFilter::make('created_at')->year()
DateComponentFilter::make('birth_date')->month()
DateComponentFilter::make('published_at')->day()

View detailed documentation →

Modal Select Filter

Dcat Admin style modal with full table display:

use Cooper\FilamentDcatFilters\Filters\ModalSelectFilter;

ModalSelectFilter::make('user_id')
    ->model(User::class, 'name', 'id')
    ->dialogTitle('Select User')
    ->displayColumns(['id' => 'ID', 'name' => 'Name', 'email' => 'Email'])
    ->searchable(['name', 'email'])
    ->multiple()

View detailed documentation →

Quick Filters

Built-in filters for common operations:

use Cooper\FilamentDcatFilters\Filters\{LikeFilter, InFilter, ComparisonFilter, BetweenFilter};

// LIKE search (with NOT LIKE support)
LikeFilter::make('title'),
LikeFilter::make('spam_keywords')->notLike(), // Exclude matches

// IN array (with NOT IN support)
InFilter::make('category_id')
    ->options(Category::pluck('name', 'id')->toArray()),
InFilter::make('blocked_users')->notIn(), // Exclude selected

// Comparison (>, <, =, >=, <=, !=)
ComparisonFilter::make('views')->gte()->label('Minimum Views'),

// Between (numeric range)
BetweenFilter::make('price')->label('Price Range'),

View detailed documentation →

Hidden Filter

URL parameter-based filtering (no UI):

use Cooper\FilamentDcatFilters\Filters\HiddenFilter;

// Pre-filter by tenant
HiddenFilter::make('tenant_id')
    ->default(auth()->user()->tenant_id)
    ->eq()

View detailed documentation →

Documentation

Core Filters

• 📖 Scope Filter - Tab-style quick filters
• 📖 Range Filter - Date/number range filtering
• 📖 Date Component Filter - Year/Month/Day filtering
• 📖 SelectTable Filter - Modal table selector
• 📖 Modal Select Filter - Dcat Admin style modal table selector
• 📖 Quick Filters - LIKE, IN, GT, LT, BETWEEN filters

Guides & References

• 📖 Usage Examples - Complete working examples
• 📖 Demo Guide - Interactive demonstrations
• 📖 Advanced Features - API support, InputMask, FindInSet, Hidden filters
• 📖 Comparison with Dcat Admin - Feature comparison
• 📖 Package Structure - Package architecture
• 📖 Documentation Structure - Documentation organization

Facade Usage

You can also use the Facade for quick access:

use Cooper\FilamentDcatFilters\Facades\FilamentDcatFilters;

FilamentDcatFilters::scopeFilter('status')->scopes([...]);
FilamentDcatFilters::rangeFilter('created_at')->datetime();

Testing

composer test

Code Quality

# Format code
composer format

# Static analysis
composer analyse

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

If you discover any security-related issues, please email [e-mail].

Credits

• Cooper
• Inspired by Dcat Admin
• All Contributors

License

The MIT License (MIT). Please see License File for more information.