sitesource/laravel-polymorphic-settings-filament

Filament integration for sitesource/laravel-polymorphic-settings — base page class and trait that auto-bind settings to Filament forms.

v0.2.0 2026-04-25 01:31 UTC

Requires

• php: ^8.2||^8.3||^8.4||^8.5
• filament/filament: ^3.0||^4.0||^5.0
• illuminate/contracts: ^12.0||^13.0
• sitesource/laravel-polymorphic-settings: ^0.1.2
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.14
• nunomaduro/collision: ^8.8
• orchestra/testbench: ^10.0.0||^11.0.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• pestphp/pest-plugin-livewire: ^4.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0

MIT

• Nathan Call

• admin
• configuration
• laravel
• Settings
• polymorphic
• laravel-settings
• filament
• filamentphp
• polymorphic-settings

README

A base Filament page class and helper trait that auto-bind your form schema to sitesource/laravel-polymorphic-settings. Stop hand-rolling mount() / save() plumbing on every settings page.

use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Toggle;
use Filament\Schemas\Schema;
use SiteSource\PolymorphicSettings\Filament\Pages\PolymorphicSettingsPage;

class CommerceSettings extends PolymorphicSettingsPage
{
    protected static ?string $navigationIcon = 'heroicon-o-shopping-cart';
    protected static string $view = 'filament.pages.commerce-settings';

    public function form(Schema $schema): Schema
    {
        return $schema->components([
            Toggle::make('commerce.stripe.enabled'),
            TextInput::make('commerce.stripe.public_key'),
            TextInput::make('commerce.stripe.secret_key')->password(),  // auto-encrypts
        ])->statePath('data');
    }
}

That's it. Mount pulls every field's current value from the settings store. Save persists every field back, encrypting any TextInput->password() field at rest. No mount() or save() to write yourself.

Installation

composer require sitesource/laravel-polymorphic-settings-filament

You'll also need the core package installed and migrated:

php artisan polymorphic-settings:install

Filament 4.x or 5.x is required. (Filament 3.x is supported by the v0.1.x line of this package.)

Usage

Global settings page

The default scope is global — settings live alongside PolymorphicSettings::global() reads/writes:

class GeneralSettings extends PolymorphicSettingsPage
{
    public function form(Schema $schema): Schema
    {
        return $schema->components([
            TextInput::make('site_title'),
            TextInput::make('contact_email'),
        ])->statePath('data');
    }
}

Scoped to a model (per-team, per-tenant, per-user)

Override scopeFor() to return the model whose settings you're editing:

class TeamSettings extends PolymorphicSettingsPage
{
    public function form(Schema $schema): Schema
    {
        return $schema->components([
            TextInput::make('theme.primary_color'),
            TextInput::make('theme.logo_url'),
        ])->statePath('data');
    }

    protected function scopeFor(): ?Model
    {
        return auth()->user()->currentTeam;
    }
}

Encryption

Any TextInput marked with ->password() is automatically persisted as encrypted: true. The Filament form continues to work normally — the user types a plaintext value, the page encrypts on save, and the next mount decrypts transparently.

TextInput::make('stripe.secret_key')->password()

Customising the post-save UX

Default behaviour is a Filament success notification. Override onSaved() to do anything else.

protected function onSaved(): void
{
    parent::onSaved();
    Cache::tags('navigation')->flush();
}

Trait variant: BindsToSettings

If you want to keep your own Page base (or use this on any Livewire component, not just Filament pages), use the trait:

use SiteSource\PolymorphicSettings\Filament\Concerns\BindsToSettings;

class MyPage extends Page
{
    use BindsToSettings;

    public ?array $data = [];

    public function mount(): void
    {
        $this->form->fill($this->fillFromSettings([
            'commerce.stripe.enabled',
            'commerce.stripe.public_key',
            'commerce.stripe.secret_key',
        ]));
    }

    public function save(): void
    {
        $this->persistToSettings(
            $this->form->getState(),
            encryptedKeys: ['commerce.stripe.secret_key'],
        );
    }

    protected function settingsScope(): ?Model
    {
        return null;
    }
}

The trait gives you fillFromSettings(array $keys): array and persistToSettings(array $values, array $encryptedKeys = []): void. You own the form schema and the lifecycle — the trait just bulk-reads and bulk-writes the store.

Testing

composer test

13 tests, 23 assertions. PHPStan level 5 + Pint clean.

Changelog

See CHANGELOG.md.

Credits

• Nathan Call

License

MIT — see LICENSE.md.