flexpress/component-hooks

Hook system helper for WordPress

FlexPress theme component

Install via pimple

Before we done anything else we need to setup the configs in pimple, _(*1)

$pimple['configHookable'] = function() {
  return new Config();
};

$pimple['hooker'] = function ($c) {
  return new Hooker($c['objectStorage'], array(
    $c['configHookable']
  ));
};

What we have done here is created two configs, one for the hooker and one for a hookable class, we have then passed in the configHookable to the hooker so it can hook all its hooks up., _(*2)

Note that that $c['objectStorage'] is the SPLObjectStorage class., _(*3)

Setting up hooks

To add hook we must first create a class that uses the HookableTrait, lets make a very basic class that does this:, _(*4)

class Config {

  use HookableTrait;

}

Simples, all done but we should probably add a hook method, so lets do that now:, _(*5)

class Config {

  use HookableTrait;

  /**
   * @type action
   */
  public function adminInit() {
    echo "Hello, this is the admin hook being fired";
  }

}

This example adds a hook for the config class and the adminInit function for the action admin_init, not that the method is in camelcase., _(*6)

As well as setting up actions you can add filters like this:, _(*7)

class Config {

  use HookableTrait;

  /**
   * @type action
   */
  public function adminInit() {
    echo "Hello, this is the admin hook being fired";
  }

  /**
   * @type filter
   */
  public function theTitle($title) {
    return strip_tags($title);
  }

}

In this example we have added a filter that strips the tags from the title by hooking into the the_title filter., _(*8)

So for filters you simply add this to the docblock above the method:, _(*9)

/**
 * @type action
 */

and for filters you do the same but change the type to filter:, _(*10)

/**
 * @type filter
 */

Advanced usage

As well as specifying the type of hook you can also specify the priority like this:, _(*11)

/**
 * @type action
 * @priority 10
 */

And finally you can also specify the number of paramters you expect like this:, _(*12)

/**
 * @type action
 * @priority 10
 * @params 3
 */

Which allows you to add both action and filter hooks, speficy the priority as well as the number of params you expect, so nothing is taken away from the add_action and add_filter functions., _(*13)

Public methods - Hooker

• hookUp() - Loops through all the hookables passed to the hooker and hooks them up.

Public methods - HookableTrait

• hookUp() - Uses reflection to find all public methods with a valid docblock and hook them up.

Protected methods - HookableTrait

• getMethodAttributes() - Gets all the attibutes of a methods docblock.
• getHookName($methodName, $attributes) - For a given method name and attibutes, gets the hook name. e.g. theContent becomes the_content
• registerHook($hook_name, $method_name, $attributes) - Actuallys registers the hook depending on what type it is.