PHPackages                             zanysoft/filament-activitylog - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. zanysoft/filament-activitylog

ActiveLibrary

zanysoft/filament-activitylog
=============================

This package for filament activitylog

1.0(yesterday)00MITPHPPHP ^8.2

Since Jul 30Pushed todayCompare

[ Source](https://github.com/zanysoft/filament-activitylog)[ Packagist](https://packagist.org/packages/zanysoft/filament-activitylog)[ Docs](https://github.com/zanysoft/filament-activitylog)[ RSS](/packages/zanysoft-filament-activitylog/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (5)Versions (2)Used By (0)

ActivityLog
===========

[](#activitylog)

### Spatie/Laravel-activitylog for Filament

[](#spatielaravel-activitylog-for-filament)

[![Latest Version on Packagist](https://camo.githubusercontent.com/4e7fe7a9f379331e6d0e6519c6fcf5553ed2007f1ea7320a856fc8549d3f770d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7a616e79736f66742f66696c616d656e742d61637469766974796c6f672e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/zanysoft/filament-activitylog)[![Software License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](LICENSE.md)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/560d68aec1405664454576f72b9a7a690eb202f69868b39f2e8f8f7f9f53e3c7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7a616e79736f66742f66696c616d656e742d61637469766974796c6f672f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/zanysoft/filament-activitylog/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/d4c685216bfb6d76a1c245e9797a649b8e7a9df2e2f18540979e09a6d6058b34/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7a616e79736f66742f66696c616d656e742d61637469766974796c6f672e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/zanysoft/filament-activitylog/stats)

[![Screenshot of Application Feature](https://raw.githubusercontent.com/zanysoft/filament-activitylog/main/arts/cover.jpeg)](https://raw.githubusercontent.com/zanysoft/filament-activitylog/main/arts/cover.jpeg)

This package provides a Filament resource that shows you all of the activity logs and detailed view of each log created using the `spatie/laravel-activitylog` package. It also provides a relationship manager for related models.

Requirements
------------

[](#requirements)

- Laravel v12
- Filament v3
- Spatie/Laravel-activitylog v4

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require zanysoft/filament-activitylog
```

After that run the install command:

```
php artisan activitylog:install
```

This will publish the config & migrations from `spatie/laravel-activitylog`

And run migrates

```
php artisan migrate
```

You can manually publish the configuration file with:

```
php artisan vendor:publish --tag="activitylog-config"
```

This is the contents of the published config file:

```
return [
    'resources' => [
       'label'                     => 'Activity Log',
        'plural_label'              => 'Activity Logs',
        'hide_restore_action'       => false,
        'restore_action_label'      => 'Restore',
        'hide_resource_action'      => false,
        'hide_restore_model_action' => true,
        'resource_action_label'     => 'View',
        'navigation_item'           => true,
        'navigation_group'          => null,
        'navigation_icon'           => 'heroicon-o-shield-check',
        'navigation_sort'           => null,
        'default_sort_column'       => 'id',
        'default_sort_direction'    => 'desc',
        'navigation_count_badge'    => false,
        'resource'                  => \ZanySoft\FilamentActivitylog\Resources\ActivitylogResource::class,
    ],
    'date_format'     => 'd/m/Y',
    'datetime_format' => 'd/m/Y H:i:s',
];
```

Optionally, you can publish the views using

```
php artisan vendor:publish --tag="activitylog-views"
```

Usage
-----

[](#usage)

### Basic Spatie ActivityLog usage

[](#basic-spatie-activitylog-usage)

In you `Model` add `Spatie\Activitylog\Traits\LogsActivity` trait, and configure `getActivitylogOption` function

For more configuration, Please review [Spatie Docs](https://spatie.be/docs/laravel-activitylog/v4)

```
use Illuminate\Database\Eloquent\Model;
use Spatie\Activitylog\Traits\LogsActivity;
use Spatie\Activitylog\LogOptions;

class NewsItem extends Model
{
    use LogsActivity;

    protected $fillable = ['name', 'text'];

    public function getActivitylogOptions(): LogOptions
    {
        return LogOptions::defaults()
        ->logOnly(['name', 'text']);
    }
}
```

Plugin usage
------------

[](#plugin-usage)

[![Screenshot of Application Feature](https://raw.githubusercontent.com/zanysoft/filament-activitylog/main/arts/resource.png)](https://raw.githubusercontent.com/zanysoft/filament-activitylog/main/arts/resource.png)

In your Panel ServiceProvider `(App\Providers\Filament)` active the plugin

Add the `ZanySoft\FilamentActivitylog\ActivitylogPlugin` to your panel config

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

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

Customising the ActivitylogResource
-----------------------------------

[](#customising-the-activitylogresource)

You can swap out the `ActivitylogResource` used by updating the `->resource()` value. Use this to create your own `CustomResource` class and extend the original at `\ZanySoft\FilamentActivitylog\Resources\ActivitylogResource::class`. This will allow you to customise everything such as the views, table, form and permissions.

Note

If you wish to change the resource on List and View page be sure to replace the `getPages` method on the new resource and create your own version of the `ListPage` and `ViewPage` classes to reference the custom `CustomResource`.

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->resource(\Path\For\Your\CustomResource::class),
        ]);
}
```

Customising label Resource
--------------------------

[](#customising-label-resource)

You can swap out the `Resource label` used by updating the `->label()` and `->pluralLabel()` value.

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->label('Log')
                ->pluralLabel('Logs'),
        ]);
}
```

Displaying the resource in the navigation
-----------------------------------------

[](#displaying-the-resource-in-the-navigation)

You can enable or disable the `Resource navigation item` by updating the `->navigationItem()` value.

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->navigationItem(false), // by default is true
        ]);
}
```

Grouping resource navigation items
----------------------------------

[](#grouping-resource-navigation-items)

You can add a `Resource navigation group` updating the `->navigationGroup()` value.

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->navigationGroup('Activity Log'),
        ]);
}
```

Customising a resource navigation icon
--------------------------------------

[](#customising-a-resource-navigation-icon)

You can swap out the `Resource navigation icon` used by updating the `->navigationIcon()` value.

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->navigationIcon('heroicon-o-shield-check'),
        ]);
}
```

Active a count badge
--------------------

[](#active-a-count-badge)

You can active `Count Badge` updating the `->navigationCountBadge()` value.

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->navigationCountBadge(true),
        ]);
}
```

Set navigation sort
-------------------

[](#set-navigation-sort)

You can set the `Resource navigation sort` used by updating the `->navigationSort()` value.

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->navigationSort(3),
        ]);
}
```

Authorization
-------------

[](#authorization)

If you would like to prevent certain users from accessing the logs resource, you should add a authorize callback in the `ActivitylogPlugin` chain.

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->authorize(
                    fn () => auth()->user()->id === 1
                ),
        ]);
}
```

Translate Resource Names
------------------------

[](#translate-resource-names)

To translate resource names in the activity log, add a `translateSubject` callback within the `ActivitylogPlugin` chain

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->translateSubject(fn($label) => __("yourCustomLangFile.".$label)),
        ]);
}
```

Translate Activity log key Names
--------------------------------

[](#translate-activity-log-key-names)

To translate the names of the keys in the activity log, add a `translateLogKey` callback within the `ActivitylogPlugin` chain

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->translateLogKey(fn($label) => __("yourCustomLangFile.".$label)),
        ]);
}
```

Customize Date Parsing
----------------------

[](#customize-date-parsing)

To customize how dates are parsed, depending on user preferences or settings:

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;
use Morilog\Jalali\Jalalian;
use Carbon\Carbon;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->dateParser(
                    fn($date) => auth()->user()->isJalaliCalendar() ?
                        Jalalian::fromDateTime($date) :
                        Carbon::parse($date)
                )
        ]);
}
```

Customize Date and DateTime Formats
-----------------------------------

[](#customize-date-and-datetime-formats)

To customize the format of dates and datetime columns based on user settings:

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->dateFormat('Y-m-d')
                ->datetimeFormat(fn() => auth()->user()->getFilamentDateTimeFormat())
        ]);
}
```

Customize DateTime Columns
--------------------------

[](#customize-datetime-columns)

To conditionally customize datetime columns in the UI, depending on the user's calendar preference:

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->customizeDatetimeColumn(function ($column) {
                    return $column->when(
                        auth()->user()->isJalaliCalendar(),
                        function ($column) {
                            return $column->jalaliDateTime();
                        }
                    );
                })
        ]);
}
```

Customize Date Picker Fields
----------------------------

[](#customize-date-picker-fields)

To customize date picker fields in forms, depending on user preferences:

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->customizeDatePicker(function ($field) {
                    return $field->when(
                        auth()->user()->isJalaliCalendar(),
                        function ($field) {
                            return $field->jalali();
                        }
                    );
                })
        ]);
}
```

Manipulate View Action Using Custom Activity Resource Trait
-----------------------------------------------------------

[](#manipulate-view-action-using-custom-activity-resource-trait)

Implement `getFilamentActualResourceModel` in the trait `HasCustomActivityResource` to determine the actual model related to the activity record for generating valid URLs.

```
use ZanySoft\FilamentActivitylog\Traits\HasCustomActivityResource;

trait HasCustomActivityResource
{
    public function getFilamentActualResourceModel($record)
    {
        $record = $record->subject->translatable;
        $model = null;

        switch ($record::class) {
            case FirstTranslatableModel::class:
                $model = $record->firstModel;
                break;

            case SecondTranslatableModel::class:
                $model = $record->secondModel;
                break;

            default:
                throw new Exception("Error Translatable subject model not found. record = ".$record::class, 1);
                break;
        }

        return $model;
    }
}
```

### Hide Restore / View Action

[](#hide-restore--view-action)

To hide the restore / view action globally for a resource within the `ActivitylogPlugin`, you can use the `isRestoreActionHidden` and `isResourceActionHidden` method. these are particularly useful in scenarios where you do not want users to have the ability to restore or view entries from the activity log. you can also customize the label of view action:

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->isRestoreActionHidden(true)
                ->isResourceActionHidden(true)
                ->resourceActionLabel("Sample Label")
        ]);
}
```

### Show Restore (Soft Deletes)

[](#show-restore-soft-deletes)

In the `laravel-activitylog` configuration file `config/activitylog.php`:

```
return [
    'subject_returns_soft_deleted_models' => true,
]
```

To globally display the restore (soft delete) action of a resource within the `ActivitylogPlugin`, you can use the `isRestoreModelActionHidden` method. This is particularly useful in scenarios where you do not want users to have the ability to restore activity log entries:

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->isRestoreModelActionHidden(false)
        ]);
}
```

### Role Policy

[](#role-policy)

To ensure ActivitylogResource access via RolePolicy you would need to add the following to your AppServiceProvider:

```
use App\Policies\ActivityPolicy;
use Illuminate\Support\Facades\Gate;
use Spatie\Activitylog\Models\Activity;

class AppServiceProvider extends ServiceProvider
{
    public function boot(): void
    {
        Gate::policy(Activity::class, ActivityPolicy::class);
    }
}
```

Full configuration
------------------

[](#full-configuration)

```
use ZanySoft\FilamentActivitylog\ActivitylogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ActivitylogPlugin::make()
                ->resource(\Path\For\Your\CustomResource::class)
                ->label('Log')
                ->pluralLabel('Logs')
                ->navigationItem(true)
                ->navigationGroup('Activity Log')
                ->navigationIcon('heroicon-o-shield-check')
                ->navigationCountBadge(true)
                ->navigationSort(2)
                ->authorize(
                    fn () => auth()->user()->id === 1
                )
                ->translateSubject(fn($label) => __("yourCustomLangFile.".$label)),
                ->dateParser(
                    fn($date) => auth()->user()->isJalaliCalendar() ?
                        Jalalian::fromDateTime($date) :
                        Carbon::parse($date)
                )
                ->dateFormat('Y-m-d')
                ->datetimeFormat(fn() => auth()->user()->getFilamentDateTimeFormat())
                ->customizeDatetimeColumn(function ($column) {
                    return $column->when(
                        auth()->user()->isJalaliCalendar(),
                        function ($column) {
                            return $column->jalaliDateTime();
                        }
                    );
                })
                ->customizeDatePicker(function ($field) {
                    return $field->when(
                        auth()->user()->isJalaliCalendar(),
                        function ($field) {
                            return $field->jalali();
                        }
                    );
                })
                ->isRestoreActionHidden(true)
                ->isResourceActionHidden(true)
                ->isRestoreModelActionHidden(false)
                ->resourceActionLabel("Sample Label"),
        ]);
}
```

Relationship manager
--------------------

[](#relationship-manager)

If you have a model that uses the `Spatie\Activitylog\Traits\LogsActivity` trait, you can add the `ZanySoft\FilamentActivitylog\RelationManagers\ActivitylogRelationManager` relationship manager to your Filament resource to display all of the activity logs that are performed on your model. [![Screenshot of Application Feature](https://raw.githubusercontent.com/zanysoft/filament-activitylog/main/arts/relationManager.png)](https://raw.githubusercontent.com/zanysoft/filament-activitylog/main/arts/relationManager.png)

```
use ZanySoft\FilamentActivitylog\RelationManagers\ActivitylogRelationManager;

public static function getRelations(): array
{
    return [
        ActivitylogRelationManager::class,
    ];
}
```

Timeline Action
---------------

[](#timeline-action)

[![Screenshot of Application Feature](https://raw.githubusercontent.com/zanysoft/filament-activitylog/main/arts/timeline.png)](https://raw.githubusercontent.com/zanysoft/filament-activitylog/main/arts/timeline.png)

To make viewing activity logs easier, you can use a custom action. In your UserResource in the table function, add the `ActivityLogTimelineTableAction`.

```
use ZanySoft\FilamentActivitylog\Actions\ActivityLogTimelineTableAction;

public static function table(Table $table): Table
{
    return $table
        ->actions([
            ActivityLogTimelineTableAction::make('Activities'),
        ]);
}
```

you can pass a matrix with the relationships, remember to configure your `Models`.

```
public static function table(Table $table): Table
{
    return $table
        ->actions([
            ActivityLogTimelineTableAction::make('Activities')
                ->withRelations(['profile', 'address']), //opcional
        ]);
}
```

You can configure the icons and colors, by default the `'heroicon-m-check'` icon and the `'primary'` color are used.

```
use ZanySoft\FilamentActivitylog\Actions\ActivityLogTimelineTableAction;

public static function table(Table $table): Table
{
    return $table
        ->actions([
            ActivityLogTimelineTableAction::make('Activities')
                ->timelineIcons([
                    'created' => 'heroicon-m-check-badge',
                    'updated' => 'heroicon-m-pencil-square',
                ])
                ->timelineIconColors([
                    'created' => 'info',
                    'updated' => 'warning',
                ])
        ]);
}
```

You can limit the number of results in the query by passing a limit, by default the last 10 records are returned.

```
use ZanySoft\FilamentActivitylog\Actions\ActivityLogTimelineTableAction;

public static function table(Table $table): Table
{
    return $table
        ->actions([
            ActivityLogTimelineTableAction::make('Activities')
                ->limit(30),
        ]);
}
```

Full Timeline configuration
---------------------------

[](#full-timeline-configuration)

```
use ZanySoft\FilamentActivitylog\Actions\ActivityLogTimelineTableAction;

public static function table(Table $table): Table
{
    return $table
        ->actions([
            ActivityLogTimelineTableAction::make('Activities')
                ->withRelations(['profile', 'address'])
                ->timelineIcons([
                    'created' => 'heroicon-m-check-badge',
                    'updated' => 'heroicon-m-pencil-square',
                ])
                ->timelineIconColors([
                    'created' => 'info',
                    'updated' => 'warning',
                ])
                ->limit(10),
        ]);
}
```

Acknowledgements
----------------

[](#acknowledgements)

Special acknowledgment goes to these remarkable tools.

- [Filament](https://github.com/filamentphp/filament)
- [Spatie Activitylog Contributors](https://github.com/spatie/laravel-activitylog#credits)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 50% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/77060551?v=4)[Mubashar Ahmad (مبشر احمد)](/maintainers/mubasharahmad)[@MubasharAhmad](https://github.com/MubasharAhmad)

---

Top Contributors

[![mubashar-mtp](https://avatars.githubusercontent.com/u/144340553?v=4)](https://github.com/mubashar-mtp "mubashar-mtp (1 commits)")[![zanysoft](https://avatars.githubusercontent.com/u/2682072?v=4)](https://github.com/zanysoft "zanysoft (1 commits)")

---

Tags

laravelfilamentactivitylogzanysoft

###  Code Quality

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/zanysoft-filament-activitylog/health.svg)

```
[![Health](https://phpackages.com/badges/zanysoft-filament-activitylog/health.svg)](https://phpackages.com/packages/zanysoft-filament-activitylog)
```

###  Alternatives

[spatie/laravel-permission

Permission handling for Laravel 12 and up

12.9k107.5M1.5k](/packages/spatie-laravel-permission)[dedoc/scramble

Automatic generation of API documentation for Laravel applications.

2.2k12.6M120](/packages/dedoc-scramble)[spatie/laravel-pdf

Create PDFs in Laravel apps

1.0k5.4M49](/packages/spatie-laravel-pdf)[codewithdennis/filament-select-tree

The multi-level select field enables you to make single selections from a predefined list of options that are organized into multiple levels or depths.

329575.9k33](/packages/codewithdennis-filament-select-tree)[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3914.8k](/packages/rawilk-profile-filament-plugin)[harris21/laravel-fuse

Circuit breaker for Laravel queue jobs. Protect your workers from cascading failures.

24773.9k](/packages/harris21-laravel-fuse)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)