2017 © Pedro Peláez
 

library eloquent-settings

Eloquent Settings allows you to bind key-value pairs to any Laravel Eloquent model. It supports even casting for boolean, float or integer types.

image

rennokki/eloquent-settings

Eloquent Settings allows you to bind key-value pairs to any Laravel Eloquent model. It supports even casting for boolean, float or integer types.

  • Monday, July 30, 2018
  • by rennokki
  • Repository
  • 2 Watchers
  • 49 Stars
  • 159 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 16 Versions
  • 1667 % Grown

The README.md

Laravel Eloquent Settings

CI codecov StyleCI Latest Stable Version Total Downloads Monthly Downloads License, (*1)

Eloquent Settings allows you to bind key-value pairs to any Laravel Eloquent model., (*2)

🤝 Supporting

If you are using one or more Renoki Co. open-source packages in your production apps, in presentation demos, hobby projects, school projects or so, sponsor our work with Github Sponsors. 📦, (*3)

, (*4)

🚀 Installation

Install the package:, (*5)

$ composer require rennokki/eloquent-settings

Publish the config:, (*6)

$ php artisan vendor:publish --provider="Rennokki\Settings\SettingsServiceProvider" --tag="config"

Publish the migrations:, (*7)

$ php artisan vendor:publish --provider="Rennokki\Settings\SettingsServiceProvider" --tag="migrations"

🙌 Usage

You can add the HasSettings trait to any Eloquent model:, (*8)

use Rennokki\Settings\Traits\HasSettings;

class User extends Model {
    use HasSettings;
    ...
}

Adding settings

$user->newSetting('subscribed.to.newsletter', 1);
$user->newSetting('subscribed.to.newsletter', true);

By default, settings' values are stored as string. Later, if you try to get them with cast, they will return the value you have initially stored. If you store 'true' as a string, if you cast it to a boolean, you'll get true., (*9)

If you plan to store it with cast type other than string, you can pass an additional third parameter that can be either string, boolean, bool, int, integer, float or double., (*10)

$user->newSetting('subscribed.to.newsletter', true, 'bool');

Updating settings

Updating settings can be either to values, cast types or both, depending on what has changed., (*11)

$user->updateSetting('subscribed.to.newsletter', false, 'bool');

If you don't specify a cast parameter, it will not change, only the value will change, or viceversa., (*12)

Getting settings & values

You can get the Setting instance, not the value using getSetting():, (*13)

$user->getSetting('subscribed.to.newsletter'); // does not accept a cast

If you plan to get the value, you can use getSettingValue():, (*14)

$user->getSettingValue('subscribed.to.newsletter'); // true, as boolean
$user->getSettingValue('subscribed.to.newsletter', 'int'); // 1, as integer

Remember, when you update or create a new setting, the cast type is stored. By default, next time you don't have to call the cast parameter again because it will cast it the way it was specified on storing., (*15)

$user->newSetting('is.cool', true, 'bool');
$user->getSettingValue('is.cool'); // it returns true as boolean

Getting values of not-known settings keys, you will return null., (*16)

$user->getSettingValue('subscribed.to.weekly.newsletter'); // null

Deleting a setting

Deleting settings from the database can be done using deleteSetting()., (*17)

$user->deleteSetting('subscribed.to.newsletter');

To delete all settings, call deleteSettings()., (*18)

$user->deleteSettings();

🐛 Testing

bash vendor/bin/phpunit, (*19)

🤝 Contributing

Please see CONTRIBUTING for details., (*20)

🔒 Security

If you discover any security related issues, please email alex@renoki.org instead of using the issue tracker., (*21)

🎉 Credits

The Versions

30/07 2018

dev-master

9999999-dev https://github.com/rennokki/eloquent-settings

Eloquent Settings allows you to bind key-value pairs to any Laravel Eloquent model. It supports even casting for boolean, float or integer types.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Alex Renoki

laravel settings eloquent cast key value setting

30/07 2018

2.3.3

2.3.3.0 https://github.com/rennokki/eloquent-settings

Eloquent Settings allows you to bind key-value pairs to any Laravel Eloquent model. It supports even casting for boolean, float or integer types.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Alex Renoki

laravel settings eloquent cast key value setting

28/07 2018

2.3.2

2.3.2.0 https://github.com/rennokki/eloquent-settings

Eloquent Settings is a package that binds key-value pairs for your models.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Alex Renoki

laravel settings eloquent cast key value setting

29/06 2018

2.3.1

2.3.1.0 https://github.com/rennokki/eloquent-settings

Persistent settings, associated with Eloquent Models

  Sources   Download

MIT

The Requires

 

The Development Requires

by Alex Renoki

laravel settings eloquent setting

23/06 2018

2.3.0

2.3.0.0 https://github.com/rennokki/eloquent-settings

Persistent settings, associated with Eloquent Models

  Sources   Download

MIT

The Requires

 

The Development Requires

by Alex Renoki

laravel settings eloquent setting

16/06 2018

2.2.0

2.2.0.0 https://github.com/rennokki/eloquent-settings

Persistent settings, associated with Eloquent Models

  Sources   Download

MIT

The Requires

 

The Development Requires

by Alex Renoki

laravel settings eloquent setting

15/06 2018

2.1.0

2.1.0.0 https://github.com/rennokki/eloquent-settings

Persistent settings, associated with Eloquent Models

  Sources   Download

MIT

The Requires

 

The Development Requires

by Alex Renoki

laravel settings eloquent setting

15/06 2018

2.0.0

2.0.0.0 https://github.com/rennokki/eloquent-settings

Persistent settings, associated with Eloquent Models

  Sources   Download

MIT

The Requires

 

The Development Requires

by Alex Renoki

laravel settings eloquent setting

01/06 2018

1.3.0

1.3.0.0 https://github.com/rennokki/eloquent-settings

Persistent settings, associated with Eloquent Models

  Sources   Download

MIT

The Requires

 

The Development Requires

by Alex Renoki

laravel settings eloquent setting

01/06 2018

dev-unit-tests

dev-unit-tests https://github.com/rennokki/eloquent-settings

Persistent settings, associated with Eloquent Models

  Sources   Download

MIT

The Requires

 

The Development Requires

by Alex Renoki

laravel settings eloquent setting

31/05 2018

1.2.3

1.2.3.0 https://github.com/rennokki/eloquent-settings

Persistent settings, associated with Eloquent Models

  Sources   Download

MIT

by Alex Renoki

laravel settings eloquent setting

31/05 2018

1.2.1

1.2.1.0 https://github.com/rennokki/eloquent-settings

Persistent settings, associated with Eloquent Models

  Sources   Download

MIT

by Alex Renoki

laravel settings eloquent setting

31/05 2018

1.2.2

1.2.2.0 https://github.com/rennokki/eloquent-settings

Persistent settings, associated with Eloquent Models

  Sources   Download

MIT

by Alex Renoki

laravel settings eloquent setting

31/05 2018

1.2.0

1.2.0.0 https://github.com/rennokki/eloquent-settings

Persistent settings, associated with Eloquent Models

  Sources   Download

MIT

by Alex Renoki

laravel settings eloquent setting

30/05 2018

1.1.0

1.1.0.0 https://github.com/rennokki/eloquent-settings

Persistent settings, associated with Eloquent Models

  Sources   Download

MIT

by Alex Renoki

laravel settings eloquent setting

29/05 2018

1.0.0

1.0.0.0 https://github.com/rennokki/eloquent-settings

Persistent settings, associated with Eloquent Models

  Sources   Download

MIT

by Alex Renoki

laravel settings eloquent setting