Changelog

• Add load_missing() method for eager loading data only if missing loading the relation

Full Changelog: v1.0.0...v1.0.1

Themeum Framework 1.0.0

The first stable release of themeum/framework — an elegant PHP library for building WordPress plugins with a Laravel-inspired developer experience.

Requirements: PHP 7.4+ · WordPress 5.0+ · Composer · WP-CLI
License: GPL-2.0-or-later

Highlights

• IoC container and application kernel with service providers and facades
• Fluent REST API routing with middleware and dependency injection
• Query builder and active-record ORM with relationships and eager loading
• Schema builder, migrations, and database seeders
• Validation engine with 40+ built-in rules
• Background job scheduler with WordPress cron integration
• Native WordPress hook subscribers and admin helpers
• WP-CLI scaffolding and database commands
• Collections, filesystem utilities, and PHP polyfills

Application Kernel

• Service container with singleton bindings, aliases, tagging, and reflection-based DI
• Configurable paths for app/, bootstrap/, config/, database/, and resources/
• Development mode and plugin prefix support
• 30+ global helpers: app(), config(), response(), request(), collection(), user(), is_rest_request(), and more

HTTP & REST API

• Fluent Route registrar (GET, POST, PUT, PATCH, DELETE)
• Route groups with shared middleware, prefixes, and namespaces
• Controller binding with automatic container resolution
• Request abstraction with sanitization, validation, and file uploads
• JSON response helpers and structured API exception handling
• HTTP client with multipart stream support

Database

Query Builder

• Fluent SQL with joins, subqueries, aggregates, pagination, and chunking

ORM

• Active-record Model with casting, guards, and timestamps
• Relationships: BelongsTo, HasOne, HasMany, BelongsToMany
• Eager loading and dedicated query Collection

Migrations

• Schema builder with foreign key support
• Migration up/down lifecycle with history tracking
• Seeders for initial and test data

Validation

40+ built-in rules across type, comparison, format, presence, database, and WordPress-specific checks. Custom rules via the Rule contract. Form requests scaffoldable via WP-CLI.

Background Jobs

Queue-based scheduler with deferred dispatch, batch processing, stuck-job recovery, async worker authentication, and WordPress cron integration.

WordPress Integration

• Hook subscribers via config/hooks.php
• REST API registration on rest_api_init
• Admin menu, user/meta wrappers, and prefix-aware options
• Capability and menu type constants

WP-CLI Commands

Also Included

• Facades: DB, Schema, Http, Guard, Log, Event, Option, Date, File, Command
• Discovery: auto-registration of event listeners and authorization policies
• Filesystem: file utilities and uploaded file handling
• 24 contracts for extensibility without modifying core

Installation

composer require themeum/framework