Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/johnpbloch/decisions
Not options
https://github.com/johnpbloch/decisions
Last synced: about 2 months ago
JSON representation
Not options
- Host: GitHub
- URL: https://github.com/johnpbloch/decisions
- Owner: johnpbloch
- License: mit
- Created: 2016-03-07T02:10:31.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2016-03-08T15:23:42.000Z (almost 9 years ago)
- Last Synced: 2024-07-31T20:37:58.341Z (5 months ago)
- Language: PHP
- Size: 9.77 KB
- Stars: 10
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - johnpbloch/decisions - Not options (PHP)
README
# Decisions
Define values in a JSON file and they will override corresponding option values from the database. ALWAYS.
## Requirements
- PHP 5.3
- Sorry
- Not sorry.
## Usage
You REALLY should use this as a must-use plugin, but that would require some know-how and extra setup. If you don't know how MU plugins work or how to get this set up as one, maybe you don't really need this plugin? Or you might want to better understand why you need it?
By default, this will look for a configuration file in `ABSPATH . '.decisions.json'`. You can change this location in your config file thusly:
```php
define( 'JPB\Decisions\DECISIONS', 'wherever/you/want' );
```
Any options you want to be set by default go into the `standard` hash:
```json
{
"standard": {
"blogname": "Super Serial Blog Name",
"admin_email": "[email protected]"
}
}
```
In a multisite network, you can add or override standard options with a site specific hash. The site options should be keyed by site domain + site path with slashes and protocol trimmed (so `http://example.com/subsite/` becomes `example.com/subsite`). Site-specific options go under the `sites` key:
```json
{
"sites": {
"example.com/subsite": {
"admin_email": "[email protected]"
},
"something-else.com/multinetwork": {
"omgwat": "Still works"
}
}
}
```
In multisite you can also add network-wide options using the `network` hash:
```json
{
"network": {
"auth_policy": "Gandalf"
}
}
```
JSON gets decoded as associative arrays rather than objects. If you need an object, you can serialize the data and store the serialized string directly. All values get passed through `maybe_unserialize` before use.
## Qs I Think Will Be FA'ed
#### JSON? Y U NO USE YAML/RAML/XML/LOLSPEAK?
PHP has core JSON decoding. Ain't nobody got time for userland libraries.
#### What about options fetched before this plugin runs?
I can't really help you there. That falls well outside the 80/20 rule. Maybe set the DB value directly and then short-circuit any attempt to update that key?
#### Do you?
I did.
## License
[MIT](https://github.com/johnpbloch/decisions/blob/master/LICENSE)