Download the PHP package crescent-purchasing/filament-auditing without Composer
On this page you can find all versions of the php package crescent-purchasing/filament-auditing. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download crescent-purchasing/filament-auditing
More information about crescent-purchasing/filament-auditing
Files in crescent-purchasing/filament-auditing
Package filament-auditing
Short Description Basic Management of O3 IT's Laravel Auditing library
License MIT
Homepage https://github.com/crescent-purchasing/filament-auditing
Informations about the package filament-auditing
Auditing for Filament
View and manage Audit History for your Laravel Models in Filament. Built upon the Laravel Auditing package by OwenIT.
Screenshots
Audit Overview
Viewing Audits
Filtering Audits
Restoring Audits
Features
Audit Resource
- View all Audits for all Resources within Filament
- Filter using a Query Builder
- View the audited record as well as the user who triggered the audit
- Uses cursor pagination by default for a performance boost
Relation Managers
- View the audits of a specific record to see when it was changed
- View the audits of a user to see what records they have changed see Owned Audits
Restoration
- Restore audits to previous points in their history
- Simple configuration for managing permission to perform a restoration
Installation
Prerequisites
This package requires the latest major version of Laravel Auditing, v14.
It'll be installed automatically, but it's recommended to install Laravel Auditing in your own repository.
Make sure to follow the installation instructions. It's recommended to give the full documentation a read, too.
Namely, make sure you publish the migration and configuration:
Install
You can then install this package via composer:
Usage
To use this plugin within your panel, add it to your plugins()
section in your PanelProvider
:
This will automatically add the Resource Page to your Filament Panel. It should also provide some basic configuration that will work for most use-cases.
Relation Manager
The plugin allows you to view the audit history of a specific record. To do so, simply add the Relation Manager to the resource:
Owned Audits
The plugin comes with the OwnedAuditsRelationManager
. This by default doesn't have support with Laravel Auditing.
However, it's easy to add the support. Simply add a relation function like the following to each of your User Models:
Then, add the relation manager to your Resources as normal:
Configuration
You can configure a few parts of the application.
Cursor Pagination
Cursor Pagination for Audits is enabled by default. You can disable this using cursorPagination()
:
Audit Model
By default, the configured audit.implementation
config value is used for the Audit Model.
This can be modified using model()
Formatting Auditable Type
The Auditable Type in tables is formatted as a Headline of the Class Basename.
You can customise this using a closure within formatAuditableTypeUsing()
:
Formatting Event Name
The event names are turned into a Headline. You can customise this using formatEventUsing()
:
Navigation Group
No Navigation Group for the Resource is set by default. You can set this using navigationGroup()
:
Navigation Icon
The Resource icon by default is heroicon-o-clock
. You can set this using navigationIcon()
:
Users
The default list of User classes is determined using the audit.user.guards
config value.
This then checks the list of auth providers in auth.providers
.
You can change this behaviour with users()
:
User Table Schema
By default, viewing user information of an Audit only displays 2 columns: email
and id
.
You can specify additional columns with userSchema
:
Testing
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.
Credits
License
The MIT License (MIT). Please see License File for more information.
All versions of filament-auditing with dependencies
filament/filament Version ^3.2.89
owen-it/laravel-auditing Version v14.0.0
spatie/laravel-package-tools Version ^1.15.0