README

一个可扩展的应用程序基础，基于Electro

此包旨在安装在Electro框架空白应用程序上。

功能

此插件提供

设计

基于Twitter Bootstrap 3的行政布局。

应用的主菜单。
面包屑导航。
自定义UI组件。
标准小部件的自定义样式。
每个捆绑页面的可覆盖模板。

用户和身份验证

支持角色的用户管理。

用于编辑登录用户个人资料的表单。
自动登录表单和注销操作。
用户和身份验证API的默认实现。

翻译支持

完全可翻译的界面。

翻译管理。

表单

多语言表单。
处理表单提交和自动创建、更新和删除记录的预定义操作。

捆绑UI组件

管理/通用应用程序布局

标签名	描述
Admin	所有管理页面的基本布局。
GridPage	显示记录列表的页面布局。
FormPage	显示表单的页面布局。
BaseAdmin	仅在需要完全自定义设计但保留所有捆绑脚本和样式的情况下使用此布局。
Main	一个带有顶部主菜单的简单布局。

子布局

标签名	描述
FormLayout	一个响应式表单容器。在内部使用 `Field` 组件。
FormLayout2Columns	一个具有两列的响应式表单容器。

小部件

标签名	描述
ActionBar	页面/表单操作的按钮容器。
ButtonNew	创建新记录的按钮。
ButtonSave	保存当前记录的按钮。
StandardFormActions	用于保存或删除当前记录的标准按钮。删除按钮对于新记录不显示。
ButtonSubmit	一个通用的提交按钮。
MenuItem	当它与当前URL匹配时自动突出显示的导航链接。
Paginator	Paginator组件的默认配置。
Panel	一个带有标题栏、页脚和操作栏的通用面板。
Static	静态（不可编辑）表单字段。
TerminalOutput	显示来自运行命令行进程输出的文本。
UserMenu	默认用户会话菜单。

安装

要在您的应用程序中安装此插件，请使用终端，cd 到您的应用程序目录，并输入

workman module:install-plugin selenia/selenia

为了正常运行，请勿直接使用Composer安装此包。

必需的配置设置

默认捆绑的管理页面需要配置一些设置。

如果您在应用程序中不使用这些页面，则不需要设置这些设置。

languages = [ 语言定义数组 ]
requireLogin = true
globalSessions（可选）

管理界面是多语言的（即使您的应用程序只使用一种语言），此插件默认启用翻译支持。

如果您已覆盖应用程序配置中的该设置，您需要启用它或创建一个子配置以启用所选URI前缀的翻译支持。

您至少需要在应用程序配置中定义一种语言，并在.env文件中选择默认语言。

示例

在 private/config/application.ini.php

return [
  'main' => [
    'languages'           => [
      'en:en-US:English:en_US|en_US.UTF-8|us',
      'pt:pt-PT:Português:pt_PT|pt_PT.UTF-8|ptg',
    ],
    'globalSessions'      => false, // share the session between the application and its sub-applications?
    'requireLogin'        => true,  // require login for this application?
  ]
];

在 .env

APP_DEFAULT_LANG  = en

用法

此插件集成到您应用程序的主菜单中。捆绑的页面将自动显示在其中。

如果应用程序未显示菜单，您需要手动导航到提供的URL以查看捆绑的管理页面之一。

用户管理页面的相对URL：admin/users

如果您希望应用程序中的页面继承捆绑的管理图形布局和默认功能，您需要

让您的控制器类继承自 Selenia\Controllers\SeleniaController
在每个视图中包含，作为根标签，一个是捆绑的布局模板之一（例如：<Selenia>）。

请参阅捆绑的管理页面源代码以获取具体示例。

插件开发

如果您需要修改此插件的相关资源，您需要在提交更改之前重新构建它。

安装开发工具

cd private/plugins/selenia/platform
npm install
bower install

重新构建插件

cd private/plugins/selenia/platform
npm run build

许可协议

Selenia平台是开源软件，根据MIT许可协议授权。

selene-framework / admin-module

维护者

详细信息