Skip to content
Model Settings for your Laravel app
PHP
Branch: master
Clone or download
glorand Update README.md (#29)
* Update README.md
* Refactor
Latest commit 79a2f0a Oct 15, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config Refactor (#28) Oct 14, 2019
src Update README.md (#29) Oct 15, 2019
stubs Develop (#3) Mar 20, 2019
tests Refactor (#28) Oct 14, 2019
.gitignore Has Table and Field traits Jan 7, 2019
.scrutinizer.yml Redis Based Settings (#24) Sep 17, 2019
.styleci.yml Has Table and Field traits Jan 7, 2019
.travis.yml Redis Based Settings (#24) Sep 17, 2019
CHANGELOG.md Refactor (#28) Oct 14, 2019
CONTRIBUTING.md Has Table and Field traits Jan 7, 2019
LICENSE Initial commit Dec 28, 2018
README.md Update README.md (#29) Oct 15, 2019
composer.json Refactor (#28) Oct 14, 2019
phpunit.xml.dist Redis Based Settings (#24) Sep 17, 2019

README.md

laravel

Model Settings for your Laravel app

Latest Stable Version Total Downloads Build Status Software License
StyleCI Scrutinizer Code Quality Scrutinizer Code Coverage

The package requires PHP 7.1.3+ and follows the FIG standards PSR-1, PSR-2 and PSR-4 to ensure a high level of interoperability between shared PHP.

Bug reports, feature requests, and pull requests can be submitted by following our Contribution Guide.

Table of contents

Installation

$ composer require glorand/laravel-model-settings
{
    "require": {
        "glorand/laravel-model-settings": "^3.0"
    }
}

Env (config) variables (.env file)

Default name for the settings field - when you use the HasSettingsField

MODEL_SETTINGS_FIELD_NAME=settings

Default name for the settings table - when you use the HasSettingsTable

MODEL_SETTINGS_TABLE_NAME=model_settings

Updating your Eloquent Models

Your models should use the HasSettingsField or HasSettingsTable trait.

Option 1 - HasSettingsField trait

Run the php artisan model-settings:model-settings-field in order to create a migration file for a table.
This command will create a json field (default name settings, from config) for the mentioned table.

You can choose another than default, in this case you have to specify it in you model.

public $settingsFieldName = 'user_settings';

Complete example:

use Glorand\Model\Settings\Traits\HasSettingsField;

class User extends Model
{
    use HasSettingsField;
    
    //define only if you select a different name from the default
    public $settingsFieldName = 'user_settings';  

}

Option 2 - HasSettingsTable trait

Run before the command php artisan model-settings:model-settings-table.
The command will copy for you the migration class to create the table where the setting values will be stored.
The default name of the table is model_settings; change the config or env value MODEL_SETTINGS_TABLE_NAME if you want to rewrite the default name (before you run the command!)

use Glorand\Model\Settings\Traits\HasSettingsTable;

class User extends Model
{
    use HasSettingsTable;
}

Option 3 - HasSettingsRedis trait

use Glorand\Model\Settings\Traits\HasSettingsRedis;

class User extends Model
{
    use HasSettingsRedis;
}

Default settings

use Glorand\Model\Settings\Traits\HasSettingsTable;

class User extends Model
{
    public $defaultSettings = [
        'key_1' => 'val_1',
    ];
}

Usage

$user = App\User::first();

Get all model's settings

$user->settings()->all();
$user->settings()->get();

Get a specific setting

$user->settings()->get('some.setting');
$user->settings()->get('some.setting', 'default value');
//multiple
$user->settings()->getMultiple(
	[
		'some.setting_1',
		'some.setting_2',
	],
	'default value'
);

Add / Update setting

$user->settings()->apply((array)$settings);
$user->settings()->set('some.setting', 'new value');
$user->settings()->update('some.setting', 'new value');
//multiple
$user->settings()->setMultiple([
	'some.setting_1' => 'new value 1',
	'some.setting_2' => 'new value 2',
]);

Check if the model has a specific setting

$user->settings()->has('some.setting');

Remove a setting from a model

$user->settings()->delete('some.setting');
//multiple
$user->settings()->deleteMultiple([
	'some.setting_1',
	'some.setting_2',
]);
//all
$user->settings()->clear();

Persistence for settings field

In case of field settings the auto-save is configurable.

The default value is true

  • Use an attribute on model
protected $persistSettings = true; //boolean
  • Environment (.env) variable
MODEL_SETTINGS_PERSISTENT=true
  • Config value - model settings config file
'settings_persistent' => env('MODEL_SETTINGS_PERSISTENT', true),

If the persistence is false you have to save the model after the operation.

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

License

The MIT License (MIT). Please see LICENSE for more information.

Related Stuff

You can’t perform that action at this time.