https://github.com/imteajsajid12/laravel-multi-auth
officeal link
https://github.com/imteajsajid12/laravel-multi-auth
laravel-multiauth
Last synced: 4 months ago
JSON representation
officeal link
- Host: GitHub
- URL: https://github.com/imteajsajid12/laravel-multi-auth
- Owner: imteajsajid12
- Created: 2021-07-29T17:43:19.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2021-08-07T09:28:23.000Z (almost 4 years ago)
- Last Synced: 2025-01-15T13:10:56.697Z (6 months ago)
- Topics: laravel-multiauth
- Language: JavaScript
- Homepage: https://github.com/sarthaksavvy/laravel-multiauth
- Size: 9.61 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## About Laravel
## Installation
Install via composer.
```bash
composer require bitfumes/laravel-multiauth
```
Before proceeding : you can make a normal auth, check [this doc](https://github.com/bitfumes/laravel-multiauth#another-auth)
Publish Migrations
```bash
php artisan vendor:publish --tag="multiauth:migrations"
```
_For laravel 6 only_
With Laravel 6, the Views part is now exclueded into a package.
To have your UI or bootstrap theme on your project for this package, install official laravel-ui package
```bash
composer require laravel/ui --dev
```
Run [the Migration](https://github.com/bitfumes/laravel-multiauth/database/migrations/create_permission_tables.php) to have tables in your database.
```bash
php artisan migrate
```
**Caveat**
If you have added new column to admin migration then you should need admin factory to generate first super admin via above command.
```bash
php artisan vendor:publish --tag="multiauth:factories"
```
## First Admin
Obviously, first time you need at least one super admin to login with and then create other admins.
```
php artisan multiauth:seed --role=super
```
Now you can login your admin side by going to https://localhost:8000/admin with creadential of **email = [email protected]** and **password = secret**
Obviously you can later change these things.
## Register new Admin
To register new use you need to go to https://localhost:8000/admin/register.
Keep in mind that only a Super Admin can create new Admin.
**Changing admin views**
You can Publish package views files and overrides with yours so that you can have views which suits your project design.
```bash
php artisan vendor:publish --tag="multiauth:views"
```
**Validations**
Yes you can write validation rules to your new columns or change existing validation rules by publishing config file.
```bash
php artisan vendor:publish --tag="multiauth:config"
```
## Activate or Deactive admin
Now super admin can activate or deactivate other admin.
This will be usefull when you want to deactivate any admin for some reason.
By default new admin is deactivate, so that you can activate him when you want.
To activate admin, just go to the proceedure of editing admin.
## Change Prefix
You can change the prefix in your config file you have just published.
With prefix we mean what you want to call your admin side, we call it admin you can call it whatever you want.
Suppose you have changed prefix to 'master' now everywhere instead of 'admin' word, that changed to 'master'
```php
/*
|--------------------------------------------------------------------------
| Prefix
|--------------------------------------------------------------------------
|
| Use prefix to before the routes of multiauth package.
| This way you can keep your admin page secure.
| Default : admin
*/
'prefix' => 'admin', // can change it to, lets say 'prefix' => 'master'
```
## Redirect after Login
You can change the redirect path after login for admin section. Just change this setting on config/multiauth.php file.
```php
/*
|--------------------------------------------------------------------------
| Redirect After Login
|--------------------------------------------------------------------------
|
| It will redirect to a path defined here after login.
| You can change it to where ever you want to
| redirect the admin after login.
| Default : /admin/home
*/
'redirect_after_login' => '/admin/home',
```
## Create Roles
To create a new role you have two options:
1. Using artisan command
```bash
php artisan multiauth:role rolename
```
2. Using Interface
Just go to https://localhost:8000/admin/role.
Now you can click on 'Add Role' button to create new role.
**Edit or Delete Role can also be done with same interface**
## Publish Routes file
```bash
php artisan vendor:publish --tag="multiauth:routes"
```
## Access Level
**With Middleware**
1. You can use 'role' middleware to allow various admin for accessing certain section according to their role.
```php
Route::get('admin/check',function(){
return "This route can only be accessed by admin with role of Editor"
})->middleware('role:editor');
```
Here it does't matter if you give role as uppercase or lowercase or mixed, this package take care of all these.
2. If you want a section to be accessed by only super user then use role:super middleware
A super admin can access all lower role sections.
```php
Route::get('admin/check',function(){
return "This route can only be accessed by super admin"
})->middleware('role:super');
```
**With Blade Syntax**
You can simply use blade syntax for showing or hiding any section for admin with perticular role.
For example, If you want to show a button for admin with role of editor then write.
```php
@admin('editor')
Only For Editor
@endadmin
```
If you want to add multiple role, you can do like this
```php
@admin('editor,publisher,any_role')
This is visible to admin with all these role
@endadmin
```
## Another Auth
**Apart from Admin section, you can make a another auth**
This is fully compatible with laravel `MustVerifyEmail` trait, so that you can make user to must verify email. [click here](https://laravel.com/docs/5.8/verification) more details
```php
php artisan multiauth:make {guard}
```
After you run this command you will get steps in which files has been added/changed.
**You can rollback this auth also if you want.**
```php
php artisan multiauth:rollback {guard}
```
This command will show you steps to rollback and file that has changed/removed.
## License
This package inherits the licensing of its parent framework, Laravel, and as such is open-sourced
software licensed under the [MIT license](http://opensource.org/licenses/MIT)
## Fix Bug
### open /vendor/bitfumes/laravel/src/Http/Controller/Registercontroller.
#### then change update function
```php
use Bitfumes\Multiauth\Model\Role;
use Illuminate\Routing\Controller;
use Illuminate\Auth\Events\Registered;
use Illuminate\Foundation\Auth\RegistersUsers;
use Bitfumes\Multiauth\Http\Requests\AdminRequest;
use Bitfumes\Multiauth\Notifications\RegistrationNotification;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\RequestStack;
public function update($adminId, Request $request)
{
$request->validate([
'name' => 'required',
'email' => 'required',
'role_id' => 'required|',
]);
echo $request;
$admin = $this->adminModel::findOrFail($adminId);
$request['active'] = request('activation') ?? 0;
unset($request['activation']);
$admin->update($request->except('role_id'));
$admin->roles()->sync(request('role_id'));
return redirect(route('admin.show'))->with('message', "{$admin->name} details are successfully updated");
}
```