devs_ryan / laravel-easy-admin
为 Laravel 项目提供的简单管理面板。
0.1.x-dev
2022-04-10 18:58 UTC
Requires
- php: >=7.2
- intervention/image: ^2.5
- laravel/framework: >=7.0
This package is auto-updated.
Last update: 2024-09-11 00:21:52 UTC
README
~ 为 Laravel 项目提供的简单管理面板。
YouTube 演示/教程
Laravel Easy Admin 是什么
- 待定。
安装
composer require devs_ryan/laravel-easy-admin
php artisan vendor:publish --tag="public" --provider="DevsRyan\LaravelEasyAdmin\LaravelEasyAdminServiceProvider"
php artisan migrate
(假设您的应用程序已存在用户表)- 从 http(s)://your-project-url.com/easy-admin 访问
用法
设置环境变量
以下可选 URL 变量可以在 Laravel .env 文件中设置
APP_URL
(在登录页面导航栏中提供回您应用程序的链接)EASY_ADMIN_APP_NAME
(更改 Easy Admin 导航栏左上角显示的名称)EASY_ADMIN_SUPPORT_EMAIL
(为 Easy Admin 用户提供帮助电子邮件地址)EASY_ADMIN_DEFAULT_NAMESPACE
(设置为 true 以使用 App\Models 命名空间)EASY_ADMIN_DEFAULT_PASSWORD
(此密码将在生成种子时为匹配password
的任何字段设置。默认为secret
)EASY_ADMIN_BASE_URL
(更改管理区域的基 URL。默认为 `easy-admin`)
创建 Easy Admin 用户
php artisan easy-admin:create-user
- 按照提示创建新的用户账户,以便通过 Easy Admin 访问
从数据库中删除用户
php artisan easy-admin:remove-user
- 按照提示从数据库中删除用户
授予现有用户 Easy Admin 访问权限
php artisan easy-admin:user
- 输入用户_id 或电子邮件地址以授予访问权限
从 Easy Admin 访问中删除现有用户
php artisan easy-admin:user --remove
- 输入用户_id 或电子邮件地址以删除访问权限
将模型资源添加到 Easy Admin
运行此命令后,将为指定的模型添加一个 CRUD 资源到 Easy Admin UI。
php artisan easy-admin:add-model
- 按照提示进行命名空间 E.G. "App" 和模型名称 E.G. "User"
- 这将在基础项目的 app/EasyAdmin 目录中生成一个新文件,您可以在其中取消注释任何不希望提供给 Easy Admin UI 的功能
从 Easy Admin 中删除模型资源
php artisan easy-admin:remove-model
- 按照提示进行命名空间 E.G. "App" 和模型名称 E.G. "User"
- 这将从 UI 中删除模型,并删除其 app/EasyAdmin 文件
刷新 Easy Admin 中的模型资源
php artisan easy-admin:refresh-model
- 按照提示进行命名空间 E.G. "App" 和模型名称 E.G. "User"
- 这将重新加载 app/EasyAdmin 目录中的公共文件到默认设置,并加载/删除模型中已更改的任何字段
将所有模型资源添加到 Easy Admin
将给定命名空间内的所有模型添加到 Easy Admin
重置 Easy Admin
如果您想将 Easy Admin 返回到原始状态,请使用以下命令。
php artisan easy-admin:reset
列出图像大小
列出在上传图像文件时生成的支持图像大小。
php artisan easy-admin:image-sizes
获取图像助手
用于检索使用 Easy Admin 创建的图像(使用上述命令查看大小选项)
easyImg($model_name, $field_name, $file_name, $size = 'original')
获取图像详细信息助手
用于检索使用 Easy Admin 创建的图像(带有完整图像详细信息,不适用于通用存储)
easyImgDetails($model_name, $field_name, $file_name)
- 注意:对于WYSIWYG相关图片,可以将 $field_name 参数设置为
null
或general_storage
获取文件助手
用于检索使用Easy Admin创建的文件
easyFile($model_name, $field_name, $file_name)
安全文本助手
用于从wysiwyg字段中移除任何HTML
easySafeText($blog_post->content)
限制
此管理面板假定您遵循Laravel模型和数据库表的命名规范。如果您使用 php artisan make:model {ModelName} -m
创建迁移/模型,则应该可以正常工作,否则可能不行。
预期用户表包含Laravel基础安装附带的一些字段,例如 email
和 password
。
所有模型资源都必须在其数据库表中包含一个 id
属性,以便路由可以正常工作。
许可证
Laravel Easy Admin是开源软件,根据GNU Lesser General Public License v3.0许可。