execut/yii2-settings

Yii2 module for settings managing with CRUD

yii2-settings

Yii2 module for application configuring via administrate crud settings. The module can used both separately and as part of the execut/yii2-cms., _(*1)

Installation

The preferred way to install this extension is through composer., _(*2)

Install

Either run, _(*3)

$ php composer.phar require execut/yii2-settings

or add, _(*4)

"execut/yii2-settings": "dev-master"

to the require section of your composer.json file., _(*5)

Configuration

Add module bootstrap to backend application config:, _(*6)

    'bootstrap' => [
    ...
        'settings' => [
            'class' => \execut\settings\bootstrap\Backend::class,
        ],
    ...
    ],

Add module bootstrap to common application config:, _(*7)

    'bootstrap' => [
    ...
        'settings' => [
            'class' => \execut\settings\bootstrap\Common::class,
        ],
    ...
    ],

Add module bootstrap inside console application config:, _(*8)

    'bootstrap' => [
    ...
        'settings' => [
            'class' => \execut\settings\bootstrap\Console::class,
        ],
    ...
    ],

Apply migrations via yii command:, _(*9)

./yii migrate/up --interactive=0

After configuration, the module should open by paths: settings/backend, _(*10)

Module navigation

You may output navigation of module inside your layout via execut/yii2-navigation:, _(*11)

    echo Nav::widget([
        ...
        'items' => \yii\helpers\ArrayHelper::merge($menuItems, \yii::$app->navigation->getMenuItems()),
        ...
    ]);
    NavBar::end();

    // Before standard breadcrumbs render breadcrumbs and header widget:
echo \execut\navigation\widgets\Breadcrumbs::widget();
echo \execut\navigation\widgets\Header::widget();
echo Breadcrumbs::widget([
    'links' => isset($this->params['breadcrumbs']) ? $this->params['breadcrumbs'] : [],
]);

For more information about execut/yii2-navigation module, please read it documentation, _(*12)

Usage

Settings administration

, _(*13)

Section contains the following columns:, _(*14)

For example, we want to manage the site name. To do this, add a setting with the key site_name:, _(*15)

, _(*16)

On the website we can display this parameter using this line:, _(*17)

<?= \yii::$app->settings->get('company-name') ?>

Increase functionality

For adding more functionality inside module you can create plugin based on interface execut\settings\Plugin and connect it to module via common bootstrap depends config:, _(*18)

    'bootstrap' => [
    ...
        'settings' => [
            'class' => \execut\settings\bootstrap\Common::class,
            'depends' => [
                'modules' => [
                    'settings' => [
                        'plugins' => [
                            'own-plugin' => [
                                'class' => $pluginClass // You plugin class here
                            ],
                        ],
                    ]
                ],
            ],
        ],
    ...
    ],

He has next methods:, _(*19)