ZiNETHQ Spark Roles

SparkRoles, based on Caffeinated Shinobi, brings a simple and light-weight role-based permissions system to Laravel Spark's Team and User models through the following ACL structure:

Every user can have zero or more roles.
Every user can have zero or more permissions.
Every team can have zero or more roles.
Every team can have zero or more permissions.
Roles and permissions can be shared between users and teams.
Optionally, users and teams with a certain role (e.g. developer) are added to the Spark developer's array.

Permissions are then inherited to the team/user through the team/user's assigned roles.

This package is a replacement for Caffeinated Shinobi when building a project based on Laravel/Spark.

Documentation

You will find user friendly documentation in the ZiNETHQ SparkRoles Wiki BEING UPDATED

Quick Installation

Install the package through Composer.
```
composer require zinethq/spark-roles
```

Publish the configuration, models, and migrations into your project.

php artisan vendor:publish --provider="ZiNETHQ\SparkRoles\SparkRolesServiceProvider"

Migrate your database.
```
php artisan migrate
```
Add the service provider to your project's config/app.php file.
```
ZiNETHQ\SparkRoles\SparkRolesServiceProvider::class,
```

Add the CanUseRoles trait to your Team and/or User models, for example:

app\Team.php

<?php

namespace App;

use Laravel\Spark\Team as SparkTeam;
use ZiNETHQ\SparkRoles\Traits\CanHaveRoles;

class Team extends SparkTeam
{
    use CanHaveRoles;
    ...
}

app\User.php

<?php

namespace App;

use Laravel\Spark\User as SparkUser;
use ZiNETHQ\SparkRoles\Traits\CanHaveRoles;

class User extends SparkUser
{
    use CanHaveRoles;
    ...
}

Optional: If you'd like to dynamically assign the Spark developer array based on team/user roles then open app\Http\kernel.php and add the following to the web middleware group:
```
\ZiNETHQ\SparkRoles\Middleware\AddDevelopers::class,
```
This middleware can be controlled (enabled/disabled and choose the role slug that identifies developers) in the package's configuration file.
Start using roles for your Spark teams and users!

Contributing

Fork, edit, pull request. You know the drill.

Hit list

If you'd like to contribute consider helping with one of the following:

~~Add Travis CI integration~~
~~Add PHPUnit support~~
Add meaningful unit tests
Add a Kiosk based frontend for defining roles and permissions, similar to Watchtower for Shinobi

Awesome Shinobi

Caffeinated Shinobi is an awesome tool for Laravel that adds Role Based Access Control (RBAC) to your user model. There is also a cool UI for Shinobi called Watchtower. Go take a look!

mailnike / spark-roles