Back to Portfolio

WordPress Plugin Starter Kit with PSR-4 Service Container

Introduction

The WordPress Plugin Starter Kit is a modern, PSR-4 compliant dependency injection container designed specifically for WordPress plugin development. It provides a robust foundation for building maintainable, testable, and well-structured WordPress plugins.

Why This Exists

WordPress plugin development often involves complex interdependencies between classes, services, and WordPress hooks. Traditional approaches lead to:

• Tight coupling between components
• Difficulty in testing individual classes
• Hard-to-maintain codebases as projects grow
• Poor separation of concerns

This starter kit solves these problems by providing:

• Dependency Injection: Automatically resolve and inject dependencies
• Service Container: Centralized service management and instantiation
• PSR-4 Compliance: Industry-standard autoloading
• WordPress Integration: Seamless integration with WordPress hooks and lifecycle
• Testability: Easy to mock dependencies for unit testing

Use Cases

• Building complex WordPress plugins with multiple services
• Developing enterprise-level WordPress plugins
• Projects requiring maintainable and testable code architecture

---

Features

• PSR-4 Autoloading: Standards-compliant namespace and file structure
• Automatic Dependency Resolution: Constructor injection with recursive dependency resolution
• Singleton Support: Register services as singletons for shared instances
• Flexible Bindings: Bind interfaces to implementations, closures, or concrete instances
• Container Injection Control: Prevent container anti-patterns
• WordPress Optimized: Designed specifically for WordPress plugin/theme architecture
• Zero Configuration: Works out of the box with sensible defaults
• Lightweight: Minimal overhead with maximum functionality

---

Requirements

• PHP: 7.4 or higher (8.0+ recommended)
• WordPress: 5.8 or higher (tested up to 6.4)
• Composer: For dependency management and autoloading

Getting Started

Directory Structure

File structure for plugin using this starter kit:

sefra-plugin-starter/
├── sefra-starter.php                   # Main plugin file
├── composer.json                       # Composer configuration
├── src/                                # Source files (PSR-4)
│   ├── Admin/
│   ├── Frontend/
│   ├── Providers/
|   │   PluginServiceProvider.php       # Service provider for registering and binding services
│   ├── Helpers/
|   │   └──Hooks.php                    # Wordpress hooks registration helpers
│   ├── Services/
│   └── Plugin.php                     # Main plugin class
└── assets/                             # CSS, JS, images

---

Next Steps

To get started with the WordPress Plugin Starter Kit

• Quick Start Guide using starter kit: Getting Started
• Available Features: Features Overview
• Integration with Sefra Container: How to Use Sefra Container

---

Contributing

Contributions are welcome! Please follow these guidelines:

• Code Style: Follow PSR-12 coding standards
• Documentation: Update documentation for API changes
• Compatibility: Maintain PHP 7.4+ and WordPress 5.8+ compatibility

License

This project is licensed under the MIT License.

---

Support

• Issues: GitHub Issues

---

Acknowledgments

Built with inspiration from:

• Laravel's Service Container
• Symfony Dependency Injection
• PHP-FIG Standards (PSR-4, PSR-11)
• WordPress Plugin Development Best Practices

---

Changelog

Version 1.0.0

• Initial release
• PSR-4 compliant service container
• Automatic dependency resolution
• Singleton support
• WordPress integration helpers
• Comprehensive documentation

---