selenia/platform

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

0.10.28 2021-01-08 00:31 UTC

README

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

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

功能

此插件提供

设计
  1. 基于Twitter Bootstrap 3的行政布局。
  • 您的应用程序的主菜单。
  • 面包屑导航。
  • 自定义UI组件。
  • 标准小部件的自定义样式。
  • 每个捆绑页面的可覆盖模板。
用户和认证
  1. 支持角色的用户管理。
  • 用于编辑登录用户资料的表单。
  • 自动登录表单和登出操作。
  • User和Authentication API的默认实现。
翻译支持
  1. 完全可翻译的界面。
  • 翻译管理。
表单
  • 多语言表单。
  • 处理表单提交、自动创建、更新和删除记录的预定义操作。

捆绑UI组件

行政/通用应用程序布局
子布局
小部件

安装

要在您的应用程序上安装此插件,请使用终端,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

如果您希望应用程序上的页面继承捆绑的行政图形布局和默认功能,则需要

  1. 使您的控制器类继承自Selenia\Controllers\SeleniaController
  2. 在每个视图中包含一个捆绑布局模板(例如: <Selenia>),作为根标签。

查看捆绑的行政页面的源代码以获取具体示例。

插件开发

如果您需要对此插件资产进行修改,您需要提交更改之前重建它。

安装开发工具

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

重建插件

cd private/plugins/selenia/platform
npm run build

许可

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

Selenia平台 - 版权所有 © Cláudio Silva和Impactwave, Lda.