hex-digital / admin-module
为我们的Laravel项目提供核心管理功能的模块。
Requires
- php: ^8.2
- filament/filament: ^2.0
- illuminate/filesystem: ^10.0
- illuminate/support: ^10.0
- jeffgreco13/filament-breezy: ^1.5
- spatie/laravel-package-tools: ^1.15
- spatie/laravel-permission: ^5.10
Requires (Dev)
- hex-digital/config-pint: ^1.1
- laravel/pint: ^1.10
- orchestra/testbench: ^8.0
- pestphp/pest: ^2.6
- pestphp/pest-plugin-arch: ^2.1
- phpstan/phpstan: ^1.10
- spatie/laravel-ray: ^1.32
- dev-main
- v0.2.0
- v0.1.0
- dev-dependabot/npm_and_yarn/axios-1.6.0
- dev-dependabot/composer/orchestra/testbench-8.14.1
- dev-dependabot/composer/pestphp/pest-2.24.2
- dev-dependabot/composer/phpstan/phpstan-1.10.41
- dev-dependabot/composer/spatie/laravel-permission-6.0.1
- dev-dependabot/composer/laravel/pint-1.13.5
- dev-dependabot/composer/filament/filament-2.17.55
- dev-dependabot/composer/pestphp/pest-plugin-arch-2.4.1
- dev-dependabot/github_actions/stefanzweifel/git-auto-commit-action-5
- dev-dependabot/npm_and_yarn/postcss-8.4.31
- dev-dependabot/composer/spatie/laravel-ray-1.33.0
- dev-dependabot/github_actions/actions/checkout-4
- dev-dependabot/composer/spatie/laravel-package-tools-1.16.1
- dev-dependabot/npm_and_yarn/vite-4.3.9
- dev-dependabot/composer/jeffgreco13/filament-breezy-1.5.9
This package is auto-updated.
Last update: 2024-09-11 15:54:26 UTC
README
本模块为我们Laravel项目提供了核心管理功能。本模块会自动处理安装和配置Filament、管理管理员以及管理管理员角色和权限。
安装
要开始使用管理模块,您可以通过composer安装该包
composer require hex-digital/admin-module
接下来,您需要发布模块及其依赖项的配置文件、迁移和资源。为了简化这一过程,模块附带了一个安装命令
php artisan admin-module:install
每次您升级模块或Filament时,都需要运行admim:module
和filament:upgrade
命令。我们建议将其添加到composer.json的post-update-cmd中
"post-update-cmd": [ // ... "@php artisan filament:upgrade", "@php artisan admin-module:publish", ],
现在,您应该运行迁移并同步权限
php artisan migrate php artisan permission:sync
最后,您可以使用以下命令创建新的管理员账户
php artisan make:filament-user
访问您的管理员面板/admin
进行登录,然后您就可以开始构建了。
用法
模型与资源
管理模块附带了一个用于认证的Admin
模型。您可以通过设置admin-module.admins.model
配置来覆盖此模型。
在底层,我们使用Spatie Roles and Permissions包来授权管理员。管理模块提供了一个用于管理管理员和角色的资源。
您可以通过编辑配置来自定义这些模型/资源。
权限
管理模块提供了一个permission:sync
命令,允许您同步权限,然后将其分配给角色。默认情况下,该模块提供了管理管理员和角色的权限。但是,您可以将自己的权限添加到admin-module.permissions
配置中。
测试
composer test
变更日志
请参阅CHANGELOG了解最近更改的详细信息。
贡献
请参阅CONTRIBUTING了解详细信息。
安全漏洞
如果您发现安全漏洞,请发送电子邮件至dev@hexdigital.com。所有安全漏洞都将得到及时处理。
致谢
许可
MIT许可(MIT)。请参阅许可文件获取更多信息。