PHPackages                             mihdan/wp-oop-settings-api - 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. mihdan/wp-oop-settings-api

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

mihdan/wp-oop-settings-api
==========================

WP-OOP-Settings-API is a Settings API wrapper built with Object Oriented Programming practices.

2.0.0(3y ago)12252[4 issues](https://github.com/mihdan/wp-oop-settings-api/issues)GPL-2.0-or-laterPHPPHP &gt;=7.4

Since Feb 14Pushed 3y ago3 watchersCompare

[ Source](https://github.com/mihdan/wp-oop-settings-api)[ Packagist](https://packagist.org/packages/mihdan/wp-oop-settings-api)[ Fund](https://www.kobzarev.com/donate/)[ RSS](/packages/mihdan-wp-oop-settings-api/feed)WikiDiscussions master Synced 6d ago

READMEChangelogDependencies (8)Versions (7)Used By (0)

[![](https://camo.githubusercontent.com/7ea7a6afe125404382fa918d4d017cc88675139ea8b68baab4173d8e590c44fb/68747470733a2f2f692e696d6775722e636f6d2f675645716674762e6a7067)](https://camo.githubusercontent.com/7ea7a6afe125404382fa918d4d017cc88675139ea8b68baab4173d8e590c44fb/68747470733a2f2f692e696d6775722e636f6d2f675645716674762e6a7067)

WordPress OOP Settings API
==========================

[](#wordpress-oop-settings-api)

[![Tweet for help](https://camo.githubusercontent.com/eba1ee93fae30a79c730b53bfbe0962a448bf15d442369933f598e5e4655fe5c/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f666f6c6c6f772f6d696864616e5f6465762e7376673f7374796c653d736f6369616c266c6162656c3d5477656574253230404d7241686d61644177616973)](https://twitter.com/mrahmadawais/) [![GitHub stars](https://camo.githubusercontent.com/d39a8c4444b54cd74dc4e84a79621986c1fa567bab3eefd98f2d9d320bb970c4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f61686d616461776169732f57502d4f4f502d53657474696e67732d4150492e7376673f7374796c653d736f6369616c266c6162656c3d5374617273)](https://github.com/ahmadawais/WP-OOP-Settings-API/stargazers) [![GitHub followers](https://camo.githubusercontent.com/01f0297caa414adde27ae256b774f6d9eae9f22bcccf43a5c26cf475d837b94f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f6c6c6f776572732f61686d616461776169732e7376673f7374796c653d736f6369616c266c6162656c3d466f6c6c6f77)](https://github.com/ahmadawais?tab=followers) — ☝️ Make sure you ⭐ and 👀 this repository!

> Ever wanted to build custom settings inside your WordPress plugin or theme and didn't like the non-DRY approach for creating custom settings via WordPress API? Well, that's why and when I wrote this OOP Wrapper for WordPress Settings API. 🎊

Documentation
-------------

[](#documentation)

#### Sidebar

[](#sidebar)

```
$wposa->add_sidebar_card(
  [
    'id'    => 'donate',
    'title' => __( 'Enjoyed WPOSA?', 'wposa' ),
    'desc'  => __( 'Please leave us a ★★★★★ rating. We really appreciate your support', 'wposa' ),
  ]
);
```

Screenshots
-----------

[](#screenshots)

[![](https://camo.githubusercontent.com/7afd0a0116e9581b6c41734a246a01dbce0c1c04eb3bd380c2f9bed41f4be8b4/68747470733a2f2f692e696d6775722e636f6d2f4558556f654c5a2e706e67)](https://camo.githubusercontent.com/7afd0a0116e9581b6c41734a246a01dbce0c1c04eb3bd380c2f9bed41f4be8b4/68747470733a2f2f692e696d6775722e636f6d2f4558556f654c5a2e706e67)[![](https://camo.githubusercontent.com/c8faf380d4018e2edb5c3e1e781d63226f758fa1f73c91241742eef0d5d818c0/68747470733a2f2f692e696d6775722e636f6d2f736339383136572e706e67)](https://camo.githubusercontent.com/c8faf380d4018e2edb5c3e1e781d63226f758fa1f73c91241742eef0d5d818c0/68747470733a2f2f692e696d6775722e636f6d2f736339383136572e706e67)[![](https://camo.githubusercontent.com/5a2fbd8ffc68e42f03cd5060e2de9d177ca57e4c91e12926df149573739850b5/68747470733a2f2f692e696d6775722e636f6d2f3053576a6e34412e706e67)](https://camo.githubusercontent.com/5a2fbd8ffc68e42f03cd5060e2de9d177ca57e4c91e12926df149573739850b5/68747470733a2f2f692e696d6775722e636f6d2f3053576a6e34412e706e67)

TODO:
-----

[](#todo)

- Basic Settings Page
- Tabs on Settings Page with JS
- Tabs on Settings Page with JS
- Documentation for code workflow
- Create Field: `text`
- Create Field: `textarea`
- Create Field: `url`
- Create Field: `number`
- Create Field: `checkbox`
- Create Field: `multicheck`
- Create Field: `radio`
- Create Field: `select`
- Create Field: `html`
- Create Field: `wysiwyg`
- Create Field: `file`
- Create Field: `image`
- Create Field: `password`
- Create Field: `color`
- Tutorials
- Blog post
- Documentation
- Re-factor the code with WP Standards
- Re-factor the code into classes

License
-------

[](#license)

Release under GNU GPL v2.0

Credits
-------

[](#credits)

@AhmadAwais, @deviorobert, @MaedahBatool AND @WordPress, @tareq1988, @royboy789, @twigpress, @mihdan

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance13

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity61

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

Recently: every ~283 days

Total

6

Last Release

1150d ago

Major Versions

1.0.4 → 2.0.02023-03-24

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/666732?v=4)[Mikhail Kobzarev](/maintainers/mihdan)[@mihdan](https://github.com/mihdan)

---

Top Contributors

[![robertdevore](https://avatars.githubusercontent.com/u/9917957?v=4)](https://github.com/robertdevore "robertdevore (17 commits)")[![mihdan](https://avatars.githubusercontent.com/u/666732?v=4)](https://github.com/mihdan "mihdan (11 commits)")[![ahmadawais](https://avatars.githubusercontent.com/u/960133?v=4)](https://github.com/ahmadawais "ahmadawais (5 commits)")[![MikeiLL](https://avatars.githubusercontent.com/u/6392263?v=4)](https://github.com/MikeiLL "MikeiLL (1 commits)")[![wonder32](https://avatars.githubusercontent.com/u/5481217?v=4)](https://github.com/wonder32 "wonder32 (1 commits)")

###  Code Quality

Static AnalysisPsalm

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/mihdan-wp-oop-settings-api/health.svg)

```
[![Health](https://phpackages.com/badges/mihdan-wp-oop-settings-api/health.svg)](https://phpackages.com/packages/mihdan-wp-oop-settings-api)
```

PHPackages © 2026

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