dytechltd / nova-permission
一个用于Spatie权限库的Laravel Nova工具。
2.7.4
2021-12-01 19:31 UTC
Requires
- php: ^7.4|^8.0
- spatie/laravel-permission: ^3.0|^4.0
This package is auto-updated.
Last update: 2024-09-29 05:29:32 UTC
README
安装
您可以通过composer将此包安装到使用Nova的Laravel应用程序中。
composer require dytechltd/nova-permission
请参阅安装部分以设置laravel-permission。
接下来,您必须将工具与Nova注册。这通常在NovaServiceProvider
的tools
方法中完成。
// in app/Providers/NovaServiceProvider.php // ... public function tools() { return [ // ... \Dytechltd\NovaPermission\NovaPermissionTool::make(), ]; }
接下来,向config/nova.php
中添加中间件
// in config/nova.php 'middleware' => [ // ... \Dytechltd\NovaPermission\ForgetCachedPermissions::class, ],
最后,将MorphToMany
字段添加到您的app/Nova/User
资源中
// ... 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), ]; }
或者,如果您想一次性分配多个权限,请使用RoleBooleanGroup
和PermissionBooleanGroup
字段(至少需要Nova 2.6.0)
// ... use Dytechltd\NovaPermission\PermissionBooleanGroup; use Dytechltd\NovaPermission\RoleBooleanGroup; public function fields(Request $request) { return [ // ... RoleBooleanGroup::make('Roles'), PermissionBooleanGroup::make('Permissions'), ]; }
如果您的User
在任何给定时间只能有一个角色,您可以使用RoleSelect
字段。该字段将渲染一个标准选择,您可以从中选择单个角色。
// ... use Dytechltd\NovaPermission\PermissionBooleanGroup; use Dytechltd\NovaPermission\RoleSelect; public function fields(Request $request) { return [ // ... RoleSelect::make('Role', 'roles'), ]; }
自定义
如果您想使用自定义资源类,可以在注册工具时定义它们
// in app/Providers/NovaServiceProvider.php // ... public function tools() { return [ // ... \Dytechltd\NovaPermission\NovaPermissionTool::make() ->roleResource(CustomRole::class) ->permissionResource(CustomPermission::class), ]; }
如果您想以自定义标签显示您的角色和政策,可以在实例化字段时设置$labelAttribute
// ... 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), ]; }
用法
安装此包后,在您的Nova应用程序中会看到一个名为“权限 & 角色”的新菜单项。