aldozumaran/acl

Laravel 5.2 ACL

Acl

Laravel 5.2 Acl, _(*1)

Installation

Add to composer.json, _(*2)

"aldozumaran/acl": "1.*"

Run "composer update", _(*3)

Add to config/app.php providers, _(*4)

AldoZumaran\Acl\AclServiceProvider::class,

Add to config/app.php aliases, _(*5)

'Acl' => AldoZumaran\Acl\Facades\Acl::class,

Add Middleware in kernel.php, _(*6)

'acl' => \AldoZumaran\Acl\Http\Middleware\AclMiddleware::class,

In User model add this Trait, _(*7)

use AldoZumaran\Acl\Traits\AclUserTrait;
class User extends Authenticatable
{

    use AclUserTrait;

Publish views, Model..., _(*8)

php artisan vendor:publish

Change .env file, _(*9)

CACHE_DRIVER=array

And create acl tables:, _(*10)

/*
    //Optional: use seed (AclTableSeeder)
    // Create default permissions (read, update, create, destroy),
    // Create super-admin role
    // Create test route
    // Create default user
    // Add permissions to default user for test route

Add in database/seeds/DatabaseSeeder.php, _(*11)

    $this->call(AclTableSeeder::class);

Add in database/factories/ModelFactory.php, _(*12)

    $factory->define(App\Models\Acl\Role::class, function (Faker\Generator $faker) {
        return [
            'code' => $faker->word,
            'name' => $faker->name,
            'description' => $faker->paragraph,
        ];
    });
    $factory->define(App\Models\Acl\Permission::class, function (Faker\Generator $faker) {
        return [
            'code' => $faker->word,
            'name' => $faker->name,
            'description' => $faker->paragraph,
        ];
    });
    $factory->define(App\Models\Acl\Section::class, function (Faker\Generator $faker) {
        return [
            'code' => $faker->word,
            'name' => $faker->name,
            'description' => $faker->paragraph,
        ];
    });
    $factory->define(App\Models\Acl\PermissionRoleSection::class, function (Faker\Generator $faker) {
        return [
            'permission_id' => 1,
            'role_id' => 1,
            'section_id' => 1,
        ];
    });
    $factory->define(App\Models\Acl\PermissionSectionUser::class, function (Faker\Generator $faker) {
        return [
            'permission_id' => 1,
            'section_id' => 1,
            'user_id' => 1,
        ];
    });
*/

composer dump-autoload, _(*13)

php artisan migrate --seed, _(*14)

Add ACL routes and test route, _(*15)

Route::group(['middleware' => ['web']], function () {
    \Acl::routes();

    Route::group(['middleware' => ['auth','acl']], function () {
        Route::resource('test/custom','CustomController'); // TEST ROUTE
    });
});

Default Configuration in config/acl.php, _(*16)

//Set your named routes <b>permissions</b> (route actions), defaults are:
'permissions' => [
    'index' => 'read',
    'create' => 'create',
    'store' => 'create',
    'show' => 'read',
    'edit' => 'update',
    'update' => 'update',
    'destroy' => 'destroy',
    'read_update' => ['read','update'],
],

//If permission not exists, redirect to index
'redirect_to_index' => true,

// L5.2 Guard auth
'guard' => 'web',

//Set the auth model namespace
'user' => '\App\User',

//route acl prefix . EX. admin/ set admin
'route_prefix' => '', 

// acl urls
'routes' => [
    'roles' => 'acl/roles',
    'users' => 'acl/users',
    'sections' => 'acl/sections',
    'permissions' => 'acl/permissions',
    'index' => 'acl',
],

// roles with access to acl
'granted_roles' => '', // 'admin' or 'admin,webmaster' or ['admin','webmaster']

// super admin role
'role_admin' => 'super-admin',
'email_admin' => 'i@am.me',

// http status error 
'http_status' => 403,

Usage

Go to /acl/ (Default configuration), _(*17)

This plugin works with named routes, _(*18)

Create a TEST ROUTE controller, _(*19)

php artisan make:controller CustomController --resource


// Route::resource('test/custom','CustomController');

generate test.custom.index, test.custom.create, test.custom.store, ..., _(*20)

Add in Section: /acl/sections (prefix resource controller) or (use AclTableSeeder), _(*21)

test.custom

Add Permissions in /acl/permissions or (use AclTableSeeder), _(*22)

read, update, create, destroy

Add Roles in /acl/roles or (use AclTableSeeder), _(*23)