devs_ryan / laravel-easy-admin

为 Laravel 项目提供的简单管理面板。

0.1.x-dev 2022-04-10 18:58 UTC

This package is auto-updated.

Last update: 2024-09-11 00:21:52 UTC


README

~ 为 Laravel 项目提供的简单管理面板。

YouTube 演示/教程



Built For Laravel Version License Requires

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 参数设置为 nullgeneral_storage

获取文件助手

用于检索使用Easy Admin创建的文件

  • easyFile($model_name, $field_name, $file_name)

安全文本助手

用于从wysiwyg字段中移除任何HTML

  • easySafeText($blog_post->content)

限制

此管理面板假定您遵循Laravel模型和数据库表的命名规范。如果您使用 php artisan make:model {ModelName} -m 创建迁移/模型,则应该可以正常工作,否则可能不行。

预期用户表包含Laravel基础安装附带的一些字段,例如 emailpassword

所有模型资源都必须在其数据库表中包含一个 id 属性,以便路由可以正常工作。

许可证

Laravel Easy Admin是开源软件,根据GNU Lesser General Public License v3.0许可。