This is a plugin for Filament that makes it easy to impersonate your users.
This package uses https://github.com/404labfr/laravel-impersonate under the hood, and borrows heavily from https://github.com/KABBOUCHI/nova-impersonate.
You know the drill:
composer require stechstudio/filament-impersonateFirst open the resource where you want the impersonate action to appear. This is generally going to be your UserResource class.
Go down to the table method. After defining the table columns, you want to add Impersonate as a new action for the table via actions method. Your class should look like this:
namespace App\Filament\Resources;
use Filament\Resources\Resource;
use STS\FilamentImpersonate\Tables\Actions\Impersonate;
class UserResource extends Resource {
public static function table(Table $table)
{
return $table
->columns([
// ...
])
->actions([
Impersonate::make(), // <---
]);
}You can also define a guard and redirectTo for the action:
Impersonate::make('impersonate')
->guard('another-guard')
->redirectTo(route('some.other.route'));Now open the page where you would want the button to appear, this will commonly be EditUser;
Go to the getActions method and add the Impersonate page action here.
<?php
namespace App\Filament\Resources\UserResource\Pages;
use App\Filament\Resources\UserResource;
use Filament\Resources\Pages\EditRecord;
use STS\FilamentImpersonate\Pages\Actions\Impersonate;
class EditUser extends EditRecord
{
protected static string $resource = UserResource::class;
protected function getActions(): array
{
return [
Impersonate::make()->record($this->getRecord()) // <--
];
}
}Note: you must pass the record in as seen in this example!
The only other step is to display a notice in your app whenever you are impersonating another user. Open up your master layout file and add <x-impersonate::banner/> before the closing </body> tag.
That's it. You should now see an action icon next to each user in your Filament UserResource list:
When you click on the impersonate icon you will be logged in as that user, and redirected to your main app. You will see the impersonation banner at the top of the page, with a button to leave and return to Filament:
All configuration can be managed with ENV variables, no need to publish and edit the config directly. Just check out the config file.
By default, only Filament admins can impersonate other users. You can control this by adding a canImpersonate method to your FilamentUser class:
class User implements FilamentUser {
public function canImpersonate()
{
return true;
}
}You can also control which targets can be impersonated. Just add a canBeImpersonated method to the user class with whatever logic you need:
class User {
public function canBeImpersonated()
{
// Let's prevent impersonating other users at our own company
return !Str::endsWith($this->email, '@mycorp.com');
}
}The blade component has a few options you can customize.
The banner is dark by default, you can set this to light, or auto.
<x-impersonate::banner style='light'/>The banner will show the name of the impersonated user, assuming there is a name attribute. You can customize this if needed:
<x-impersonate::banner :display='auth()->user()->email'/>
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent