ge/lararole

"User Roles and permissions for the system"

Lararole

Lararole is the package to manage user's roles and permissions for your website/blog/website by using this package you will have role and permissions module where you can define as many role as you want along with permissions as well as you can easily customize theme as per your theme requirements., _(*1)

Please Note this package will assume you are already using laravel authentication system and you have already users table in your database, _(*2)

Installation

In order to use Laravel firstly, pull in the package through Composer, _(*3)

```$xslt composer require ge/lararole, <sub>(*4)</sub>

you can also add this package in your project's `composer.json` file.

```$xslt
"require": {
  "Ge/Lararole": "1.*",
}

after adding package in composer.json you will need to update composer, <sub>(*5)</sub>

composer update

And then include the service provider within app/config/app.php, <sub>(*6)</sub>

```$xslt 'providers' => [ Ge\Lararole\LararoleServiceProvider::class ];, <sub>(*7)</sub>

If you are in **laravel 5.6** then skip the last step laravel auto discover feature will be add automatically

#### Run Migration

php artisan migrate, <sub>(*8)</sub>

This will generate necessary database tables

###### Make User model Rolable
Open User Model and add rolable trait on it.

```$xslt
use Illuminate\Notifications\Notifiable;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Ge\Lararole\Ge\Rolable;

class User extends Authenticatable
{
    use Notifiable, Rolable;
}

You are all set, <sub>(*9)</sub>

Now you can user the package, <sub>(*10)</sub>

All available Routes

Template Customization

Of-course you want to customize template as per your site theme, you can override the template by publish vendor to your views directory, <sub>(*11)</sub>

```$xslt php artisan vendor:publish --provider=Ge\Lararole\LararoleServiceProvider::class --tag=views, <sub>(*12)</sub>

## Useful methods

```$xslt
// all the roles has assigned to this user

$user = User::find(1);

foreach($user->roles as $role)
{
    echo $role->name . '</br>';
}


// list all the permissions has in role with ID 1

$role = Role::find(1);

foreach($role->permissions as $permission)
{
    echo $permission->name . '</br>';
}

Happy coding..., <sub>(*13)</sub>