README

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

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

功能

此插件提供

设计

基于Twitter Bootstrap 3的行政布局。

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

用户和认证

支持角色的用户管理。

用于编辑登录用户资料的表单。
自动登录表单和注销操作。
User和Authentication 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许可证授权。

selenia-plugins/admin-interface

维护者

详细信息