You can install the package in to a Laravel app that uses Nova via composer:
composer require dytechltd/nova-permission
Go through the Installation section in order to setup laravel-permission.
Next up, you must register the tool with Nova. This is typically done in the tools
method of the NovaServiceProvider
.
// in app/Providers/NovaServiceProvider.php
// ...
public function tools()
{
return [
// ...
\Dytechltd\NovaPermission\NovaPermissionTool::make(),
];
}
Next, add middleware to config/nova.php
// in config/nova.php
'middleware' => [
// ...
\Dytechltd\NovaPermission\ForgetCachedPermissions::class,
],
Finally, add MorphToMany
fields to you app/Nova/User
resource:
// ...
use Laravel\Nova\Fields\MorphToMany;
public function fields(Request $request)
{
return [
// ...
MorphToMany::make('Roles', 'roles', \Dytechltd\NovaPermission\Role::class),
MorphToMany::make('Permissions', 'permissions', \Dytechltd\NovaPermission\Permission::class),
];
}
Or if you want to attach multiple permissions at once, use RoleBooleanGroup
and PermissionBooleanGroup
fields (requires at least Nova 2.6.0):
// ...
use Dytechltd\NovaPermission\PermissionBooleanGroup;
use Dytechltd\NovaPermission\RoleBooleanGroup;
public function fields(Request $request)
{
return [
// ...
RoleBooleanGroup::make('Roles'),
PermissionBooleanGroup::make('Permissions'),
];
}
If your User
could have a single role at any given time, you can use RoleSelect
field. This field will render a standard select where you can pick a single
role from.
// ...
use Dytechltd\NovaPermission\PermissionBooleanGroup;
use Dytechltd\NovaPermission\RoleSelect;
public function fields(Request $request)
{
return [
// ...
RoleSelect::make('Role', 'roles'),
];
}
If you want to use custom resource classes you can define them when you register a tool:
// in app/Providers/NovaServiceProvider.php
// ...
public function tools()
{
return [
// ...
\Dytechltd\NovaPermission\NovaPermissionTool::make()
->roleResource(CustomRole::class)
->permissionResource(CustomPermission::class),
];
}
If you want to show your roles and policies with a custom label, you can set $labelAttribute
when instantiating your fields:
// ...
use Dytechltd\NovaPermission\PermissionBooleanGroup;
use Dytechltd\NovaPermission\RoleSelect;
public function fields(Request $request)
{
return [
// ...
RoleBooleanGroup::make('Roles', 'roles', null, 'description'),
PermissionBooleanGroup::make('Permissions', 'permissions', null, 'description'),
RoleSelect::make('Role', 'roles', null, 'description'),
];
}
// in app/Providers/NovaServiceProvider.php
// ...
public function tools()
{
return [
// ...
\Dytechltd\NovaPermission\NovaPermissionTool::make()
->rolePolicy(RolePolicy::class)
->permissionPolicy(PermissionPolicy::class),
];
}
A new menu item called "Permissions & Roles" will appear in your Nova app after installing this package.