Use the power of Bouncer within your Nova administration panel.
![Nova Bouncer screenshot](https://raw.githubusercontent.com/yadahan/nova-bouncer/master/screenshot-light.png)
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
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,
],
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);
https://laravel.com/docs/authorization#creating-policies
You may generate a policy using the make:policy
artisan command:
php artisan make:policy UserPolicy --model=User
Thank you for considering contributing to the Nova Bouncer.
Nova Bouncer is open-sourced software licensed under the MIT license.