acmetemplate/laravel-admin

Laravel Admin Panel

dev-master 2022-10-04 10:00 UTC

README

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

Requirements

Laravel >=7
PHP >= 7.0
Now we Support Laravel 9

Features

  • User, Role & Permission Manager
  • CRUD Generator
  • Activity Log
  • Page CRUD
  • Settings

Installation

  1. Run

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

    php artisan laravel-admin:install
    

    Service provider will be discovered automatically.

  3. Make sure your user model's has a HasRoles trait app/Models/User.php.

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

Note: If you are using Laravel 7+ then scaffold the authentication with bootstrap for a better experience.

Usage

  1. Create some permissions.

  2. Create some roles.

  3. Assign permission(s) to role.

  4. Create user(s) with role.

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

    // Add role middleware in app/Http/Kernel.php
    protected $routeMiddleware = [
        ...
        'role' => \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', 'role:admin']], function () {
       Route::get('/', ['uses' => 'AdminController@index']);
    });
    
    // Check permission in route middleware
    Route::group(['namespace' => 'Admin', 'prefix' => 'admin', 'middleware' => ['auth', 'can:write_user']], 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

For activity log please read spatie/laravel-activitylog docs

Screenshots

users

activity log

generator

settings

Author

[Mohamed Hassan] 📧 Email Me

##reference

Sohel Amin 📧 Email Me

License

This project is licensed under the MIT License - see the License File for details