Advanced Roster

• Why this package?
• Features
• Requirements
• Installation
• Configuration
  • Assignee model overrides
  • Custom entry type enum
  • Filters & views
  • Extension points
• Authorization
• Roadmap
• Contributing
• License
• Author

A flexible weekly roster page for Filament — drag-and-drop entries, filters & views, row reordering, recurring shifts, day notes, and optional PDF export.

Built for Filament v4 and v5 on Laravel 11, 12, and 13. Assign any Eloquent model as roster rows (default: User), scope data to your tenant or team, and extend validation rules when you need them.

#Why this package?

#Features

• Filament page plugin — register once on your panel
• Configurable assignee model — defaults to User, override via config or model methods
• Entry types — work, sick, vacation, unavailable (or your own enum)
• Drag & drop — move and copy entries between days and rows
• Filters & views — built-in assignee filter; extensible RosterFilter contract
• Row reordering — custom sort order per user and scope (not stored on the user model)
• Recurrence — daily, weekly, monthly, and custom weekday patterns
• Day notes — optional per-day notes with recurrence (roster.features.notes)
• Overlap validation — enabled by default, disable via config
• Validator registry — register custom RosterEntryValidator classes
• Section registry — one section in v1, add more via RosterSection contract
• Scope resolver — abstract tenancy/team/location scoping
• Print / PDF — optional PDF export with print-friendly fallback view
• Configurable week — week start and visible day count (default: Mon–Fri)
• i18n — English and German

#Requirements

• PHP 8.2+
• Filament 4 or 5
• Laravel 11, 12, or 13

Optional (PDF export):

Without a PDF library, the package falls back to a print-optimized Blade view (browser print).

#Installation

composer require occtherapist/advanced-roster-for-filament

Register the plugin in your panel provider:

use Filament\Panel;
use OccTherapist\AdvancedRosterForFilament\AdvancedRosterForFilamentPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            AdvancedRosterForFilamentPlugin::make(),
        ]);
}

Publish and run migrations:

php artisan vendor:publish --tag=advanced-roster-for-filament-migrations
php artisan migrate

Publish config (optional):

php artisan vendor:publish --tag=advanced-roster-for-filament-config

#Configuration

// config/advanced-roster-for-filament.php

return [
    'assignee_model' => \App\Models\User::class,

    'entry_type_enum' => \OccTherapist\AdvancedRosterForFilament\Enums\RosterEntryType::class,

    'validate_overlap' => true,

    'week_starts_at' => 'monday',
    'week_days' => 5,

    'filters' => [
        \OccTherapist\AdvancedRosterForFilament\Support\Filters\AssigneeRosterFilter::class,
        // \App\Roster\Filters\RoleRosterFilter::class,
        // \App\Roster\Filters\LocationRosterFilter::class,
    ],

    'features' => [
        'notes' => true,
        'print' => true,
        'filters' => true,
    ],
];

#Assignee model overrides

The assignee model can override config defaults with optional methods:

#Custom entry type enum

Provide your own backed enum in config. It must implement Filament's HasLabel and HasColor contracts, plus RosterEntryTypeContract:

interface RosterEntryTypeContract
{
    public function isFullDay(): bool;
    public function deletesConflictingEntries(): bool;
}

#Filters & views

The roster toolbar includes a filter button (funnel icon). Active filters are combined with AND logic. An empty selection means “no restriction” — all assignees stay visible.

The built-in AssigneeRosterFilter lets users pick which people appear in the grid. Filter values are stored per user and scope in roster_user_preferences.

Register additional filters by implementing RosterFilter:

use Filament\Forms\Components\Select;
use Illuminate\Support\Collection;
use OccTherapist\AdvancedRosterForFilament\Contracts\RosterFilter;
use OccTherapist\AdvancedRosterForFilament\Contracts\RosterScope;

class RoleRosterFilter implements RosterFilter
{
    public function getKey(): string
    {
        return 'role';
    }

    public function getLabel(): string
    {
        return __('Role');
    }

    public function getFormComponent(): Select
    {
        return Select::make($this->getKey())
            ->label($this->getLabel())
            ->options([
                'nurse' => 'Nurse',
                'doctor' => 'Doctor',
                'admin' => 'Admin',
            ])
            ->multiple();
    }

    public function apply(Collection $assignees, mixed $value, ?RosterScope $scope): Collection
    {
        if (! is_array($value) || $value === []) {
            return $assignees;
        }

        return $assignees->filter(
            fn ($assignee) => in_array($assignee->role, $value, true),
        );
    }
}

Add your filter class to the filters array in config. Disable the entire feature with 'features.filters' => false.

#Extension points

#Authorization

The package does not ship permissions or policies. Restrict access in your host app via Filament canAccess(), policies, or middleware.

#Roadmap

#Contributing

Contributions are welcome! Open an issue for bugs or feature requests.

#License

MIT © Igor Clauss

#Author

Igor Clauss — Laravel & Filament developer

• Website: igorclauss.de
• GitHub: @OccTherapist