romtokarev / laravel-easy-admin
为 Laravel 项目提供的简单管理面板。
dev-master
2021-09-08 06:25 UTC
Requires
- php: >=7.2
- intervention/image: ^2.5
- laravel/framework: >=7.0
This package is auto-updated.
Last update: 2024-09-08 12:48:51 UTC
README
此项目从 https://github.com/devs-ryan/laravel-easy-admin 分支修复。
~ 为 Laravel 项目提供的简单管理面板。
YouTube 演示/教程
什么是 Laravel Easy Admin
- 待定。
安装
composer require devs_ryan/laravel-easy-admin
php artisan vendor:publish --tag=public --force
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
- 按照提示输入命名空间,例如 "App" 和模型名称,例如 "User"
- 这将在项目的 app/EasyAdmin 目录中生成一个新文件,您可以在其中取消注释任何不希望提供给 Easy Admin UI 的功能
从 Easy Admin 中删除模型资源
php artisan easy-admin:remove-model
- 按照提示输入命名空间,例如 "App" 和模型名称,例如 "User"
- 这将从 UI 中删除模型,并删除其对应的 app/EasyAdmin 目录中的文件
在 Easy Admin 中刷新模型资源
php artisan easy-admin:refresh-model
- 按照提示输入命名空间,例如 "App" 和模型名称,例如 "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)
- 注意:$field_name参数可以设置为
null
或general_storage
,用于WYSIWYG相关的图片
获取文件助手
用于检索使用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许可。