Download the PHP package cedaro/wp-plugin without Composer
On this page you can find all versions of the php package cedaro/wp-plugin. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download cedaro/wp-plugin
More information about cedaro/wp-plugin
Files in cedaro/wp-plugin
Package wp-plugin
Short Description A base WordPress plugin library.
License MIT
Homepage https://github.com/cedaro/wp-plugin
Informations about the package wp-plugin
WordPress Plugin Library
Adds some structure to your WordPress plugins.
Requires PHP 8.0+.
Installation
To use this library in your project, add it to composer.json
:
Creating a Plugin
A plugin is a simple object created to help bootstrap functionality by allowing you to easily retrieve plugin information, reference internal files and URLs, and register hooks.
$stucture
is an instance of Plugin
and implements the PluginInterface
, which provides a basic API to access information about the plugin.
Hook Providers
Related functionality can be encapsulated in a class called a "hook provider" that's registered when bootstrapping the plugin.
Hook providers allow you to encapsulate related functionality, maintain state without using globals, namespace methods without prefixing functions, limit access to internal methods, and make unit testing easier.
For an example, the Cedaro\WP\Plugin\Provider\I18n
class is a default hook provider that automatically loads the text domain so the plugin can be translated.
The only requirement for a hook provider is that it should implement the HookProviderInterface
by defining a method called register_hooks()
.
Hook providers are registered with the main plugin instance by calling Plugin::register_hooks()
like this:
The BookPostType
provider might look something like this:
Protected Hook Callbacks
In WordPress, it's only possible to use public methods of a class as hook callbacks, but in the BookPostType
hook provider above, the callbacks are protected methods of the class.
Locking down the API like that is possible using the HooksTrait
developed by John P. Bloch.
Plugin Awareness
A hook provider may implement the PluginAwareInterface
to automatically receive a reference to the plugin when its hooks are registered.
For instance, in this class the enqueue_assets()
method references the internal $plugin
property to retrieve the URL to a JavaScript file in the plugin.
Another example is the I18n
provider mentioned earlier. It receives a reference to the plugin object so that it can use the plugin's base name and slug to load the text domain.
Classes that extend AbstractHookProvider
are automatically "plugin aware."
License
Copyright (c) 2017 Cedaro, LLC
This library is licensed under MIT.
Attribution is appreciated, but not required.