Download the PHP package macromindonline/laravel-impersonate without Composer
On this page you can find all versions of the php package macromindonline/laravel-impersonate. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download macromindonline/laravel-impersonate
More information about macromindonline/laravel-impersonate
Files in macromindonline/laravel-impersonate
Package laravel-impersonate
Short Description Laravel Impersonate is a plugin that allows to you to authenticate as your users.
License MIT
Informations about the package laravel-impersonate
Laravel Impersonate
Laravel Impersonate makes it easy to authenticate as your users. Add a simple trait to your user model and impersonate as one of your users in one click.
- Requirements
- Installation
- Simple usage
- Using the built-in controller
- Advanced Usage
- Defining impersonation authorization
- Using your own strategy
- Middleware
- Events
- Configuration
- Blade
- Tests
- Contributors
Requirements
- Laravel >= 5.5
- PHP >= 7
See release v1.1 for Laravel <= 5.4 support.
Installation
-
Require it with Composer:
-
Add the service provider at the end of your
config/app.php
: - Add the trait
Lab404\Impersonate\Models\Impersonate
to your User model.
Simple usage
Impersonate a user:
Leave impersonation:
Using the built-in controller
In your routes file you must call the impersonate
route macro.
Advanced Usage
Defining impersonation authorization
By default all users can impersonate an user.
You need to add the method canImpersonate()
to your user model:
By default all users can be impersonated.
You need to add the method canBeImpersonated()
to your user model to extend this behavior:
Using your own strategy
-
Getting the manager:
- Working with the manager:
Middleware
Protect From Impersonation
You can use the middleware impersonate.protect
to protect your routes against user impersonation.
This middleware can be useful when you want to protect specific pages like users subscriptions, users credit cards, ...
Events
There are two events available that can be used to improve your workflow:
TakeImpersonation
is fired when an impersonation is taken.LeaveImpersonation
is fired when an impersonation is leaved.
Each events returns two properties $event->impersonator
and $event->impersonated
containing User model isntance.
Configuration
The package comes with a configuration file.
Publish it with the following command:
Available options:
Blade
There are three Blade directives available.
When the user can impersonate
When the user can be impersonated
This comes in handy when you have a user list and want to show an "Impersonate" button next to all the users.
But you don\'t want that button next to the current authenticated user neither to that users which should not be able to impersonated according your implementation of canBeImpersonated()
.
When the user is impersonated
Tests
Contributors
- MarceauKa
- tghpow
- and all others contributors
Licence
MIT