ramivel/ramivel

Laravel package

Installs: 56

Dependents: 0

Suggesters: 0

Security: 0

Stars: 2

Watchers: 1

Forks: 0

Open Issues: 1

Language:JavaScript

dev-master 2019-12-15 12:38 UTC

This package is auto-updated.

Last update: 2022-01-19 22:07:54 UTC


README

This package is just create admin side (multi auth), which is totaly isolated from your normal auth ( which we create using php artisan make:auth )

On top of that, you can use multiple authentication types, simultaneously, so you can be logged in as a user and an admin, without conflicts!

Version Guidance

Laravel version Branch Install
5.6, 5.7 and 5.8 Master composer require ramivel/ramivel

Installation

Install via composer.

 composer require ramivel/ramivel

Yuo must publish this line

 php artisan vendor:publish --tag="ramivel:publish" --force
 php artisan vendor:publish --tag=lfm_config
 php artisan vendor:publish --tag=lfm_public

Add this trait on this following path ../vendor/laravel/framework/src/Illuminate/Database/Eloquent/Model.php

if (trait_exists('App\Relation\RelationMethods')) { 
    trait call_relation_helpers {
        use \App\Relation\RelationMethods; 
        } 
    }else{ 
        trait call_relation_helpers{} 
}


abstract class Model implements ArrayAccess, Arrayable, Jsonable, JsonSerializable, QueueableEntity, UrlRoutable
{
    use call_relation_helpers,
    ......... atc

config\app.php --> aliases array

        'Up' => App\Http\Controllers\Upload::class,

        'Btn' => App\helpers\Src\Btn::class,
        'bsForm' => App\helpers\Src\bsForm::class,
        'langForm' => App\helpers\Src\langForm::class,
        'MyRoute' => App\helpers\Src\Routes\MyRoute::class,
        'Files' => App\helpers\Src\Files\Files::class,
        'Control' => App\helpers\Src\Control::class,

composer.json

    "autoload-dev": {
        "files":[
            "app/Helpers/HelperValidatesRequest.php",
            "app/Helpers/helpers.php",
            "app/Helpers/routesMethods.php",
            "app/Helpers/functions.php",
            "app/Helpers/Src/bsForm.php",
            "app/Helpers/Src/Btn.php",
            "app/Helpers/Src/Control.php",
            "app/Helpers/Src/langForm.php",
            "app/Relation/RelationMethods.php"
        ],
php artisan storage:link

Run This Commend

composer dump-autoload

Run the Migration to have tables in your database.

php artisan migrate --seed

Change this code in ConfigHandler

<?php

namespace UniSharp\LaravelFilemanager\Handlers;

class ConfigHandler
{
    public function userField()
    {
        if(auth('admin')->check())
        {      
            return auth('admin')->user()->id;
        }
        else
        {
            return 'admin';
        }
    }



/*
    public function userField()
    {
        
        return auth()->user()->id;
    }
*/
}

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 = super@admin.com 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.

Validations

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'

 /*
    |--------------------------------------------------------------------------
    | 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.

/*
    |--------------------------------------------------------------------------
    | 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
php artisan multiauth:role rolename
  1. 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

Access Level

With Middleware

  1. You can use 'role' middleware to allow various admin for accessing certain section according to their role.
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.

  1. 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.
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.

@admin('editor')
    <button>Only For Editor</button>
@endadmin

If you want to add multiple role, you can do like this

@admin('editor,publisher,any_role')
    <button> This is visible to admin with all these role</button>
@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 more details

php artisan multiauth:make {guard}

You can rollback this auth also if you want.

php artisan multiauth:rollback {guard}