PHPNomad WordPress Plugin

A comprehensive bundle of PHPNomad packages providing modular PHP components for WordPress including core utilities, database abstraction, REST API, templating, events, and more.

What It Does

This plugin serves as a centralized bundle that loads all PHPNomad framework packages into WordPress. It provides a complete set of modern PHP development tools and abstractions specifically designed for WordPress plugin and theme development.

Requirements

• PHP 8.2 or higher
• WordPress 6.5 or higher (for Plugin Dependencies feature)

Dependencies

Core Foundation

• phpnomad/core - Core interfaces and base functionality for the PHPNomad framework
• phpnomad/framework - Main framework orchestration and bootstrapping
• phpnomad/utils - Common utility functions and helpers (includes Arr and Str helpers)

Configuration & Loading

• phpnomad/config - Configuration management system
• phpnomad/array-json-config - Array and JSON-based configuration providers
• phpnomad/json-config-integration - Integration layer for JSON configuration
• phpnomad/loader - Class and file loading utilities

Dependency Injection & Design Patterns

• phpnomad/di - Dependency injection container
• phpnomad/singleton - Singleton pattern implementation
• phpnomad/decorator - Decorator pattern utilities
• phpnomad/facade - Facade pattern implementation
• phpnomad/registry - Registry pattern for managing objects

Database & Data Management

• phpnomad/db - Database abstraction layer
• phpnomad/datastore - Generic data storage interfaces
• phpnomad/mysql-integration - MySQL-specific database integration

HTTP & REST API

• phpnomad/http - HTTP request/response handling
• phpnomad/rest - REST API framework
• phpnomad/fastroute-rest-integration - FastRoute integration for REST routing
• phpnomad/fetch - HTTP client abstraction
• phpnomad/guzzle-fetch - Guzzle HTTP client integration

Authentication & Security

• phpnomad/auth - Authentication and authorization framework
• phpnomad/firebase-jwt-integration - JWT token handling via Firebase JWT
• phpnomad/privacy - Privacy and data protection utilities

Templating & Content

• phpnomad/template - Template rendering system
• phpnomad/twig-integration - Twig templating engine integration
• phpnomad/markdown - Markdown processing
• phpnomad/league-markdown-integration - League CommonMark integration

Events & Background Tasks

• phpnomad/event - Event system and dispatcher
• phpnomad/symfony-event-dispatcher-integration - Symfony EventDispatcher integration
• phpnomad/tasks - Background task scheduling and execution

Caching & Performance

• phpnomad/cache - Caching abstraction layer
• phpnomad/symfony-cache-integration - Symfony Cache component integration

CLI & Console

• phpnomad/console - Console command framework
• phpnomad/symfony-console-integration - Symfony Console integration

Email & Communication

• phpnomad/email - Email sending abstraction
• phpnomad/php-mail-integration - PHP mail function integration

Internationalization & Localization

• phpnomad/translate - Translation and localization system

Asset Management

• phpnomad/asset - CSS/JS asset management and enqueueing

Utilities & Helpers

• phpnomad/mutator - Data mutation and transformation utilities
• phpnomad/logger - Logging interfaces and utilities
• phpnomad/update - Plugin/theme update management
• phpnomad/enum-polyfill - PHP enum polyfill for older versions

WordPress Integration

• phpnomad/wordpress-integration - WordPress-specific integrations and adapters

Using PHPNomad as a Dependency

If you're developing a plugin that depends on PHPNomad, you can use WordPress's built-in Plugin Dependencies feature (introduced in WordPress 6.5) to ensure PHPNomad is installed and activated before your plugin.

Declaring the Dependency

Add the Requires Plugins header to your plugin's main PHP file:

/**
 * Plugin Name: My Plugin
 * Requires Plugins: phpnomad
 */

Using the phpnomad_ready Action

To ensure PHPNomad is fully loaded before your plugin initializes, hook into the phpnomad_ready action:

add_action('phpnomad_ready', function() {
    // PHPNomad is now loaded and ready to use
    // Initialize your plugin here
});

This action fires immediately after PHPNomad's Composer autoloader is loaded, ensuring all PHPNomad classes and interfaces are available.

How It Works

• WordPress will automatically prevent your plugin from being activated if PHPNomad is not installed
• Users will see a clear indication that PHPNomad must be installed first
• PHPNomad cannot be deactivated or deleted while your plugin is active
• If PHPNomad is removed via FTP or deployment, WordPress will display a notice about missing dependencies

Important Notes

• The Requires Plugins header uses the plugin slug (phpnomad), not the file path format
• This feature does not enforce version requirements or loading order
• Continue to use function_exists(), class_exists(), interface_exists(), and version checks where your plugin relies on specific functionality
• For more information, see Plugin Dependencies in WordPress 6.5

License

GPLv3 or later - http://www.gnu.org/licenses/gpl-3.0.txt

Links

• GitHub Organization
• Plugin Repository