Awesome
<a href="https://github.com/bezhanSalleh/filament-exceptions" class="filament-hidden"> <img style="width: 100%; max-width: 100%;" alt="filament-exceptions-art" src="https://user-images.githubusercontent.com/10007504/188786069-e93f01a1-d910-4888-a29a-28eea4ee0458.jpg" > </a> <p align="center" class="flex justify-center items-center"> <a href="https://filamentadmin.com/docs/2.x/admin/installation"> <img alt="FILAMENT 8.x" src="https://img.shields.io/badge/FILAMENT-3.x-EBB304?style=for-the-badge"> </a> <a href="https://packagist.org/packages/bezhansalleh/filament-exceptions"> <img alt="Packagist" src="https://img.shields.io/packagist/v/bezhansalleh/filament-exceptions.svg?style=for-the-badge&logo=packagist"> </a> <a href="https://github.com/bezhansalleh/filament-exceptions/actions?query=workflow%3Arun-tests+branch%3Amain" class="filament-hidden"> <img alt="Tests Passing" src="https://img.shields.io/github/actions/workflow/status/bezhansalleh/filament-exceptions/run-tests.yml?style=for-the-badge&logo=github&label=tests"> </a> <a href="https://github.com/bezhansalleh/filament-exceptions/actions?query=workflow%3A"Check+%26+fix+styling"+branch%3Amain" class="filament-hidden"> <img alt="Code Style Passing" src="https://img.shields.io/github/actions/workflow/status/bezhansalleh/filament-exceptions/fix-php-code-style-issues.yml?style=for-the-badge&logo=github&label=code%20style"> </a> <a href="https://packagist.org/packages/bezhansalleh/filament-exceptions"> <img alt="Downloads" src="https://img.shields.io/packagist/dt/bezhansalleh/filament-exceptions.svg?style=for-the-badge" > </a> </p>Exception Viewer
A Simple & Beautiful Exception Viewer for FilamentPHP's Admin Panel
- For FilamentPHP 2.x use version 1.x
Installation
- You can install the package via composer:
composer require bezhansalleh/filament-exceptions
- Publish and run the migration via:
php artisan exceptions:install
- Register the plugin for the Filament Panel
public function panel(Panel $panel): Panel
{
return $panel
->plugins([
\BezhanSalleh\FilamentExceptions\FilamentExceptionsPlugin::make()
]);
}
- Activate the plugin by editing your App's Exception Handler as follow:
<?php
namespace App\Exceptions;
use BezhanSalleh\FilamentExceptions\FilamentExceptions;
class Handler extends ExceptionHandler
{
...
public function register()
{
$this->reportable(function (Throwable $e) {
if ($this->shouldReport($e)) {
FilamentExceptions::report($e);
}
});
...
}
Configuration
The configuration file filament-exceptions.php is automatically published into your config directory.
The config file provides you with multiple options to customize the plugin.
Mass Pruning
By default Filament Exceptions is configured to prune exceptions older than 1 week.
To modify how long you'd like to store records for you can supply a Carbon object like so
'period' => now()->subWeek(), // 1 week
'period' => now()->subDay(), // 1 day
'period' => now()->subDays(3), // 3 days
Note This requires laravel scheduler to be setup and configured in order to work. You can see how to do that here Running The Scheduler
Custom Exception Model
For those who need to change the model this is possible using the configuration file.
'exception_model' => Exception::class,
When creating your new exception model you should extend the default model
<?php
namespace App\Models;
use BezhanSalleh\FilamentExceptions\Models\Exception as BaseException;
class Exception extends BaseException
{
}
Theme
By default the plugin uses the default theme of Filamentphp, but if you are using a custom theme then include the plugins view path into the content array of your tailwind.config.js file:
export default {
content: [
// ...
'./vendor/bezhansalleh/filament-exceptions/resources/views/**/*.blade.php', // Language Switch Views
],
// ...
}
Translations
Publish the translations with
php artisan vendor:publish --tag=filament-exceptions-translations
Testing
composer test
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.