Nova Bouncer
Use the power of Bouncer within your Nova administration panel.
Installation
Note
Nova Bouncer requires laravel/nova ^4.0 and silber/bouncer ^1.0.
You may use Composer to install Nova Bouncer into your Laravel project:
composer require yadahan/nova-bouncer
Configuration
After installing the Nova Bouncer, you need to register the tool with Nova in app/Providers/NovaServiceProvder.php file:
public function tools()
{
return [
// ...
new \Yadahan\BouncerTool\BouncerTool,
];
}Next, add the Roles and Abilities MorphToMany fields to your User resource in app/Nova/User.php file:
use Laravel\Nova\Fields\MorphToMany;
use Laravel\Nova\Fields\Text;
public function fields(Request $request)
{
return [
// ...
MorphToMany::make('Roles', 'roles', 'Yadahan\BouncerTool\Nova\Role')->fields(function () {
return [
Text::make('Scope')
->sortable()
->rules('nullable', 'integer'),
];
}),
MorphToMany::make('Abilities', 'abilities', 'Yadahan\BouncerTool\Nova\Ability')
->fields(new \Yadahan\BouncerTool\Nova\PermissionsFields),
];
}Finally, publish the Nova Bouncer config using the vendor:publish Artisan command:
php artisan vendor:publish --provider="Yadahan\BouncerTool\BouncerToolServiceProvider"
After publishing the config, you may define the models and abilities that you want to manage, in config/bouncer-tool.php file:
'actions' => [
'*' => 'Manage',
'viewAny' => 'View Any',
'view' => 'View',
'create' => 'Create',
'update' => 'Update',
'replicate' => 'Replicate',
'delete' => 'Delete',
'restore' => 'Restore',
'forceDelete' => 'Force Delete',
'runAction' => 'Run Action',
'runDestructiveAction' => 'Run Destructive Action',
],
'entities' => [
'User' => App\Models\User::class,
],Basic Usage
A new section (Bouncer) will appear in your Nova navigation menu.
Warning
Only users who are authorized to manage the Bouncer models can see this navigation section.
You may give ability to manage the Bouncer models for a user or role:
$user = User::find(1);
Bouncer::allow($user)->toManage(\Silber\Bouncer\Database\Role::class);
Bouncer::allow($user)->toManage(\Silber\Bouncer\Database\Ability::class);
// or
$role = Bouncer::role()->create(['name' => 'manage-bouncer']);
Bouncer::allow($role)->toManage(\Silber\Bouncer\Database\Role::class);
Bouncer::allow($role)->toManage(\Silber\Bouncer\Database\Ability::class);
$user->assign($role);Laravel Authorization
https://laravel.com/docs/authorization#creating-policies
Generating Policies
You may generate a policy using the make:policy artisan command:
php artisan make:policy UserPolicy --model=User
Contributing
Thank you for considering contributing to the Nova Bouncer.
License
Nova Bouncer is open-sourced software licensed under the MIT license.
