typisttech/wp-contained-hook

Lazily instantiate objects from dependency injection container to WordPress hooks (actions and filters)

Monday, February 12, 2018
by TangRufus
Repository
1 Watchers
0 Stars
11,222 Installations

PHP
2 Dependents
6 Suggesters
0 Forks
2 Open issues
8 Versions
10 % Grown

The README.md

WP Contained Hook

PHP from Packagist , _(*1)

, _(*2)

Goals
Installation
Usage
API
FAQs
Sponsoring :heart:
Running the Tests
Feedback
Change log
Security
Credits
License

Goals

Using PSR-11 container implementation in WordPress plugins, themes and packages during WordPress action/filter callbacks., _(*3)

Dependencies are usually lazy loaded(depends on your container implementation), not instantiated until the first time they are used (during WordPress action/filter callbacks)., _(*4)

Installation

Installation should be done via composer, details of how to install composer can be found at https://getcomposer.org/., _(*5)

You need a psr/container-implementation package as well. This readme uses league/container as an example (any psr/container-implementation works similarly)., _(*6)

``` bash, _(*7)

league/container is an example, any psr/container-implementation package works

$ composer require typisttech/wp-contained-hook league/container, _(*8)


## Usage

```php
use League\Container\Container;
use TypistTech\WPContainedHook\Hooks\Action;
use TypistTech\WPContainedHook\Hooks\Filter;
use TypistTech\WPContainedHook\Loader;

$container = new Container;

// Configure the container.
// This depends on your `psr/container-implementation`.
$container->add('bar', Bar::class);
$container->add('foo', Foo::class);

// Action.
$action = new Action('bar', 'admin_init', 'doSomething');

// Filter.
$filter = new Filter('foo', 'the_content', 'filterSomething');

// Add to loader.
$loader = new Loader($container);
$loader->add($action, $filter);

// Add to WordPress.
$loader->run();

In plain WordPress, the above is similar to:, _(*9)

$bar = new Bar();
add_action('admin_init', [$bar, 'doSomething'])

$foo = new Foo();
add_filter('the_content', [$foo, 'filterSomething'])

In WordPress plus container, the above is similar to:, _(*10)

add_action('admin_init', function ($arg) use ($container): void {
  $bar = $container->get('bar');
  $bar->doSomething($arg);
})

add_filter('the_content', function ($arg) use ($container) {
  $foo = $container->get('foo');
  return $foo->filterSomething($arg);
})

API

TypistTech\WPContainedHook\Loader

Maintain a list of all hooks that are registered throughout the plugin, and register them with the WordPress API. Call the run function to execute the list of actions and filters., _(*12)

Loader Constructor

@param Psr\Container\ContainerInterface $container The container.

Example:, _(*13)

$container = new Container;
$loader = new Loader($container);

Loader::add(HookInterface ...$hooks)

Add new hooks to the collection to be registered with WordPress., _(*14)

@param HookInterface|HookInterface[] ...$hooks Hooks to be registered.

Example:, _(*15)

// Action.
$action = new Action(SomeClass::class, 'plugin_loaded', 'doSomething');

// Filter.
$filter = new Filter(SomeClass::class, 'the_content', 'filterSomething');

// Add to loader
$loader->add($action, $filter);

Loader::run()

Example:, _(*17)

$loader->run();

Hooks: Action and Filter

Holds necessary information for an action or a filter., _(*18)

Both Action and Filter are subclasses of AbstractHook and implements HookInterface., _(*19)

AbstractHook Constructor.

@param string $hook The name of the WordPress hook that is being registered.
@param string $classIdentifier Identifier of the entry to look for from container.
@param string $callbackMethod The callback method name.
@param int|null $priority Optional.The priority at which the function should be fired. Default is 10.
@param int|null $acceptedArgs Optional. The number of arguments that should be passed to the $callback. Default is 1.

Example:, _(*20)

$action = new Action('bar', 'admin_init', 'doSomething', 20, 2);

$filter = new Filter('foo', 'the_content', 'filterSomething', 20, 2);

FAQs

Will you add support for older PHP versions?

Never! This plugin will only work on actively supported PHP versions., _(*21)

Don't use it on end of life or security fixes only PHP versions., _(*22)

It looks awesome. Where can I find some more goodies like this?

Articles on Typist Tech's blog
More projects on Typist Tech's GitHub profile
More plugins on TangRufus' wp.org profiles
Stay tuned on Typist Tech's newsletter
Follow @TangRufus on Twitter
Hire Tang Rufus to build your next awesome site

Where can I give :star::star::star::star::star: reviews?

Thanks! Glad you like it. It's important to let my know somebody is using this project. Since this is not hosted on wordpress.org, please consider:, _(*23)

tweet something good with mentioning @TangRufus
:star: star this Github repo
:eyes: watch this Github repo
write blog posts
submit pull requests
sponsor Tang Rufus to maintain his open source projects
hire Tang Rufus to build your next awesome site

Sponsoring :heart:

Love WP Contained Hook? Help me maintain it, a sponsorship here can help with it., _(*24)

GitHub Sponsors Matching Fund

Do you know GitHub is going to match your sponsorship?, _(*25)

Sponsor now via GitHub to double your greatness., _(*26)

Why don't you hire me?

Ready to take freelance WordPress jobs. Contact me via the contact form here or, via email info@typist.tech, _(*27)

Contact: Tang Rufus, _(*28)

Running the Tests

Run the tests:, _(*29)

bash $ composer test $ composer style:check, _(*30)

Feedback

Please provide feedback! We want to make this library useful in as many projects as possible. Please submit an issue and point out what you do and don't like, or fork the project and make suggestions. No issue is too small., _(*31)