PHPackages                             kyle-niemiec/wp-plugin-framework - 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. [Framework](/categories/framework)
4. /
5. kyle-niemiec/wp-plugin-framework

ActiveLibrary[Framework](/categories/framework)

kyle-niemiec/wp-plugin-framework
================================

A modular framework for building maintainable WordPress plugins with Composer and CLI scaffolding.

1.2.3(3mo ago)442↓86.7%1GPL-3.0PHP

Since Jan 21Pushed 3mo agoCompare

[ Source](https://github.com/kyle-niemiec/wp-plugin-framework)[ Packagist](https://packagist.org/packages/kyle-niemiec/wp-plugin-framework)[ RSS](/packages/kyle-niemiec-wp-plugin-framework/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (6)Versions (5)Used By (1)

WordPress Plugin Framework (WPPF)
=================================

[](#wordpress-plugin-framework-wppf)

[![Documentation](https://camo.githubusercontent.com/8ce7755a97e7f759a6904a1abf9670b76b7b06031bc0e897d8cb86a4a62631f5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f63732d6f6e6c696e652d626c7565)](https://wp-plugin-framework.codeflower.io/)

The WordPress Plugin Framework (WPPF) is the culmination of a few years of my hard work building WordPress plugins and the need for a stricter organization than what examples I had seen. It is built to automate boilder-plate code of registering post types and meta boxes, enqueuing assets, separating administrative functionality, and more. While a set of classes manages many of the native WordPress function calls, developers are more free to define "modules", which describe parts of a plugin and focus on assigning functionality to actions and filters to build out custom functionality. Best practices for [WordPress PHP Coding Standards](https://developer.wordpress.org/coding-standards/wordpress-coding-standards/php/) are encouraged through the use of file names, variable conventions, whitespace, and more.

Quick Example
-------------

[](#quick-example)

A minimal WPPF module might look like this:

```
class My_API extends Module
{
    public static function construct(): void {
        add_action( 'rest_api_init', [ __CLASS__, 'init' ] );
    }

    public static function init(): void {
        register_rest_route( ... )
    }
}
```

Example Plugin
--------------

[](#example-plugin)

If you'd like to see how WPPF is used in a real project, check out the **[WPPF Test Plugin](https://github.com/kyle-niemiec/wppf-test-plugin)**.

It demonstrates:

- custom post types
- structured post meta with validation
- admin modules
- WooCommerce email integration
- upgrade schemas

Features
--------

[](#features)

- Set of object-oriented classes abstracting WordPress concepts with accessible methods.
- Map-backed PSR-4 autoloader separating projects into functional "modules".
- CLI-generated scaffolding for plugins, post types, meta, screens, and meta boxes.
- Versioned framework namespaces with backward compatibility support.
- Assortment of tools for productivity including:
    - Template loading with variable support.
    - Admin notice messaging system.
    - Upgrade actions for specific plugin versions.
    - CRON-based, lightweight action scheduler.

Requirements
------------

[](#requirements)

- WordPress development environment
- Composer for installing the framework

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

[](#installation)

1. Create a plugin project folder with a name matching your plugin slug. (e.g. "My Test Plugin" has the slug "my-test-plugin").

```
mkdir my-test-plugin ; cd my-test-plugin
```

2. Install the framework via Composer from inside the folder you just created:

```
composer require kyle-niemiec/wp-plugin-framework
```

3. Install the framework’s dev dependencies (required for the CLI):

```
cd vendor/kyle-niemiec/wp-plugin-framework
composer install --dev
cd ../../../
```

4. Run the CLI using the vendor-packaged binary

```
vendor/bin/wppf list
```

CLI Commands
------------

[](#cli-commands)

Common scaffolding commands (run from your plugin root):

- `make:plugin` — create the main plugin file
- `make:plugin-admin` — create an admin module class
- `make:post-type` — create a custom post type class
- `make:post-meta` — create a post meta class
- `make:post-screen` — create a post screen class
- `make:meta-box` — create a meta box class + template

License
-------

[](#license)

GPL-3.0. See `license.txt`.

Contributing
------------

[](#contributing)

Issues and PRs are welcome. Please follow the project and WordPress PHP Coding Standards when contributing.

WPPF Ecosystem
--------------

[](#wppf-ecosystem)

This project is part of the WPPF ecosystem:

[WordPress Plugin Framework (WPPF)](https://github.com/kyle-niemiec/wp-plugin-framework) – Core plugin architecture framework

[WPPF Test Plugin](https://github.com/kyle-niemiec/wppf-test-plugin) – Example project demonstrating a implementation of a plugin using WPPF.

[WP Plugin Update Server](https://github.com/kyle-niemiec/wp-plugin-update-server) – Self-hosted WordPress plugin update infrastructure with GUI management.

[WPPF Update Helper](https://github.com/kyle-niemiec/wppf-update-helper) – Simple integration layer for the WP Plugin Update Server.

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance78

Regular maintenance activity

Popularity13

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

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

Total

4

Last Release

117d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/50939562?v=4)[Kyle Niemiec](/maintainers/kyle-niemiec)[@kyle-niemiec](https://github.com/kyle-niemiec)

---

Top Contributors

[![kyle-niemiec](https://avatars.githubusercontent.com/u/50939562?v=4)](https://github.com/kyle-niemiec "kyle-niemiec (120 commits)")

---

Tags

cli-toolcomposermodular-architectureobject-orientedphpplugin-frameworkwordpresswordpress-developmentwordpress-pluginwppf

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/kyle-niemiec-wp-plugin-framework/health.svg)

```
[![Health](https://phpackages.com/badges/kyle-niemiec-wp-plugin-framework/health.svg)](https://phpackages.com/packages/kyle-niemiec-wp-plugin-framework)
```

###  Alternatives

[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k39.6M299](/packages/laravel-dusk)[nineinchnick/edatatables

Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin

173.2k](/packages/nineinchnick-edatatables)[link-cloud/fast-hyperf

LinkCloud Fast Hyperf

241.2k1](/packages/link-cloud-fast-hyperf)

PHPackages © 2026

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