Filament redirect incase canAccessFilament fails

In an application of mine, regular users can use the admin panel to manage some of their own content. To do so they had to verify their email. By default, Filament returns a 403 error when the canAccessFilament() method fails. I wanted to redirect the user to the email verification page instead.

#Creating the middleware

Start with creating a new middleware by running php artisan make:middleware RedirectFilament. Of course, you can choose the name yourself.

In your new middleware, write your redirection logic, here is mine as an example:

 1public function handle(Request $request, Closure $next)
 2{
 3    $user = Auth::user();
 4 
 5    if ($user instanceof FilamentUser && $user instanceof MustVerifyEmail) {
 6        if (! $user->canAccessFilament() && ! $user->hasVerifiedEmail()) {
 7            return redirect()->route('verification.notice');
 8        }
 9    }
10 
11    return $next($request);
12}

#Adding the middleware to the Filament config file

Add your middleware to the config/filament.php in the section middleware.auth.

 1'middleware' => [
 2    'auth' => [
 3        RedirectFilament::class, // <-- your middleware
 4        Authenticate::class,
 5    ],
 6    'base' => [
 7        EncryptCookies::class,
 8        AddQueuedCookiesToResponse::class,
 9        StartSession::class,
10        AuthenticateSession::class,
11        ShareErrorsFromSession::class,
12        VerifyCsrfToken::class,
13        SubstituteBindings::class,
14        DispatchServingFilamentEvent::class,
15        MirrorConfigToSubpackages::class,
16    ],
17],

#Change the middleware priority

You need to change the middleware priority because the filament middleware will trigger first, leading to a 403 error. To achieve this, checkout Sorting Middleware from the Laravel docs.
For me, my middleware had to come after \Illuminate\Session\Middleware\StartSession::class so the user would be authenticated and before \Illuminate\Contracts\Auth\Middleware\AuthenticatesRequests::class so the filament middleware doesn't trigger first.

 1protected $middlewarePriority = [
 2    \Illuminate\Foundation\Http\Middleware\HandlePrecognitiveRequests::class,
 3    \Illuminate\Cookie\Middleware\EncryptCookies::class,
 4    \Illuminate\Session\Middleware\StartSession::class,
 5    \Illuminate\View\Middleware\ShareErrorsFromSession::class,
 6    \App\Http\Middleware\RedirectFilament::class, // <-- your middleware
 7    \Illuminate\Contracts\Auth\Middleware\AuthenticatesRequests::class,
 8    \Illuminate\Routing\Middleware\ThrottleRequests::class,
 9    \Illuminate\Routing\Middleware\ThrottleRequestsWithRedis::class,
10    \Illuminate\Contracts\Session\Middleware\AuthenticatesSessions::class,
11    \Illuminate\Routing\Middleware\SubstituteBindings::class,
12    \Illuminate\Auth\Middleware\Authorize::class,
13];