library acl

aginev/acl

ACL package for Laravel v5.0

ACL For Laravel 5

Access control list implementation form Laravel 5. Gives you roles and permissions for build in Laravel 5 Auth., _(*1)

Features

• CRUD for roles
• CRUD fot permissions
• Route middleware for checking user permissions
• Artisan command for parsing and adding newly created ACL dependant modules
• Composer installable
• PSR4 auto loading
• PSR2 code formatting

Requires

Build only for Laravel Framework only! The package required Glyph icons (http://glyphicons.com/)., _(*2)

"require": {
    "php": ">=5.5.9",
    "illuminate/foundation": "5.*",
    "illuminate/contracts": "5.*",
    "illuminate/database": "5.*",
    "illuminate/routing": "5.*",
    "illuminate/support": "5.*",
    "illuminate/view": "5.*",
    "illuminate/html": "5.*"
}

Installation

Require package at your composer.json file like so, _(*3)

{
    "require": {
        "aginev/acl": "1.1.*"
    }
}

Tell composer to update your dependencies, _(*4)

composer update

Or in terminal, _(*5)

composer require aginev/acl:1.1.*

Add Service Provider to your config/app.php like so, _(*6)

Aginev\Acl\AclServiceProvider::class,

Publish package assets, _(*7)

php artisan vendor:publish --provider="Aginev\Acl\AclServiceProvider" --tag="public"

Add package CSS to your layout, _(*8)

<link href="{{ asset('/vendor/acl/css/style.css') }}" rel="stylesheet">

Add package javascript to your layout. - script.js to be able to define role permission easily - restful.js to be able to execute RESTful delete, _(*9)

Feel free to make your own implementation if you don't have one already., _(*10)

<script src="{{ asset('/vendor/acl/js/script.js') }}"></script>
<script src="{{ asset('/vendor/acl/js/restful.js') }}"></script>

Add Laravel csrf token as a javascript object. Required only if use restful.js., _(*11)

<script>
    Laravel = {
        _token: '{{ csrf_token() }}'
    };
</script>

Run package migrations. You need to have your users table migrated., _(*12)

php artisan migrate --path="vendor/aginev/acl/src/Database/Migrations"

Seed the roles table. By default it will create two roles- No Permissions and Admin. No Permissions roles will be considered as a default role. You will be not able to delete this role. When deleting other role, all users using deleted role will be assigned to No Permissions role. By default the seeder will add all resources requesting ACL and will assign them to Admin role., _(*13)

php artisan db:seed --class="Aginev\Acl\Database\Seeds\RolesTableSeeder"

Modify one or more of your users to have a valid role_id. By default the added role_id foreign key will have a value of NULL, _(*14)

Add ACL user trait to your User model. It will add definition for the relation between roles and users table;, _(*15)

use \Aginev\Acl\Http\Traits\User;

At this point you have ACL up and running. Access roles and permissions CRUD at:, _(*16)

/admin/role, _(*17)

/admin/permission, _(*18)

Not happy with the route prefix? Publish the package config and edit routes_prefix value for your own or leave it blank for no prefix., _(*19)

php artisan vendor:publish --provider="Aginev\Acl\AclServiceProvider" --tag="config"

Edit route prefix, _(*20)

...
// Package route prefix. Set to blank for no prefix
'routes_prefix' => 'what-ever-you-want',
...

Package has a pagination in index views. If you need more items per page, edit per_page_results (default to 25) value at the config., _(*21)

...
// Pagination per page results
'per_page_results' => 50,
...

To define custom error messages format, edit validation_errors_format value at the config. This format will be applied only if your controllers are extending ACL base controller (\Aginev\Acl\Http\Controllers\AclController)., _(*22)

// validation errors format. Set to blank for default
'validation_errors_format' => '<label class="error text-danger">:message</label>',

And the most important thing... you want your controller to be ACL dependent. There two options for this., _(*23)

1.Add ACL middleware at your controller constructor., _(*24)

$this->middleware('acl');

2.Route group at routes.php, _(*25)

Route::group(['middleware' => 'acl'], function () {
    Route::get('group', 'SomeController@index');
});

After defining a ACL protected controllers like this you are able to run artisan command that will add all the routes in the permissions table, _(*26)

php artisan acl:fill-permissions

If you want to assign new permissions to role you can do it like so, _(*27)

php artisan acl:fill-permissions --assign-to-roles=2

Where 2 is the role_id. If you want pass many roles do it with comma separates list If you want to assign new permissions to role you can do it like so, _(*28)

php artisan acl:fill-permissions --assign-to-roles=1,2

Modifying default view

To modify default views you need to publish them, _(*29)

php artisan vendor:publish --provider="Aginev\Acl\AclServiceProvider" --tag="views"

Other

Publish migrations, _(*30)

php artisan vendor:publish --provider="Aginev\Acl\AclServiceProvider" --tag="migrations"

Publish seeds, _(*31)

php artisan vendor:publish --provider="Aginev\Acl\AclServiceProvider" --tag="seeds"

License

MIT - http://opensource.org/licenses/MIT, _(*32)