Packages

Introduction

The boilerplate is thin. Almost everything documented here comes from four Composer packages, all installed as normal dependencies and namespace-prefixed at build time:

Package	Provides	Documented in
bitapps/wp-kit	Router, Request, Response, middleware plumbing, hooks, shortcodes, migrations, HTTP client, helpers	The Basics, HTTP Client, Helpers
bitapps/wp-database	ActiveRecord ORM, query builder, schema builder over $wpdb	Database
bitapps/wp-validator	Validation rules and sanitizers	Validation
bitapps/wp-telemetry	Opt-in usage reporting and deactivation feedback	Telemetry

{
  "require": {
    "php": ">=8.0",
    "bitapps/wp-kit": "^2.0",
    "bitapps/wp-database": "^2.0",
    "bitapps/wp-validator": "^1",
    "bitapps/wp-telemetry": "^0"
  }
}

Namespace prefixing

Dependencies are prefixed at build time so two plugins shipping different versions of the same package cannot collide. That is why every import from a package carries a Deps\ segment:

use YourPlugin\Deps\BitApps\WPKit\Http\Response;
use YourPlugin\Deps\BitApps\WPDatabase\Model;
use YourPlugin\Deps\BitApps\WPValidator\Rule;
use YourPlugin\Deps\BitApps\WPTelemetry\Telemetry\Telemetry;

Your own classes are not prefixed:

use YourPlugin\HTTP\Controllers\TagController;
use YourPlugin\Model\Tag;

note

The Deps\ segment is generated. Import the prefixed path in plugin code, but read the packages' own source and issues under their real namespaces — BitApps\WPKit\....

wp-kit

The framework layer. Beyond HTTP, it carries:

Namespace	Contents
Http\Router	Route, routers, route registration
Http\Request	The request object and validation entry point
Http\Response	The response envelope
Http\Client	Outbound HTTP client
Http\Detection	ClientIpResolver, UserAgent — see Client IP
Container	IoC container and service providers
Settings	Typed settings schema and repository
Cache	Cache stores and facade
Cron	WP-Cron scheduler
Helpers	Arr, JSON, Slug, DateTimeHelper
Hooks	Action and filter wrappers
Shortcode	Shortcode registration
Migration	Migration base class and runner
Utils\Capabilities	Capability checks
Configs\JsonConfig	JSON decode behavior for the kit
Installer	Activation and uninstall wiring

wp-database

An ActiveRecord ORM and fluent query builder over $wpdb. Models map to tables, results hydrate into a Collection, and every value is bound through $wpdb->prepare(). See Database.

wp-validator

Rule-based validation with WordPress sanitizers built in. Reached through $request->validate() rather than constructed directly. See Validation.

wp-telemetry

Consent UI, weekly usage reports and an optional deactivation-feedback dialog. The plugin supplies the receiving server and privacy links, and can filter the payload before it is sent. See Telemetry.

Starter template

wp-plugin-starter scaffolds a plugin with this architecture already wired, and its wp-kit CLI generates controllers, models and migrations. See Installation for requirements and setup.