tuvaergun/permission

Light-weight role-based permissions for Laravel 5 built in Auth system.

tuvaergunrgun/permission

Laravel Permission adds role based permissions to built in Auth System of Laravel 5. Permission middleware protects routes and even crud controller methods., _(*1)

Table of Contents

• Requirements
• Getting Started
• Documentation
• Roadmap
• Change Logs
• Contribution Guidelines

Requirements

• This package requires PHP 5.4+

Getting Started

1. Require the package in your composer.json and update your dependency with composer update:

"require": {
...
"tuvaergun/permission": "~1.0@dev",
...
},

1. Add the package to your application service providers in config/app.php.

'providers' => [

'Illuminate\Foundation\Providers\ArtisanServiceProvider',
'Illuminate\Auth\AuthServiceProvider',
...
'Tuva\Permission\PermissionServiceProvider',

],

1. Publish the package migrations to your application and run these with `php artisan migrate.

$ php artisan vendor:publish --provider="Tuva\Permission\PermissionServiceProvider"

Use your own models. Once you publish, it publishes the configuration file where you can define your own models which should extend to Permission models., _(*2)

1. Add the middleware to your app/Http/Kernel.php.

protected $routeMiddleware = [

....
'permission' => 'Tuva\Permission\Middleware\HasPermission',

];

1. Add the HasRole trait to your User model.

use Tuva\Permission\Traits\HasRole;

class User extends Model implements AuthenticatableContract, CanResetPasswordContract
{
use Authenticatable, CanResetPassword, HasRole;
}

Documentation

Follow along the Wiki to find out more., _(*3)

Roadmap

Here's the TODO list for the next release (2.0)., _(*4)

• [ ] Refactoring the source code.
• [ ] Correct all issues.
• [ ] Adding cache to final user permissions.
• [ ] Adding tests.

Change Logs

June 14, 2015 (latest) * [x] Added backward compatibility to l5.0 for lists() method. * [x] Added Blade Template Extensions., _(*5)

March 28, 2015 * [x] Added Role Scope to get all users having a specific role. e.g User::role('admin')->get(); will list all users having admin role., _(*6)

March 7, 2015 * [x] is() and can() methods now support comma for AND and pipe as OR operator. Or pass an operator as a second param. more information * [x] You can bind multiple permissions together so they inherit ones permission. more information, _(*7)

Contribution Guidelines

Support follows PSR-2 PHP coding standards, and semantic versioning., _(*8)

Please report any issue you find in the issues page. Pull requests are welcome., _(*9)