ianstudios/filament-settings

This package adds a way to interact with key:value settings in Filament.

v1.0.3 2025-09-04 02:47 UTC

Requires

• php: ^8.0
• filament/filament: ^3.2
• ianstudios/settings: ^1.0
• laravel/framework: ^10.0|^11.0|^12.0
• spatie/laravel-package-tools: ^1.16

MIT

• Ianstudios

README

This package adds a way to interact with key:value in Filament.

Installation

You can install the package via composer:

composer require ianstudios/filament-settings

Configure the Ianstudios/Settings package as described in the Settings documentation.

Add the plugin to your desired Filament panel:

use Ianstudios\FilamentSettings\Filament\Plugins\FilamentSettingsPlugin;

class FilamentPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        return $panel
            // ...
            ->plugins([
                FilamentSettingsPlugin::make()
                    ->pages([
                        // Add your own setting pages here
                    ])
            ]);
    }
}

Usage

Create a settings page at 'app/Filament/Pages/Settings.php':

namespace App\Filament\Pages\Settings;

use Closure;
use Filament\Forms\Components\Tabs;
use Filament\Forms\Components\TextInput;
use Ianstudios\FilamentSettings\Filament\Pages\Settings as BaseSettings;

class Settings extends BaseSettings
{
    public function schema(): array|Closure
    {
        return [
            Tabs::make('Settings')
                ->schema([
                    Tabs\Tab::make('General')
                        ->schema([
                            TextInput::make('general.brand_name')
                                ->required(),
                        ]),
                    Tabs\Tab::make('Seo')
                        ->schema([
                            TextInput::make('seo.title')
                                ->required(),
                            TextInput::make('seo.description')
                                ->required(),
                        ]),
                ]),
        ];
    }
}

Register the setting page in the FilamentServiceProvider:

use Ianstudios\FilamentSettings\Filament\Plugins\FilamentSettingsPlugin;

class FilamentPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        return $panel
            // ...
            ->plugins([
                FilamentSettingsPlugin::make()
                    ->pages([
                        App\Filament\Pages\Settings::class,
                    ])
            ]);
    }
}

You can add as many setting pages as you want. But when you do, make sure to override the public static function getNavigationLabel() : string method on your settings page. This is because multiple pages with the same navigation label will override each other in the Filament navigation.

Changing the navigation label

You can change the navigation label by overriding the getNavigationLabel method:

namespace App\Filament\Pages\Settings;

use Ianstudios\FilamentSettings\Filament\Pages\Settings as BaseSettings;

class Settings extends BaseSettings
{
    public static function getNavigationLabel(): string
    {
        return 'Custom label';
    }
}

Changing the page title

You can change the page title by overriding the getTitle method:

namespace App\Filament\Pages\Settings;

use Ianstudios\FilamentSettings\Filament\Pages\Settings as BaseSettings;

class Settings extends BaseSettings
{
    public function getTitle(): string
    {
        return 'Custom title';
    }
}

Changelog

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

License

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