Filament est un générateur d'interface d'administration open-source conçu pour fonctionner avec Laravel. Il permet de créer rapidement des interfaces utilisateurs élégantes et performantes pour gérer les applications. Filament 3, la dernière version du package, apporte des améliorations significatives en termes de flexibilité, de personnalisation et d'extensibilité, tout en conservant la simplicité qui a fait son succès. Dans cet article, nous allons explorer les fonctionnalités clés de Filament 3 avec Laravel et comment l'utiliser pour créer des applications robustes et bien conçues.

Qu'est-ce que Filament 3 ?

Filament est une plateforme d'administration pour Laravel qui se distingue par sa facilité d'utilisation et ses capacités de personnalisation. Contrairement à d'autres solutions comme Laravel Nova ou Voyager, Filament offre une interface minimaliste et moderne tout en restant flexible et extensible pour les développeurs.

Filament 3 s'inscrit dans cette lignée, apportant de nouvelles fonctionnalités telles que :

• Une architecture révisée et améliorée.
• De nouveaux composants pour les formulaires, tables et autres éléments d'interface.
• Une gestion plus fluide des ressources avec des pages d'administration personnalisées.
• Une meilleure gestion des permissions et des rôles.
• Un thème par défaut plus moderne et une personnalisation accrue.

Installation de Filament 3

Pour commencer à utiliser Filament 3 avec Laravel, vous devez d'abord installer le package via Composer. Voici les étapes pour l'installation :

1. Installer Filament via Composer

Exécutez la commande suivante dans votre terminal :

composer require filament/filament

2. Publier les fichiers de configuration

Après avoir installé le package, publiez les fichiers de configuration et les vues avec la commande :

php artisan vendor:publish --tag=filament-config

3. Créer un utilisateur d'administration

Filament utilise Laravel Breeze pour la gestion des utilisateurs. Vous pouvez créer un utilisateur d'administration en exécutant la commande suivante :

php artisan make:filament-user

Cette commande vous permettra de définir les informations de l'utilisateur administrateur, comme l'email et le mot de passe.

Utilisation des ressources Filament

Filament vous permet de créer des "ressources", qui sont des interfaces pour gérer vos modèles Eloquent. Chaque ressource peut être personnalisée pour afficher, ajouter, modifier ou supprimer des entrées dans votre base de données.

1. Créer une ressource

Pour créer une ressource, exécutez la commande suivante :

php artisan make:filament-resource Post

Cela génère une classe de ressource PostResource dans le répertoire app/Filament/Resources. Vous pouvez ensuite personnaliser cette ressource pour correspondre aux besoins de votre application.

2. Personnaliser la ressource

Une fois la ressource créée, vous pouvez définir les champs, les relations, et la logique métier pour gérer les données dans votre interface d'administration.

Par exemple, pour ajouter des champs de formulaire, vous pouvez modifier la méthode form() dans la ressource :

public static function form(Form $form)
{
    return $form->schema([
        TextInput::make('title')
            ->required()
            ->maxLength(255),
        Textarea::make('content')
            ->required(),
    ]);
}
    

De même, pour personnaliser la table de gestion des données, vous pouvez utiliser la méthode table() pour définir les colonnes à afficher :

public static function table(Table $table)
{
    return $table->columns([
        TextColumn::make('title'),
        TextColumn::make('content')->limit(50),
    ]);
}
    

Gestion des autorisations et des rôles

Filament 3 facilite la gestion des permissions et des rôles pour votre interface d'administration. Par défaut, chaque utilisateur administrateur peut accéder à toutes les ressources. Cependant, vous pouvez restreindre l'accès à certaines ressources ou actions en fonction des rôles des utilisateurs.

1. Définir des autorisations sur une ressource

Pour restreindre l'accès à certaines ressources, vous pouvez utiliser la méthode can() dans la classe de ressource. Par exemple, pour permettre uniquement aux utilisateurs ayant un rôle spécifique d'ajouter des articles :

public static function canCreate(): bool
{
    return auth()->user()->hasRole('admin');
}
    

2. Gestion des rôles

Filament s'intègre facilement avec les packages comme Spatie Laravel Permission pour gérer les rôles et les autorisations de manière plus fine. Vous pouvez ajouter des rôles à un utilisateur et définir des permissions sur différentes ressources en utilisant ces outils tiers.

Personnalisation de l'interface

Filament 3 met l'accent sur la personnalisation de l'interface. Le package offre une structure flexible pour appliquer des thèmes et ajuster les composants en fonction des besoins de votre application.

1. Personnaliser le thème

Vous pouvez facilement personnaliser les couleurs et la disposition de l'interface d'administration en modifiant les fichiers de configuration et en créant votre propre thème. Filament utilise Tailwind CSS, ce qui facilite la personnalisation de l'interface via des classes utilitaires.

2. Ajouter des composants personnalisés

Si vous avez besoin d'ajouter des composants personnalisés, Filament vous permet de le faire de manière simple. Vous pouvez créer des composants Vue.js ou Livewire pour ajouter des fonctionnalités interactives à votre interface d'administration.

Conclusion

Filament 3 pour Laravel est un outil puissant et flexible pour créer des interfaces d'administration modernes et faciles à utiliser. Grâce à sa simplicité d'installation, sa structure modulaire et ses capacités de personnalisation, il s'intègre parfaitement aux projets Laravel pour offrir une expérience utilisateur agréable tout en permettant aux développeurs de rester productifs. Que vous soyez un développeur débutant ou expérimenté, Filament 3 vous permet de créer des tableaux de bord et des interfaces d'administration robustes, sans compromettre la qualité ou la performance.

Si vous cherchez une solution d'administration pour Laravel, Filament 3 est une option à envisager sérieusement.