Download the PHP package evo-mark/laravel-impersonate without Composer
On this page you can find all versions of the php package evo-mark/laravel-impersonate. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download evo-mark/laravel-impersonate
More information about evo-mark/laravel-impersonate
Files in evo-mark/laravel-impersonate
Download evo-mark/laravel-impersonate
More information about evo-mark/laravel-impersonate
Files in evo-mark/laravel-impersonate
Vendor evo-mark
Package laravel-impersonate
Short Description Laravel Impersonate is a plugin that allows to you to authenticate as your users.
License MIT
Package laravel-impersonate
Short Description Laravel Impersonate is a plugin that allows to you to authenticate as your users.
License MIT
Please rate this library. Is it a good library?
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](#requirements)
- [Installation](#installation)
- [Simple usage](#simple-usage)
- [Using the built-in controller](#using-the-built-in-controller)
- [Advanced Usage](#advanced-usage)
- [Defining impersonation authorization](#defining-impersonation-authorization)
- [Using your own strategy](#using-your-own-strategy)
- [Middleware](#middleware)
- [Events](#events)
- [Configuration](#configuration)
- [Blade](#blade)
- [Tests](#tests)
- [Contributors](#contributors)
- [Why Not Just Use loginAsId()?](#rationale)
## Requirements
- Laravel 10.x to 11.x
- PHP >= 8.2
### Laravel support
| Version | Release |
|:-------------:|:-------------:|
| 10.x to 11.x | 1.8 |
## Migrating to evo-mark/impersonate
1. Remove the original package with `composer remove lab404/laravel-impersonate`
2. Install the forked version using the instructions below
3. Rename any uses of the package's classes in your app from `Lab404\Impersonate` to `EvoMark\Impersonate`
## Installation
- Require it with Composer:
- Add the service provider at the end of your `config/app.php`:
- Add the trait `EvoMark\Impersonate\Models\Impersonate` to your **User** model.
## Simple usage
Impersonate a user:
Leave impersonation:
### Using the built-in controller
In your routes file, under web middleware, you must call the `impersonate` route macro.
Alternatively, you can execute this macro with your `RouteServiceProvider`.
## 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 instance.
## 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
- This package was forked from [Lab404](https://github.com/404labfr/laravel-impersonate) and is maintained by evoMark.
## Rationale
### Why not just use `loginAsId()`?
This package adds broader functionality, including Blade directives to allow you to override analytics and other tracking events when impersonating, fire events based on impersonation status, and more. Brief discussion at [issues/5](https://github.com/404labfr/laravel-impersonate/issues/5)
### Why did you fork this package
The original package seems to be in maintenance now, only receiving minor updates without addressing bugs or features. We wanted a few of those features.
## Licence
MIT
All versions of laravel-impersonate with dependencies
PHP Build Version
Package Version
The package evo-mark/laravel-impersonate contains the following files
Loading the files please wait ....