Skip to content

tsaoko/yii2-settings

This branch is 91 commits behind phemellc/yii2-settings:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

186a712 · Mar 3, 2016

History

72 Commits
Oct 16, 2014
Dec 16, 2015
Feb 22, 2016
Nov 26, 2015
Feb 23, 2016
Feb 22, 2016
Jun 18, 2014
Dec 16, 2015
Feb 3, 2016
Nov 26, 2015
Nov 26, 2015

Repository files navigation

Yii2 Settings

Yii2 Database settings

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist pheme/yii2-settings "*"

or add

"pheme/yii2-settings": "*"

to the require section of your composer.json file.

Subsequently, run

./yii migrate/up --migrationPath=@vendor/pheme/yii2-settings/migrations

in order to create the settings table in your database.

Usage

There are 2 parts to this extension. A module and a component. The module provides a simple GUI to edit your settings. The component provides a way to retrieve and save settings programmatically.

Add this to your main configuration's modules array

'modules' => [
    'settings' => [
        'class' => 'pheme\settings\Module',
        'sourceLanguage' => 'en'
    ],
    ...
],

Add this to your main configuration's components array

'components' => [
    'settings' => [
        'class' => 'pheme\settings\components\Settings'
    ],
    ...
]

Typical component usage

$settings = Yii::$app->settings;

$value = $settings->get('section.key');

$value = $settings->get('key', 'section');

$settings->set('section.key', 'value');

$settings->set('section.key', 'value', null, 'string');

$settings->set('key', 'value', 'section', 'integer');

// Automatically called on set();
$settings->clearCache();

SettingsAction

To use a custom settings form, you can use the included SettingsAction.

  1. Create a model class with your validation rules.
  2. Create an associated view with an ActiveForm contain all the settings you need.
  3. Add pheme\settings\SettingsAction to the controller's actions.

The settings will be stored in section taken from the form name, with the key being the field name.

Model:

class Site extends Model {
	public $siteName, $siteDescription;
	public function rules()
	{
		return [
			[['siteName', 'siteDescription'], 'string'],
		];
	}
	
	public function fields()
	{
	        return ['siteName', 'siteDescription'];
	}
	
	public function attributes()
	{
	        return ['siteName', 'siteDescription'];
	}
}

Views:

<?php $form = ActiveForm::begin(['id' => 'site-settings-form']); ?>
<?= $form->field($model, 'siteName') ?>
<?= $form->field($model, 'siteDescription') ?>

Controller:

function actions(){
   return [
   		//....
            'site-settings' => [
                'class' => 'pheme\settings\SettingsAction',
                'modelClass' => 'app\models\Site',
                //'scenario' => 'site',	// Change if you want to re-use the model for multiple setting form.
                'viewName' => 'site-settings'	// The form we need to render
            ],
        //....
    ];
}

About

Yii2 Settings Module

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 100.0%