WordPress Settings Wrapper

Fluent PHP 8.3 library for the WordPress Settings API — build settings pages without boilerplate.

Full documentation →

Requirements

• PHP 8.3+
• WordPress 6.0+

Installation

composer require rockschtar/wordpress-settings

Quick Start

use Rockschtar\WordPress\Settings\Fields\InputText;
use Rockschtar\WordPress\Settings\Fields\SelectBox;
use Rockschtar\WordPress\Settings\Models\ListItem;
use Rockschtar\WordPress\Settings\Models\Section;
use Rockschtar\WordPress\Settings\Models\SettingsPage;

add_action('rswp_create_settings', function (): void {
    $page = SettingsPage::create('my-plugin-settings')
        ->setPageTitle('My Plugin')
        ->setMenuTitle('My Plugin')
        ->setCapability('manage_options');

    $section = Section::create('my-plugin-general', $page)
        ->setTitle('General');

    InputText::create('my_plugin_api_key')
        ->setLabel('API Key')
        ->setDescription('Your API key.')
        ->setPlaceholder('sk-...')
        ->addToSection($section);

    SelectBox::create('my_plugin_environment')
        ->setLabel('Environment')
        ->addItem(ListItem::create('production', 'Production'))
        ->addItem(ListItem::create('staging', 'Staging'))
        ->addItem(ListItem::create('development', 'Development'))
        ->addToSection($section);

    rswp_register_settings_page($page);
});

Field Types

See the full field reference for all methods and examples.

Show your support

Give a ⭐️ if this project helped you!