Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yiier/yii2-target-setting
https://github.com/yiier/yii2-target-setting
yii2-extension yii2-settings
Last synced: 10 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/yiier/yii2-target-setting
- Owner: yiier
- Created: 2019-12-19T10:14:40.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2021-01-18T03:40:46.000Z (almost 4 years ago)
- Last Synced: 2024-04-14T09:58:38.241Z (7 months ago)
- Topics: yii2-extension, yii2-settings
- Language: PHP
- Size: 9.77 KB
- Stars: 2
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Target Settings For Yii2
======================
Target Settings For Yii2
[](https://packagist.org/packages/yiier/yii2-target-setting)
[](https://packagist.org/packages/yiier/yii2-target-setting)
[](https://packagist.org/packages/yiier/yii2-target-setting)
[](https://packagist.org/packages/yiier/yii2-target-setting)
Installation
------------
The preferred way to install this extension is through [composer](http://getcomposer.org/download/).
Either run
```
php composer.phar require --prefer-dist yiier/yii2-target-setting "*"
```
or add
```
"yiier/yii2-target-setting": "*"
```
to the require section of your `composer.json` file.
Configuration
------
### Database Migrations
Before usage this extension, we'll also need to prepare the database.
```
php yii migrate --migrationPath=@yiier/targetSetting/migrations/
```
### Module Setup
To access the module, you need to configure the modules array in your application configuration:
```php
'modules' => [
'targetSetting' => [
'class' => 'yiier\targetSetting\Module',
],
],
```
Component Setup
To use the Setting Component, you need to configure the components array in your application configuration:
```php
'components' => [
'targetSetting' => [
'class' => 'yiier\targetSetting\TargetSetting',
],
],
```
Usage
-----
```php
targetSetting;
$value = $setting->get('key');
$value = $setting->get('key', User::tableName(), Yii::$app->user->id);
$setting->set('key', 125.5);
$setting->set('key', 125.5, User::tableName(), Yii::$app->user->id);
$setting->set('key', false, User::tableName(), Yii::$app->user->id, 'Not allowed Update Post');
$setting->set('key', false, '', 0, 'Not allowed Update Post');
// Checking existence of setting
$setting->has('key');
$setting->has('key', User::tableName(), Yii::$app->user->id);
// Activates a setting
$setting->activate('key');
$setting->activate('key', User::tableName(), Yii::$app->user->id);
// Deactivates a setting
$setting->deactivate('key');
$setting->deactivate('key', User::tableName(), Yii::$app->user->id);
// Removes a setting
$setting->remove('key');
$setting->remove('key', User::tableName(), Yii::$app->user->id);
// Removes all settings
$setting->removeAll();
$setting->removeAll(User::tableName(), Yii::$app->user->id);
// Get's all values in the specific section.
$setting->getAllByTarget(User::tableName(),Yii::$app->user->id);
$setting->invalidateCache(); // automatically called on set(), remove();
$setting->invalidateCache(User::tableName()); // automatically called on set(), remove();
```
TargetSettingAction
-----
To use a custom settings form, you can use the included `TargetSettingAction`.
1. Create a model class with your validation rules.
2. Create an associated view with an `ActiveForm` containing all the settings you need.
3. Add `yiier\targetSetting\targetSettingAction` 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:
```php
'Site Name',
'siteDescription' => 'Site Description'
];
}
}
```
### Views:
```php
'site-settings-form']); ?>
= $form->field($model, 'siteName') ?>
= $form->field($model, 'siteDescription') ?>
= Html::submitButton('Save', ['class' => 'btn btn-success']) ?>
```
### Controller:
```php
public function actions()
{
return [
//....
'site-settings' => [
'class' => TargetSettingAction::class,
'modelClass' => 'app\models\SiteForm',
//'scenario' => 'site', // Change if you want to re-use the model for multiple setting form.
//'targetType' => 'company', // By default use ''
//'targetId' => 1, // By default use \Yii::$app->user->id
'viewName' => 'site-settings', // The form we need to render
'successMessage' => '保存成功'
],
//....
];
}
```
Reference
-----
- [yii2mod/yii2-settings](https://github.com/yii2mod/yii2-settings)
- [phemellc/yii2-settings](https://github.com/phemellc/yii2-settings)