PHPackages thoughtful-web/settings-page-wp - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. thoughtful-web/settings-page-wp ActiveLibrary[Utility & Helpers](/categories/utility) thoughtful-web/settings-page-wp =============================== WordPress Settings page generator and validator released as free open source software under GNU GPL-2.0+ License v1.0.0(4y ago)5114GPL-2.0-or-laterPHPPHP >=7.3.5 Since Jan 16Pushed 3y ago1 watchersCompare [ Source](https://github.com/thoughtful-web/settings-page-wp)[ Packagist](https://packagist.org/packages/thoughtful-web/settings-page-wp)[ Docs](https://github.com/thoughtful-web/settings-page-wp)[ RSS](/packages/thoughtful-web-settings-page-wp/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (2)Versions (20)Used By (0) Create Settings Pages for WordPress =================================== [](#create-settings-pages-for-wordpress) This PHP library provides a quick, easy way to add a settings page to your plugin or theme. One configuration file defines both your settings and the page that manages them. Table of Contents ----------------- [](#table-of-contents) 1. [Features](#features) 2. [Requirements](#installation) 3. [Quick Start](#quick-start) 4. [Documentation](#documentation) 5. [Contributing](#contributing) Features -------- [](#features) 1. Settings page generation from a configuration file (\*.php or \*.json). 2. Validation on the server by default. 3. No external libraries beyond WordPress's Iris library for color fields. 4. Supports these form field types: 1. Checkboxes 2. Color 3. Email 4. Number 5. Phone 6. Radio 7. Select 8. Text 9. Textarea 10. URL 11. WP Editor Requirements ------------ [](#requirements) ### System Requirements [](#system-requirements) 1. WordPress 5.4 and above. 2. PHP 7.3.5 and above. ### Installation Requirements [](#installation-requirements) If you are familiar with the command line, you may install it using [Composer](https://getcomposer.org) or Git. Otherwise, you may [download a release from Github](https://github.com/thoughtful-web/settings-page-wp/releases). In any case, this library must exist two directory levels below the plugin or theme's root directory. Example: *./vendor/thoughtful-web/settings-page-wp/*. Quick Start ----------- [](#quick-start) *Note: For full specification details on the configuration file values and other possible locations for a configuration file, see here: [docs/config-file.md](./docs/config-file.md)* **Step 1** > Download the composer module. ``` $ composer require thoughtful-web/settings-page-wp ``` **Step 2** Include the library in your plugin or theme using the Composer autoloader: ``` require __DIR__ . '/vendor/autoload.php; new \ThoughtfulWeb\SettingsPageWP\Page(); ``` **Step 3** Copy the [example configuration file](./config/thoughtful-web/settings.example.php) to your plugin or theme's directory at `./config/thoughtful-web/settings.php`. **Step 4** Visit your new settings page at and fill it in as you wish. **Step 5** Retrieve an option from the database using WordPress's [`get_option()`](https://developer.wordpress.org/reference/functions/get_option/) function: ``` $the_option = get_option( 'unique_text_field' ); ``` Documentation ------------- [](#documentation) 1. [Configuration File Reference](./docs/config-file.md) 2. [Field Configuration Reference](./docs/field-configuration.md) 3. [Action and Filter Reference](./docs/action-and-filter-reference.md) 4. [Roadmap](./docs/roadmap.md) 5. WordPress Developer Reference: [Options API](https://developer.wordpress.org/plugins/settings/options-api/) Contributing ------------ [](#contributing) I welcome questions and discussion and have opened up Github's features to create a space for this: . If you find an issue, please report it here: . I am currently only accepting pull requests for security improvements. Please see the [contribution guidelines](./Contributing.md) for details. [Back to top](#introduction) --- *Free open source software under the GNU GPL-2.0+ License.* *Copyright Zachary Kendall Watkins 2021-2022.* ### Health Score 26 — LowBetter than 43% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity14 Limited adoption so far Community7 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~2 days Total 17 Last Release 1548d ago Major Versions v0.9.11 → v1.0.02022-02-19 ### Community Maintainers ![](https://www.gravatar.com/avatar/bd69efd46f5b1aba91a4655129e4e5355ff92558c8f3a25105b45d24cfaa96a3?d=identicon)[zachwatkins](/maintainers/zachwatkins) --- Top Contributors [![ZachWatkins](https://avatars.githubusercontent.com/u/3458875?v=4)](https://github.com/ZachWatkins "ZachWatkins (476 commits)") --- Tags composerphpwordpresswordpressSettingsoptionssettings page ### Code Quality Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/thoughtful-web-settings-page-wp/health.svg) ``` [![Health](https://phpackages.com/badges/thoughtful-web-settings-page-wp/health.svg)](https://phpackages.com/packages/thoughtful-web-settings-page-wp) ``` ### Alternatives [graste/params Array wrapper that eases the retrieval of values. Has parameters, options and settings and traits for inclusion in other libraries. 107.0k](/packages/graste-params) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)