README

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

Requirements

Laravel >=5.5
PHP >= 7.0

Features

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

Installation

Run

composer require wikichua/laravel-bread

Install the admin package.
```
php artisan bread:install
```
Service provider will be discovered automatically.

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

class User extends Authenticatable
{
    use Notifiable, HasRoles;

    ...

You can generate CRUD easily through generator tool now.

Usage

Create some permissions.
Create some roles.
Assign permission(s) to role.
Create user(s) with role.

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']);
});

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

License

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

wikichua / laravel-bread

Maintainers

Details