carawebs/wp-plugin-settings

Generate WordPress plugin settings from a config file.

Generate WordPress Settings

This package is in development and is not suitable for production yet., _(*1)

Configuring plugin settings with the WordPress settings API can be a bit tricky., _(*2)

It's difficult to keep your code DRY, and the relationship between the different functions can be tricky to set up., _(*3)

It makes sense to register settings the WordPress way because your code may well have to play nicely with other developers who you're never going to meet. It also has to robust enough to survive future WordPress upgrades., _(*4)

The downside of this is that you need to manage the relationship between register_setting(), add_settings_field(), add_settings_section(), add_settings_field(), settings_fields(), do_settings_sections() etc...just to output a simple form that saves a value to the WP options table., _(*5)

This package is a first stab at abstracting the settings setup. You just pass in a config file which returns a PHP array. This is used to configure settings., _(*6)

Usage

$optionsPageConfig = dirname(__FILE__) . '/options-page-config.php';
$menuPageConfig = dirname(__FILE__) . '/menu-page-settings-config.php';
// Settings Page
$optionsPage = new SettingsController;
$optionsPage->setOptionsPageArgs($optionsPageConfig)->initOptionsPage();

TODO

Build a fluent interface so you can add settings pages like:, _(*7)

<?php
$settingsPage = new Carawebs\Settings\SettingsPage($pageData);
$settingsPage->newTab('Social Media')->withSection($sectionData)->withFields($fieldsData);