Skip to content
This repository has been archived by the owner on Jan 26, 2024. It is now read-only.

BlackHoleSecurity/laravel-admin

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

79 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Laravel Admin Panel

An admin panel for managing users, roles, permissions & crud.

Requirements

Laravel >=5.1
PHP >= 5.5.9

Installation

For Laravel >= 5.5 you need to follow these steps

  1. Run

    composer require appzcoder/laravel-admin
    
  2. Install the admin package.

    php artisan laravel-admin:install
    
  3. Make sure your user model's has a HasRoles trait app/User.php.

    class User extends Authenticatable
    {
        use Notifiable, HasRoles;
    
        ...
  4. You can generate CRUD easily through generator tool now.

For Laravel < 5.5 you need to follow these steps

  1. Run

    composer require appzcoder/laravel-admin
    
  2. Add service provider to config/app.php file.

    'providers' => [
        ...
    
        Appzcoder\LaravelAdmin\LaravelAdminServiceProvider::class,
        // For crud generator & html
        Appzcoder\CrudGenerator\CrudGeneratorServiceProvider::class,
        Collective\Html\HtmlServiceProvider::class,
    ],
  3. Add Collective/Html aliases to config/app.php file.

    'aliases' => [
        ...
    
        'Form' => Collective\Html\FormFacade::class,
        'HTML' => Collective\Html\HtmlFacade::class,
    ],
  4. Run composer dump-autoload

  5. Install the admin package.

    php artisan laravel-admin:install
    
  6. Make sure your user model's has a HasRoles trait app/User.php.

    class User extends Authenticatable
    {
        use Notifiable, HasRoles;
    
        ...
  7. You can generate CRUD easily through generator tool now.

Usage

  1. Create some roles.

  2. Create some permissions.

  3. Give permission(s) to a role.

  4. Create user(s) with role.

  5. For checking authenticated user's role see below:

    // Add roles middleware in app/Http/Kernel.php
    protected $routeMiddleware = [
        ...
        'roles' => \App\Http\Middleware\CheckRole::class,
    ];
    // Check role anywhere
    if(Auth::check() && Auth::user()->hasRole('admin')) {
        // Do admin stuff here
    } else {
        // Do nothing
    }
    
    // Check role in route middleware
    Route::group(['namespace' => 'Admin', 'prefix' => 'admin', 'middleware' => ['auth', 'roles'], 'roles' => 'admin'], function () {
       Route::get('/', ['uses' => 'AdminController@index']);
    });
  6. For checking permissions see below:

    if($user->can('permission-name')) {
        // Do something
    }

Learn more about ACL from here

Screenshots

roles

new role

permissions

give permission to a role

users

generator

Author

Sohel Amin 📧 Hire Me