https://github.com/tappnetwork/filament-authentication-log
https://github.com/tappnetwork/filament-authentication-log
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/tappnetwork/filament-authentication-log
- Owner: TappNetwork
- Created: 2023-08-16T16:20:38.000Z (almost 3 years ago)
- Default Branch: 4.x
- Last Pushed: 2026-01-20T00:41:46.000Z (5 months ago)
- Last Synced: 2026-01-20T07:54:52.004Z (5 months ago)
- Language: PHP
- Size: 1.92 MB
- Stars: 51
- Watchers: 4
- Forks: 23
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Filament Authentication Log
[](https://packagist.org/packages/tapp/filament-authentication-log)
[](https://packagist.org/packages/tapp/filament-authentication-log)
A Filament plugin for [Laravel Authentication Log](https://github.com/rappasoft/laravel-authentication-log) package.
This package provides a Filament resource and a relation manager for [Laravel Authentication Log](https://github.com/rappasoft/laravel-authentication-log).
## Dependencies
- [Laravel Authentication Log](https://github.com/rappasoft/laravel-authentication-log)
Follow the configuration instructions for [laravel-authentication-log](https://rappasoft.com/docs/laravel-authentication-log/v1/start/configuration)
- Publish and run the migrations
- Add the `AuthenticationLoggable` and `Notifiable` traits to your `User` model
## Version Compatibility
Filament | Laravel | Laravel Authentication Log | Filament Authentication Log | Documentation
:---------|:----------|:-----------------------------|:----------------------------|:--------------
2.x | 9.x/10.x | 3.x | 2.x | [Check the docs](https://github.com/TappNetwork/filament-authentication-log/tree/2.x)
3.x | 10.x/11.x | 4.x | 3.x | [Check the docs](https://github.com/TappNetwork/filament-authentication-log/tree/3.x)
3.x | 12.x | 5.x | 4.x | [Check the docs](https://github.com/TappNetwork/filament-authentication-log/tree/3.x)
4.x/5.x | 12.x | 5.x/6.x | 5.x | Current
## Installation
> [!IMPORTANT]
> Please check the **Filament Authentication Log** plugin version you should use in the **Version Compatibility** table above.
You can install the plugin via Composer:
```bash
composer require tapp/filament-authentication-log:"^5.0"
```
You can publish the translations files with:
```bash
php artisan vendor:publish --tag="filament-authentication-log-translations"
```
You can publish the config file with:
```bash
php artisan vendor:publish --tag="filament-authentication-log-config"
```
## Using the Resource
Add this plugin to a panel in the `plugins()` method.
E.g., in `app/Providers/Filament/AdminPanelProvider.php`:
```php
use Tapp\FilamentAuthenticationLog\FilamentAuthenticationLogPlugin;
public function panel(Panel $panel): Panel
{
return $panel
// ...
->plugins([
FilamentAuthenticationLogPlugin::make()
// ->panelName('admin') // Optional: specify the panel name if needed
]);
}
```
That's it! Now you can see the Authentication Log resource on left sidebar.
This customization `->panelName('admin')` allows for better organization if you have multiple panels, such as Developer and Admin panels, where the `FilamentAuthenticationLogPlugin` is used in one panel but the user resource is available only in another panel.
### Resource appearance
## Using the Relation Manager
Add the `Tapp\FilamentAuthenticationLog\RelationManagers\` to the `getRelations()` method on the Filament resource where the model uses the `AuthenticationLoggable` trait.
E.g. in `App\Filament\Resources\UserResource.php`:
```php
use Tapp\FilamentAuthenticationLog\RelationManagers\AuthenticationLogsRelationManager;
public static function getRelations(): array
{
return [
AuthenticationLogsRelationManager::class,
// ...
];
}
```
### Relation manager appearance
### Displaying Authenticatable Names
To display the actual name of the authenticatable user instead of the class name, you can configure the plugin to show a specific field. By default, it will use the `name` field if available. If your model does not have a `name` column, you can add a custom attribute:
In your model:
```php
public function getNameAttribute(): string
{
return trim($this->first_name . ' ' . $this->last_name);
}
```
### Configuration
To specify a custom field to display for the authenticatable user, update the `config/filament-authentication-log.php` configuration file:
```php
'authenticatable' => [
'field-to-display' => 'name', // Change 'name' to your custom field if needed
],
```
### Custom User Resource
If you have a custom user resource in your application that is not automatically detected by the package, you can specify it in your configuration file. This is particularly useful when:
- Your user resource has a non-standard name or location
- You have multiple panels and the default user resource detection fails
- You want to link authentication logs to a specific user resource implementation
To configure a custom user resource, add this to your `config/filament-authentication-log.php` file:
```php
'user-resource' => \App\Filament\Resources\YourCustomUserResource::class,
```
This configuration allows the authentication log to properly generate edit links to your user records on resource, even when the default user resource detection mechanism cannot find them.
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.