PHPackages                             wordpress-phoenix/wordpress-options-builder-class - 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 &amp; Helpers](/categories/utility)
4. /
5. wordpress-phoenix/wordpress-options-builder-class

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

wordpress-phoenix/wordpress-options-builder-class
=================================================

Library that helps you setup theme or plugin options that store data in the database with just a line or two of code

6.0.0(10mo ago)44.6k↓100%8[3 issues](https://github.com/WordPress-Phoenix/wordpress-options-builder-class/issues)[1 PRs](https://github.com/WordPress-Phoenix/wordpress-options-builder-class/pulls)GPL-3.0-or-laterPHP

Since Nov 15Pushed 9mo ago9 watchersCompare

[ Source](https://github.com/WordPress-Phoenix/wordpress-options-builder-class)[ Packagist](https://packagist.org/packages/wordpress-phoenix/wordpress-options-builder-class)[ Docs](https://github.com/WordPress-Phoenix/wordpress-options-builder-class)[ RSS](/packages/wordpress-phoenix-wordpress-options-builder-class/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (3)Versions (48)Used By (0)

WordPress Phoenix Options Panel
===============================

[](#wordpress-phoenix-options-panel)

WordPress options builder class is a library that helps you setup theme or plugin options that store data in the database with just a few lines of code.

### Updated in 5.0

[](#updated-in-50)

- Updated WordPress Coding Standards
- Improved Composer configuration
- Added support for the [.editorconfig standard](https://editorconfig.org)
- Rewrote encryption on the Password field type to use OpenSSL instead of mcrypt
- Removed the Markdown field type
- Refactored library code

Builds protected by CircleCI: [![CircleCI](https://camo.githubusercontent.com/927343b4d563a09c34bdfa795950966e9255cbed74f2b4ab3ce3c8678d0410f7/68747470733a2f2f636972636c6563692e636f6d2f67682f576f726450726573732d50686f656e69782f776f726470726573732d6f7074696f6e732d6275696c6465722d636c6173732e7376673f7374796c653d737667)](https://circleci.com/gh/WordPress-Phoenix/wordpress-options-builder-class)

Table of Contents
-----------------

[](#table-of-contents)

- [Installation](#installation)
- [Upgrading to version 5.x](#upgrading-to-version-5x)
- [Usage](#usage)

Installation
------------

[](#installation)

### Composer style (recommended)

[](#composer-style-recommended)

1. Include in your plugin by creating or adding the following to your composer.json file in the root of the plugin ```
    {
      "require": {
        "WordPress-Phoenix/wordpress-options-builder-class": "^5.0.0"
      }
    }
    ```
2. Confirm that composer is installed in your development enviroment using `which composer`.
3. Open CLI into your plugins root directory and run `composer install`.
4. Confirm that it created the vendor folder in your plugin.
5. In your plugins main file, near the code where you include other files place the following: ```
    if ( file_exists( dirname( __FILE__ ) . 'vendor/autoload.php' ) ) {
      include_once dirname( __FILE__ ) . 'vendor/autoload.php';
    }
    ```

### Manual Installation

[](#manual-installation)

1. Download the most updated copy of this repository from `https://api.github.com/repos/WordPress-Phoenix/wordpress-options-builder-class/zipball`
2. Extract the zip file, and copy the PHP file into your plugin project.
3. Include the `src/class-wordpress-options-panels.php` file in your plugin.

Upgrading to version 5.x
------------------------

[](#upgrading-to-version-5x)

Version 5.0 is a major rewrite of the WordPress Phoenix Options Panel and there are a few required update steps.

- If not using an autoloader, include `src/class-wordpress-options-panels.php` (instead of `wpop-init.php`)
- Reference the `\WPOP\V_5_0\*` namespace instead of `\WPOP\V_4_1\*`
- If you aren't using an autoloader, manually load the class files into memory: ```
    \WPOP\V_5_0\WordPress_Options_Panels::load_files();
    ```
- The Markdown field type has been removed; consider switching to `include_partial` and rendering the markdown through a PHP class of your choosing (WordPress Phoenix Options Panel version 4.x used [erusev/parsedown](https://packagist.org/packages/erusev/parsedown))
- Update your array of `$args` to `new \WPOP\V_5_0\Page( $args, $fields );` to include an `installed_dir_uri` key and value, representing the public URL path to your installation of this library (required to load CSS and JS assets used to style the options panels)

Usage
-----

[](#usage)

- [Get started](https://github.com/WordPress-Phoenix/wordpress-options-builder-class/wiki) at the Wiki describing Panel, Section and Part schemas
- [See a full example](https://github.com/WordPress-Phoenix/wpop-example-panel/) in the WPOP Example Plugin
- [Generate a working copy](https://github.com/WordPress-Phoenix/wordpress-development-toolkit/releases) using the WordPress Development Toolkit and the [Abstract Plugin Base](https://github.com/WordPress-Phoenix/abstract-plugin-base).

###  Health Score

45

—

FairBetter than 92% of packages

Maintenance40

Moderate activity, may be stable

Popularity29

Limited adoption so far

Community24

Small or concentrated contributor base

Maturity76

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~71 days

Recently: every ~403 days

Total

45

Last Release

305d ago

Major Versions

1.5.3 → 2.0.0-beta-12017-11-02

2.9.2 → 3.1.02018-01-29

3.1.2 → 4.12018-05-07

4.1.9 → 5.0.02019-02-08

5.1.1 → 6.0.02025-07-08

### Community

Maintainers

![](https://www.gravatar.com/avatar/ec1a3080eda0958c4ee230c17ed2810daf566d0dd12d9fb31e46610aa1488b4a?d=identicon)[sethcarstens](/maintainers/sethcarstens)

![](https://www.gravatar.com/avatar/6283ea6aacc3f5341a482da506bcbe1f92d5762143f3f7fc2a175b8d119f89ab?d=identicon)[jmarx](/maintainers/jmarx)

---

Top Contributors

[![scarstens](https://avatars.githubusercontent.com/u/1483300?v=4)](https://github.com/scarstens "scarstens (117 commits)")[![chrisvanpatten](https://avatars.githubusercontent.com/u/1231306?v=4)](https://github.com/chrisvanpatten "chrisvanpatten (53 commits)")[![0aveRyan](https://avatars.githubusercontent.com/u/9565066?v=4)](https://github.com/0aveRyan "0aveRyan (15 commits)")[![mosrur](https://avatars.githubusercontent.com/u/866176?v=4)](https://github.com/mosrur "mosrur (14 commits)")[![mlteal](https://avatars.githubusercontent.com/u/3302175?v=4)](https://github.com/mlteal "mlteal (13 commits)")[![vijaykarthickp](https://avatars.githubusercontent.com/u/7450742?v=4)](https://github.com/vijaykarthickp "vijaykarthickp (7 commits)")[![Akash-Raj-ST](https://avatars.githubusercontent.com/u/65654411?v=4)](https://github.com/Akash-Raj-ST "Akash-Raj-ST (6 commits)")[![unnicj17](https://avatars.githubusercontent.com/u/30792115?v=4)](https://github.com/unnicj17 "unnicj17 (5 commits)")[![kimcheung](https://avatars.githubusercontent.com/u/10742780?v=4)](https://github.com/kimcheung "kimcheung (4 commits)")[![johnciacia](https://avatars.githubusercontent.com/u/195966?v=4)](https://github.com/johnciacia "johnciacia (1 commits)")[![tobeycodes](https://avatars.githubusercontent.com/u/3613405?v=4)](https://github.com/tobeycodes "tobeycodes (1 commits)")[![debaryadas](https://avatars.githubusercontent.com/u/16287281?v=4)](https://github.com/debaryadas "debaryadas (1 commits)")[![HILAYTRIVEDI](https://avatars.githubusercontent.com/u/52625748?v=4)](https://github.com/HILAYTRIVEDI "HILAYTRIVEDI (1 commits)")[![debaryatimeinc](https://avatars.githubusercontent.com/u/18283488?v=4)](https://github.com/debaryatimeinc "debaryatimeinc (1 commits)")

---

Tags

composerwordpresswordpress-developmentwordpress-options-builderwp-multisitehelperwordpressutilitysite-options

### Embed Badge

![Health badge](/badges/wordpress-phoenix-wordpress-options-builder-class/health.svg)

```
[![Health](https://phpackages.com/badges/wordpress-phoenix-wordpress-options-builder-class/health.svg)](https://phpackages.com/packages/wordpress-phoenix-wordpress-options-builder-class)
```

###  Alternatives

[samrap/acf-fluent

A fluent interface for the Advanced Custom Fields WordPress plugin

28656.0k4](/packages/samrap-acf-fluent)[bocharsky-bw/file-naming-resolver

A lightweight library which helps to resolve a file/directory naming of uploaded files using various naming strategies.

1134.9k](/packages/bocharsky-bw-file-naming-resolver)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
