A Simple & Beautiful Exception Viewer for FilamentPHP's Admin Panel

• For FilamentPHP 2.x use version 1.x

1. You can install the package via composer:

composer require bezhansalleh/filament-exceptions

2. Publish and run the migration via:

php artisan exceptions:install

3. Register the plugin for the Filament Panel

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            \BezhanSalleh\FilamentExceptions\FilamentExceptionsPlugin::make()
        ]);
}

4. 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);
            }
        });

        ...
    }

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.

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

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
{

}

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
    ],
    // ...
}

Publish the translations with

php artisan vendor:publish --tag=filament-exceptions-translations

composer test

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

Please see CONTRIBUTING for details.

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

• Bezhan Salleh
• All Contributors

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