Download the PHP package owowagency/laravel-settings without Composer
On this page you can find all versions of the php package owowagency/laravel-settings. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download owowagency/laravel-settings
More information about owowagency/laravel-settings
Files in owowagency/laravel-settings
Package laravel-settings
Short Description A package of settings features for the Laravel framework.
License
Informations about the package laravel-settings
Laravel Settings
A package of settings features for the Laravel framework.
Installation
Installing this package can be done easily via the following Artisan command.
Setup
To install all the vendor files you can run the following command.
This will copy all the vendor files, including configuration, migrations and resources. If you wish to only install certain files you can use the command described in the next paragraphs.
Config
If you wish to publish the configuration file, you can use the following command:
Settings
The settings
configuration holds all the values which can be used within the application. Each setting should have a unique key. For setting the key we would recommend using a package like Laravel Enum. Beside the key, we use the following attributes:
title
(default:null
): here you can store a small title of the setting.description
(default:null
): a description about the setting which you might want to display to the user.type
(default:string
): the variable type of the setting (the type should be acceptable by thesettype()
method).default
(default:null
): the default value which will be used if the user hasn't stored the value in the database yet.nullable
(default:true
): indicates if this setting may have thenull
value.
Table
The table_name
configuration holds the value which is being used for the table name. By default, this has been set to settings
, but if you wish to use a different table name you can change it with this configuration value.
Resources
The package uses Laravel its API Resources. We ship the package with one resource, which will return the setting model. If you wish to use a custom resource, you can specify them in this list.
Migrations
If you wish to publish the migrations, you can use the following command:
Routes
To set up all the routes needed for this package you can call the setting macro on the Route facade. By doing so, all the routes which are required by this package will be available to call.
After adding this to one of your routes files (i.e. routes/api.php
), the following two routes will be available.
Index
This route can be used to index all the settings of a user: GET /users/{user}/settings
. This route will always return all configured settings in the settings
config value. Also, values which are not yet stored for the authenticated user. The package will then use the default configured value.
Response
Update
This route can be used to update the given setting values: PATCH /users/{user}/settings
.
Request
Response
Usage
If you want a certain model (we'll use the user model in this example) to have settings you can add the OwowAgency\LaravelSettings\Models\Concerns\HasSettings
trait to the model. First you should add the OwowAgency\LaravelSettings\Models\Concerns\HasSettingsInterface
to the model. Your model could look like this.
Now, to get a certain config value from the user you can do this: