Filament Activity Timeline

Installation

Installez le package :

composer require laboiteacode/filament-activity-timeline

Pour utiliser la source Spatie intégrée, installez et préparez spatie/laravel-activitylog :

composer require spatie/laravel-activitylog

php artisan vendor:publish \
    --provider="Spatie\Activitylog\ActivitylogServiceProvider" \
    --tag="activitylog-migrations"

php artisan migrate

Enregistrez ensuite le plugin dans le provider du panel :

use LaBoiteACode\FilamentActivityTimeline\FilamentActivityTimelinePlugin;

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

Démarrage rapide

Le package ne journalise pas lui-même l’activité : il présente les événements produits par une source. Avec Spatie, commencez par activer la journalisation sur le modèle :

use Spatie\Activitylog\Models\Concerns\LogsActivity;
use Spatie\Activitylog\Support\LogOptions;

class Order extends Model
{
    use LogsActivity;

    public function getActivitylogOptions(): LogOptions
    {
        return LogOptions::defaults()
            ->logOnly(['status', 'total', 'customer_id', 'paid_at'])
            ->logOnlyDirty();
    }
}

Créez ensuite un widget configuré pour ce modèle :

use LaBoiteACode\FilamentActivityTimeline\Timeline;
use LaBoiteACode\FilamentActivityTimeline\Widgets\ActivityTimelineWidget;

class OrderTimelineWidget extends ActivityTimelineWidget
{
    protected function timeline(): Timeline
    {
        return Timeline::make()
            ->source('spatie')
            ->heading('Historique')
            ->limit(15)
            ->loadMore()
            ->filters();
    }
}

Utilisation

Dans une page de ressource

Enregistrez le widget sur la page d’un enregistrement. Filament injecte automatiquement le record courant :

protected function getFooterWidgets(): array
{
    return [
        OrderTimelineWidget::class,
    ];
}

Dans une infolist

Le composant de schéma reçoit lui aussi l’enregistrement de l’infolist :

use LaBoiteACode\FilamentActivityTimeline\Infolists\ActivityTimelineEntry;

ActivityTimelineEntry::make('activity')
    ->source('spatie')
    ->heading('Historique')
    ->perPage(10)
    ->loadMore()
    ->filters();

Ajoutez ->static() pour une présentation sans interactions Livewire.

Directement dans une page

Timeline implémente Htmlable et peut être rendu depuis une page :

Timeline::make('activity')
    ->record($this->record)
    ->loadMore()
    ->filters();

Registre sémantique

Déclarez une fois la façon dont un modèle raconte son histoire :

use LaBoiteACode\FilamentActivityTimeline\Facades\ActivityTimeline;

ActivityTimeline::forModel(Order::class)
    ->label('commande')
    ->titleUsing(fn (Order $order): string => $order->number)
    ->attributeLabel('customer_id', 'Client')
    ->eventSentence(
        'status_changed',
        ':causer a changé le statut de :subject.',
    );

Le registre accepte les icônes, couleurs, titres métier, formats d’attributs et phrases par événement. Une configuration locale sur une timeline peut compléter ou remplacer ces valeurs.

Affichage des changements

Les helpers de présentation couvrent les formats courants :

use LaBoiteACode\FilamentActivityTimeline\Presentation\AttributePresentation;

AttributePresentation::make('Actif')->boolean();
AttributePresentation::make('Échéance')->date();
AttributePresentation::make('Publié le')->dateTime();
AttributePresentation::make('Montant')->money('EUR');
AttributePresentation::make('Statut')->enum(OrderStatus::class);
AttributePresentation::make('Client')
    ->relationship('customer', titleAttribute: 'name');
AttributePresentation::make('Clé API')->redacted();

Les valeurs nulles, vides et booléennes sont localisées. Les longues chaînes sont tronquées et les attributs sensibles sont cachés par défaut.

Pour préserver un titre après suppression, stockez un snapshot dans les propriétés de l’activité :

'presentation' => [
    'subject_title' => 'CMD-2026-0184',
    'attributes' => [
        'customer_id' => [
            'old_label' => 'ACME France',
            'new_label' => 'Dupont Conseil',
        ],
    ],
],

Filtres et pagination

Activez les onglets de filtre avec ->filters(). Une liste explicite permet de ne proposer que certains événements :

Timeline::make()
    ->filters(['created', 'updated'])
    ->limit(15)
    ->loadMore();

Le filtrage est appliqué à la requête de la source. Le chargement progressif conserve les éléments déjà rendus et utilise la pagination par curseur lorsque celle-ci est disponible.

Configuration

Publiez la configuration pour régler la source par défaut, la pagination, les événements, les attributs masqués, le fuseau horaire ou le mode diagnostic :

php artisan vendor:publish --tag="filament-activity-timeline-config"

Le mode debugPresentation() explique comment un libellé, un titre ou un format a été résolu. Gardez-le désactivé en production.

Une source personnalisée peut être enregistrée pour lire un stockage différent de Spatie :

ActivityTimeline::source('custom', fn () => app(CustomActivitySource::class));

Thème et traductions

Les sections, onglets, badges, avatars, boutons et états vides sont des composants Filament natifs. Le rail, les points et les puces de changement réutilisent les variables de couleur du panel : thèmes personnalisés et mode sombre sont pris en charge sans configuration.

Les traductions françaises et anglaises sont incluses. Publiez-les pour adapter les textes partagés :

php artisan vendor:publish --tag="filament-activity-timeline-translations"