{"id":13733092,"url":"https://github.com/Z3d0X/filament-logger","last_synced_at":"2025-05-08T09:31:39.384Z","repository":{"id":37801766,"uuid":"485408748","full_name":"Z3d0X/filament-logger","owner":"Z3d0X","description":"Extensible activity logger for filament that works out-of-the-box.","archived":false,"fork":false,"pushed_at":"2024-07-08T12:53:16.000Z","size":573,"stargazers_count":287,"open_issues_count":7,"forks_count":42,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-11-05T22:44:47.525Z","etag":null,"topics":["activity-logger","activitylog","filamentadmin","filamentphp","hacktoberfest","laravel","laravel-filament","log","logger"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Z3d0X.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-04-25T14:36:53.000Z","updated_at":"2024-11-02T00:28:08.000Z","dependencies_parsed_at":"2024-03-26T05:21:59.263Z","dependency_job_id":"926d66ab-a2ec-4a6b-9fb1-ec760c20a810","html_url":"https://github.com/Z3d0X/filament-logger","commit_stats":{"total_commits":74,"total_committers":16,"mean_commits":4.625,"dds":0.7162162162162162,"last_synced_commit":"d6ef1c79e3260eeddcc80aaf004c9be0d7fd94ab"},"previous_names":[],"tags_count":29,"template":false,"template_full_name":"spatie/package-skeleton-laravel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Z3d0X%2Ffilament-logger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Z3d0X%2Ffilament-logger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Z3d0X%2Ffilament-logger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Z3d0X%2Ffilament-logger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Z3d0X","download_url":"https://codeload.github.com/Z3d0X/filament-logger/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224717552,"owners_count":17357902,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["activity-logger","activitylog","filamentadmin","filamentphp","hacktoberfest","laravel","laravel-filament","log","logger"],"created_at":"2024-08-03T03:00:37.566Z","updated_at":"2024-11-15T01:31:16.026Z","avatar_url":"https://github.com/Z3d0X.png","language":"PHP","funding_links":[],"categories":["Logging"],"sub_categories":[],"readme":"# Activity logger for filament\n\n[![Latest Version on Packagist](https://img.shields.io/packagist/v/z3d0x/filament-logger.svg?style=for-the-badge)](https://packagist.org/packages/z3d0x/filament-logger)\n[![Total Downloads](https://img.shields.io/packagist/dt/z3d0x/filament-logger.svg?style=for-the-badge)](https://packagist.org/packages/z3d0x/filament-logger)\n\n\u003cp align=\"center\" class=\"filament-hidden\"\u003e\n  \u003cimg alt=\"logger banner\" src=\"https://raw.githubusercontent.com/z3d0x/filament-logger/main/art/banner.jpeg\" /\u003e\n\u003c/p\u003e\n\nConfigurable activity logger for filament.\nPowered by `spatie/laravel-activitylog`\n\n## Features\nYou can choose what you want to log and how to log it.\n- Log Filament Resource Events\n- Log Login Event\n- Log Notification Events\n- Log Model Events\n- Easily extendable to log custom events\n\nNote: By default this package will log Filament Resource Events, Access(Login) Events, and Notification Events. If you want to log a model that is not a FilamentResource you will have to manually register in the config file.\n\n## Installation\n\n| Plugin Version | Filament Version |\n|----------------|------------------|\n| \u003c 0.5.x        | ^2.11            |\n| \u003e= 0.6.0       | 3.x              |\n\nThis package uses [spatie/laravel-activitylog](https://spatie.be/docs/laravel-activitylog), instructions for its setup can be found [here](https://spatie.be/docs/laravel-activitylog/v4/installation-and-setup)\n\nYou can install the package via composer:\n\n```bash\ncomposer require z3d0x/filament-logger\n```\nAfter that run the install command:\n\n```bash\nphp artisan filament-logger:install\n```\nThis will publish the config \u0026 migrations from `spatie/laravel-activitylog`\n\nFor Filament v3, you need to register a resource in PanelProvider\n```php\npublic function panel(Panel $panel): Panel\n{\n    return $panel\n        -\u003eresources([\n            config('filament-logger.activity_resource')\n        ]);\n}\n```\n## Authorization\nTo enforce policies on `ActivityResource`, after generating a policy, you would need to register `Spatie\\Activitylog\\Models\\Activity` to use that policy in the AuthServiceProvider.\n```php\n\u003c?php\n \nnamespace App\\Providers;\n \nuse App\\Policies\\ActivityPolicy;\nuse Illuminate\\Foundation\\Support\\Providers\\AuthServiceProvider as ServiceProvider;\nuse Spatie\\Activitylog\\Models\\Activity;\n \nclass AuthServiceProvider extends ServiceProvider\n{\n    protected $policies = [\n        // Update `Activity::class` with the one defined in `config/activitylog.php`\n        Activity::class =\u003e ActivityPolicy::class,\n    ];\n    //...\n}\n```\n\u003e If you are using [Shield](https://filamentphp.com/plugins/shield) just register the ActivityPolicy generated by it\n\n## Translations\nPublish the translations using:\n\n```bash\nphp artisan vendor:publish --tag=\"filament-logger-translations\"\n```\n\n## Activity Model resolution\nThe main `Activity` class being used by the Filament Resource instance will be resolved by Spatie's service provider, which loads the model defined by the configuration key found at `activitylog.activity_model` in `config/activitylog.php`.\n\n## Screenshots\n\u003cimg alt=\"logger-index\" src=\"https://raw.githubusercontent.com/z3d0x/filament-logger/main/art/list-screenshot.png\"\u003e\n\u003cimg alt=\"logger-detail-1\" src=\"https://raw.githubusercontent.com/z3d0x/filament-logger/main/art/view-screenshot-1.png\"\u003e\n\u003cimg alt=\"logger-detail-2\" src=\"https://raw.githubusercontent.com/z3d0x/filament-logger/main/art/view-screenshot-2.png\"\u003e\n\n## Changelog\n\nPlease see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.\n\n## Contributing\n\nPlease see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details.\n\n## Security Vulnerabilities\n\nPlease review [our security policy](../../security/policy) on how to report security vulnerabilities.\n\n## Credits\n\n- [Ziyaan Hassan](https://github.com/Z3d0X)\n- [Spatie Activitylog Contributors](https://github.com/spatie/laravel-activitylog#credits) \n- [All Contributors](../../contributors)\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZ3d0X%2Ffilament-logger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FZ3d0X%2Ffilament-logger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZ3d0X%2Ffilament-logger/lists"}