maxime-rainville / recipe-admin
仅适用于管理员使用的 SilverStripe 项目的起点。
Requires
- silverstripe/admin: ^1.4.1
- silverstripe/login-forms: ^4.0.0-beta1
- silverstripe/recipe-core: ^4.4.1
- silverstripe/recipe-plugin: ^1.2.1
- silverstripe/reports: ^4.4.1
- silverstripe/siteconfig: ^4.4.1
Suggests
- silverstripe/asset-admin: Allows file management in your portal.
- silverstripe/versioned: Allows you to keep track of you model's change over time
- silverstripe/versioned-admin: Allows you to restored archived records
This package is auto-updated.
Last update: 2024-08-27 11:11:04 UTC
README
recipe-admin
是一个为“门户”项目设计的 SilverStripe 食谱,该项目只需要使用 SilverStripe 的“管理”部分来管理 DataObjects。
食谱做了什么?
- 移除 CMS 功能,
- 将管理区域设置为默认路由,
- 添加通用登录页面,无需自己设计样式,
- 展示可复制和适应您目的的通用 DataObject,
- 展示如何设置默认组,
- 展示一个通用报告。
入门指南
将 recipe-admin 添加到您的 composer 文件中。
# If starting a brand new project composer create-project maxime-rainville/recipe-admin your-project-folder # If you already have a composer file composer require maxime-rainville/recipe-admin
将 .env-sample
重命名为 .env
并根据您的环境调整设置。
从现在起,只需按照 SilverStripe 项目的正常设置步骤进行即可。
接下来做什么?
该食谱包含一些简单的示例,可以帮助您快速入门。但您需要根据您的使用情况调整示例代码。
设置您的 DataObjects
基本食谱中包含两个基本 DataObjects:狗和品种。它们都附带示例代码,说明如何
- 定义基本关系
- 设置基本验证规则
- 定义基本权限。
复制或重命名这些 DataObject 以适应您的使用情况。
定义 ModelAdmin 控制器
狗和品种可以通过“DogAdmin” ModelAdmin
进行管理。重命名 DogAdmin
并调整它以引用您自己的 DataObjects。
在模型中设置默认区域
Recipe-admin 已配置为具有默认管理区域。这将是在用户登录到您的门户后首先看到的屏幕。
默认情况下,这指向 DogAdmin
。更新 app/_config/routes.yml
以指向您自己的 ModelAdmin
SilverStripe\Admin\AdminRootController: url_base: 'a' - default_panel: DogAdmin + default_panel: YourCustomAdmin
定义一些默认数据
recipe-admin
附带一些默认记录。这将在您的第一次 dev/build
时预填充项目数据。在设置新环境时,这允许您快速开始,而无需加载数据库快照。
调整 app/_config/default-records.yml
以反映您自己的 DataObjects。
定义一些默认组
recipe-admin
附带一个简单的 DataExtension
,向您展示如何定义默认组。调整组以及 app/_config/default-records.yml
中定义的权限,以反映您自己的 DataObjects。
为您的用户创建一些报告
BreedReport
展示您如何创建自定义报告,允许用户获得对数据的细化视图。
如果您的用户不需要此数据,只需删除 BreedReport
,则“报告”面板将隐藏。