README

它帮助你在 Yii2 框架中动态构建、验证和显示设置变量。

支持 Bootstrap(默认), AdminLTE 和 Gentelella Alela!。

这是什么

Yii2 Setting 是一个通用的 设置 拓展，可以为 Yii2 应用提供开箱即用的定制、操作和显示配置项的功能。它可以帮助你动态地构建配置项，并将设置的验证规则、数据处理方式等扩展信息保存在数据库。它的配置页面预置支持 Bootstrap、AdminLTE 和 Gentelella Alela!，同时提供了命令行工具、Gii 生成工具以及设置项迁移工具。

一个理想的使用场景是，开发者在本地开发环境使用命令行或页面生成工具创建所需的设置项，配置设置项规则，然后使用迁移工具（迁移）将设置迁移至指定的线上环境。

安装

安装此扩展的首选方式是通过 composer。

运行

php composer.phar require --prefer-dist yiithings/yii2-setting "*"

或将以下内容添加到您的 composer.json 文件的 require 部分：

"yiithings/yii2-setting": "*"

用法

拓展分为包含 yiithings\setting\Setting 组件和 yiithings\setting\Module 模块，yiithings\setting\Setting 组件是必须的，是对配置项进行 CRUD 的统一入口。yiithings\setting\Module 模块是可选的，提供了 Web 端配置页面与控制台命令行，并会设置一些所需属性。通常，我们将组件 ID 设置为 setting，将模块 ID 设置为 settings。

扩展安装后，只需在您的代码中简单使用即可

'components' => [、
    'setting' => [
        'class' => 'yiithings\setting\Setting',
    ]
],
'modules' => [
    'settings' => [
        'class' => 'yiithings\setting\Module',
    ]
],

组件 API 请参阅 Setting Class

模块页面对 AdminLTE 和 Gentelella Alela! 两种主题提供了主题化定制（默认为 Bootstrap）。如果你的应用使用了这两种主题中的一个，可以通过配置 theme 属性来设置主题。

'modules' => [
    'settings' => [
        'class' => 'yiithings\setting\Module',
        'theme' => 'gentelella',
    ]
],

模块使用了 I18N 组件并预置了一些语言的翻译。如果预置翻译没有你所需要的语言或不能满足要求，可自行添加翻译。拓展使用了 yiithings/setting 作为消息分类名。

[
    'i18n' => [
        'translations' => [
            'yiithings/setting' => [
               'class'          => 'yii\i18n\PhpMessageSource',
               'sourceLanguage' => 'en',
               'basePath'       => 'YOU_PATH',
               'fileMap'        => [
                   'yiithings/setting' => 'YOU_PATH',
               ],
           ]
        ]
    ]
]