README

Filament Admin

Filament Admin model, AdminResource, status-aware Login page and plugin for a separate admin guard. Built on laravel-admin.

Compatibility

Branch	Filament	Package version
1.x	3.x	^1.0
2.x	4.x	^2.0
3.x	5.x	^3.0

Installation

composer require jeffersongoncalves/filament-admin

Usage

Model

namespace App\Models;

use JeffersonGoncalves\Filament\Admin\Models\Admin as BaseAdmin;

class Admin extends BaseAdmin
{
    // add traits, relations or overrides here
}

Point auth.providers.admins.model to App\Models\Admin::class in config/auth.php. The model implements FilamentUser, HasAvatar, and canImpersonate() returns true.

Panel access

By default only active admins (status = true) can access a panel. Filament checks this on every request, so deactivating an admin also ends any open session or remember-me login.

Override the gate in AppServiceProvider::boot():

use Filament\Panel;
use JeffersonGoncalves\Filament\Admin\Facades\FilamentAdmin;

FilamentAdmin::canAccessPanelUsing(
    fn (Admin $admin, Panel $panel): bool => $admin->status && $panel->getId() === 'admin',
);

Or through config (php artisan vendor:publish --tag=filament-admin-config), with an invokable class called as __invoke(Admin $admin, Panel $panel): bool:

// config/filament-admin.php
'can_access_panel' => App\Filament\AdminPanelGate::class,

The facade callback wins over the config value.

Panel

use JeffersonGoncalves\Filament\Admin\AdminPlugin;
use JeffersonGoncalves\Filament\Admin\Pages\Auth\Login;

$panel
    ->id('admin')
    ->authGuard('admin')
    ->login(Login::class) // only active admins (status = true) can log in
    ->plugins([
        AdminPlugin::make(),
    ]);

The resource sits in the "Management" navigation group. Change it with AdminPlugin::make()->navigationGroup('Team').

Translations

Labels ship in 19 locales (ar, az, de, en, es, fa, fr, hi, it, ja, nl, pl, pt, pt_BR, ru, tr, uk, uz, zh_CN) under the filament-admin::resources/admin.* keys (navigation.*, fields.*, actions.*). Publish them to customize or add locales:

php artisan vendor:publish --tag=filament-admin-translations

Pair it with filament-user's UserPlugin::make() on the same panel to manage users too.

Extending

use JeffersonGoncalves\Filament\Admin\Resources\Admins\AdminResource;
use JeffersonGoncalves\Filament\Admin\Resources\Admins\Tables\AdminsTable;

class MyAdminsTable extends AdminsTable
{
    public static function columns(): array
    {
        return [
            ...parent::columns(),
            TextColumn::make('locale'),
        ];
    }
}

class MyAdminResource extends AdminResource
{
    public static function table(Table $table): Table
    {
        return MyAdminsTable::configure($table);
    }
}

AdminPlugin::make()->resource(MyAdminResource::class);

The resource pages follow the plugin, so there is nothing else to copy. AdminForm::components() and AdminInfolist::components() can be extended the same way.

Testing

composer test

jeffersongoncalves / filament-admin

Package info

Security

Fund package maintenance!

Statistics