yadahan/nova-bouncer

A Laravel Nova tool for managing Bouncer roles and abilities.

v2.1.0 2024-12-16 00:27 UTC

This package is auto-updated.

Last update: 2024-12-16 00:28:38 UTC


README

StyleCI Total Downloads GitHub license

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.