PHPackages                             filamerce/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. filamerce/filament-activitylog

ActiveLibrary

filamerce/filament-activitylog
==============================

This is my package activitylog

v2.7.0(9mo ago)0724MITPHPPHP ^8.2

Since Apr 1Pushed 9mo agoCompare

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

READMEChangelog (2)Dependencies (14)Versions (11)Used By (0)

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

[](#activitylog)

### Spatie/Laravel-activitylog for Filament

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

[![Latest Version on Packagist](https://camo.githubusercontent.com/244106c5463be486e13900476588fa0bd78749832abb029a1397d32b2b5fa58d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f66696c616d657263652f66696c616d656e742d61637469766974796c6f672e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/filamerce/filament-activitylog)[![Software License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](LICENSE.md)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/baf786ade8bccbe317e7ba65599d30879f2f561256af11b56b335884770f4691/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f66696c616d657263652f66696c616d656e742d61637469766974796c6f672f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/filamerce/filament-activitylog/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/1acaab74928b99527fedfc3b8d3794abfac61ff9c65592e9e51063b65edb1fb3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f66696c616d657263652f66696c616d656e742d61637469766974796c6f672e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/filamerce/filament-activitylog/stats)

[![Screenshot of Application Feature](https://raw.githubusercontent.com/filamerce/filament-activitylog/main/arts/cover.jpeg)](https://raw.githubusercontent.com/filamerce/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 v11
- Filament v3
- Spatie/Laravel-activitylog v4

Languages Supported
-------------------

[](#languages-supported)

ActivityLog Plugin is translated for :

- 🇧🇷 Brazilian Portuguese
- 🇺🇸 English
- 🇩🇪 German
- 🇪🇸 Spanish
- 🇫🇷 French
- 🇮🇷 Persian
- 🇦🇪 Arabic
- 🇵🇹 Portuguese
- 🇮🇱 Hebrew
- 🇱🇻 Latvian

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

[](#installation)

You can install the package via composer:

```
composer require filamerce/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',
        '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'                  => \Rmsramos\Activitylog\Resources\ActivitylogResource::class,
    ],
    '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/filamerce/filament-activitylog/main/arts/resource.png)](https://raw.githubusercontent.com/filamerce/filament-activitylog/main/arts/resource.png)

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

Add the `Rmsramos\Activitylog\ActivitylogPlugin` to your panel config

```
use Rmsramos\Activitylog\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 `\Rmsramos\Activitylog\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 Rmsramos\Activitylog\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 Rmsramos\Activitylog\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 Rmsramos\Activitylog\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 Rmsramos\Activitylog\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 Rmsramos\Activitylog\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 Rmsramos\Activitylog\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 Rmsramos\Activitylog\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 Rmsramos\Activitylog\ActivitylogPlugin;

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

### 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 Rmsramos\Activitylog\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
                ),
        ]);
}
```

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

[](#relationship-manager)

If you have a model that uses the `Spatie\Activitylog\Traits\LogsActivity` trait, you can add the `Rmsramos\Activitylog\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/filamerce/filament-activitylog/main/arts/relationManager.png)](https://raw.githubusercontent.com/filamerce/filament-activitylog/main/arts/relationManager.png)

```
use Rmsramos\Activitylog\RelationManagers\ActivitylogRelationManager;

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

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

[](#timeline-action)

[![Screenshot of Application Feature](https://raw.githubusercontent.com/filamerce/filament-activitylog/main/arts/timeline.png)](https://raw.githubusercontent.com/filamerce/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 Rmsramos\Activitylog\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 Rmsramos\Activitylog\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 Rmsramos\Activitylog\Actions\ActivityLogTimelineTableAction;

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

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

[](#full-timeline-configuration)

```
use Rmsramos\Activitylog\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),
        ]);
}
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

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

[](#acknowledgements)

Special acknowledgment goes to these remarkable tools and people (developers), the Activity Log plugin only exists due to the inspiration and at some point the use of these people's codes.

- [Jay-Are Ocero](https://github.com/199ocero/activity-timeline)
- [Alex Justesen](https://github.com/alexjustesen)
- [z3d0x](https://github.com/z3d0x/filament-logger)
- [Filament](https://github.com/filamentphp/filament)
- [Spatie Activitylog Contributors](https://github.com/spatie/laravel-activitylog#credits)

Credits
-------

[](#credits)

- [Rômulo Ramos](https://github.com/rmsramos)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

38

—

LowBetter than 84% of packages

Maintenance56

Moderate activity, may be stable

Popularity14

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 70.5% 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

Every ~14 days

Recently: every ~7 days

Total

9

Last Release

289d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e34f6439ff69a5e372136c97bf9166d48010bfa7dd29af729e8a6db98d58335d?d=identicon)[webard](/maintainers/webard)

---

Top Contributors

[![rmsramos](https://avatars.githubusercontent.com/u/5170473?v=4)](https://github.com/rmsramos "rmsramos (155 commits)")[![webard](https://avatars.githubusercontent.com/u/855788?v=4)](https://github.com/webard "webard (19 commits)")[![GeoSot](https://avatars.githubusercontent.com/u/22406063?v=4)](https://github.com/GeoSot "GeoSot (4 commits)")[![patrickwebsdev](https://avatars.githubusercontent.com/u/71416731?v=4)](https://github.com/patrickwebsdev "patrickwebsdev (4 commits)")[![sparksp](https://avatars.githubusercontent.com/u/243893?v=4)](https://github.com/sparksp "sparksp (3 commits)")[![Orphail](https://avatars.githubusercontent.com/u/38204752?v=4)](https://github.com/Orphail "Orphail (3 commits)")[![sugin223pl](https://avatars.githubusercontent.com/u/34408293?v=4)](https://github.com/sugin223pl "sugin223pl (3 commits)")[![edeoliv](https://avatars.githubusercontent.com/u/76831154?v=4)](https://github.com/edeoliv "edeoliv (3 commits)")[![atendwa](https://avatars.githubusercontent.com/u/125092307?v=4)](https://github.com/atendwa "atendwa (2 commits)")[![alisalehi1380](https://avatars.githubusercontent.com/u/111766206?v=4)](https://github.com/alisalehi1380 "alisalehi1380 (2 commits)")[![marcogermani87](https://avatars.githubusercontent.com/u/998645?v=4)](https://github.com/marcogermani87 "marcogermani87 (2 commits)")[![othyn](https://avatars.githubusercontent.com/u/7256684?v=4)](https://github.com/othyn "othyn (2 commits)")[![Muchwat](https://avatars.githubusercontent.com/u/13133862?v=4)](https://github.com/Muchwat "Muchwat (1 commits)")[![OsamahDev1](https://avatars.githubusercontent.com/u/102727367?v=4)](https://github.com/OsamahDev1 "OsamahDev1 (1 commits)")[![rafafdez-fillthegapp](https://avatars.githubusercontent.com/u/138085443?v=4)](https://github.com/rafafdez-fillthegapp "rafafdez-fillthegapp (1 commits)")[![tbcy](https://avatars.githubusercontent.com/u/43423272?v=4)](https://github.com/tbcy "tbcy (1 commits)")[![underdpt](https://avatars.githubusercontent.com/u/8122137?v=4)](https://github.com/underdpt "underdpt (1 commits)")[![adereksisusanto](https://avatars.githubusercontent.com/u/34746706?v=4)](https://github.com/adereksisusanto "adereksisusanto (1 commits)")[![zvizvi](https://avatars.githubusercontent.com/u/4354421?v=4)](https://github.com/zvizvi "zvizvi (1 commits)")[![ainesophaur](https://avatars.githubusercontent.com/u/4686198?v=4)](https://github.com/ainesophaur "ainesophaur (1 commits)")

---

Tags

laravelactivitylogRmsramos

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

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

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

###  Alternatives

[rmsramos/activitylog

This is my package activitylog

309346.5k2](/packages/rmsramos-activitylog)[vormkracht10/laravel-mails

Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app.

24149.7k](/packages/vormkracht10-laravel-mails)[spatie/laravel-prometheus

Export Laravel metrics to Prometheus

2651.3M6](/packages/spatie-laravel-prometheus)[muhammadsadeeq/laravel-activitylog-ui

A beautiful, modern UI for Spatie's Activity Log with advanced filtering, analytics, and real-time features.

17510.1k](/packages/muhammadsadeeq-laravel-activitylog-ui)[jacobtims/filament-logger

Activity logger for filament

1721.0k4](/packages/jacobtims-filament-logger)[hydrat/filament-table-layout-toggle

Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts.

6292.3k1](/packages/hydrat-filament-table-layout-toggle)

PHPackages © 2026

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