sinclairt/settingable

Store settings for an app or resource in the database

1.0.6 2017-03-29 12:25 UTC

This package is not auto-updated.

Last update: 2024-12-22 06:00:33 UTC


README

Installation

  • Run composer require sinclairt/settable.
  • Register Sinclair\Settable\SettableServiceProvider::class in config\app.php inside the providers array.
  • Run composer dump-autoload
  • Run php artisan vendor:publish. This wil publish the migration for the settings.
  • Run php artisan migrate

Usage

Settings can be global or resource specific, for global settings, the $myObject in the examples below can be omitted or set to null, otherwise include the object whose setting you need.

Get

Shorthand: setting('some_key') will return the 'some_key' value. This will only return global settings, use the alternative method for resource settings

Alternative: app('Settable')->get('some_key', $myObject, 'my_default') or setting()->get(...)

It will check whether the value is a callback and return the value of the callback.

Set

Shorthand: setting(['some_key', 'some_value', $myObject]) will set the 'some_key' key to 'some_value' and return boolean.

Alternative: app('Settable')->set('some_key', 'my_value', $myObject) or setting()->set(...)

Exists

app('Settable')->exists('some_key', $myObject) or setting()->exists(...)returns boolean