Download the PHP package rmsramos/activitylog without Composer

ActivityLog

Spatie/Laravel-activitylog for Filament

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

• Laravel v11
• Filament v3
• Spatie/Laravel-activitylog v4

Languages Supported

ActivityLog Plugin is translated for :

• 🇧🇷 Brazilian Portuguese
• 🇺🇸 English
• 🇪🇸 Spanish
• 🇫🇷 French
• 🇮🇷 Persian
• 🇦🇪 Arabic
• 🇵🇹 Portuguese

Installation

You can install the package via composer:

After that run the install command:

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

And run migrates

You can manually publish the configuration file with:

This is the contents of the published config file:

Optionally, you can publish the views using

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

Plugin usage

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

Add the Rmsramos\Activitylog\ActivitylogPlugin to your panel config

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.

Customising label Resource

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

Displaying the resource in the navigation

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

Grouping resource navigation items

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

Customising a resource navigation icon

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

Active a count badge

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

Set navigation sort

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

Authorization

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

Role Policy

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

Full configuration

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.

Timeline Action

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

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

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

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

Full Timeline configuration

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

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
• Alex Justesen
• z3d0x
• Filament
• Spatie Activitylog Contributors

Credits

• Rômulo Ramos
• All Contributors

License

The MIT License (MIT). Please see License File for more information.