* @license GPL-2.0+ http://www.gnu.org/licenses/gpl-2.0.txt * @link https://refact.co/ */ namespace Refact\ACFG; if ( ! defined( 'ABSPATH' ) ) exit; /** * Register all actions and filters for the plugin. * * 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. * * @category Plugin * @package ACFG * @subpackage ACFG/includes * @author Refact * @license GPL-2.0+ http://www.gnu.org/licenses/gpl-2.0.txt * @link https://refact.co/ * @since 1.0.0 */ class ACFG_Loader { /** * The array of actions registered with WordPress. * * @since 1.0.0 * @access protected * @var array $actions when the plugin loads. */ protected $actions; /** * The array of filters registered with WordPress. * * @since 1.0.0 * @access protected * @var array $filters when the plugin loads. */ protected $filters; /** * Initialize the collections used to maintain the actions and filters. * * @since 1.0.0 */ public function __construct() { $this->actions = array(); $this->filters = array(); } /** * Add a new action to the collection to be registered with WordPress. * * @since 1.0.0 * @param string $hook The name of the WP action. * @param object $component A reference to the instance action. * @param string $callback The name of the function. * @param int $priority Optional. priority. Default 10. * @param int $accepted_args Optional. number of arguments. Default 1. */ public function add_action( $hook, $component, $callback, $priority = 10, $accepted_args = 1 ) { $this->actions = $this->add( $this->actions, $hook, $component, $callback, $priority, $accepted_args ); } /** * Add a new filter to the collection to be registered with WordPress. * * @since 1.0.0 * @param string $hook The name of the WordPress filter. * @param object $component A reference to the instance. * @param string $callback The name of the function. * @param int $priority Optional. The priority. Default is 10. * @param int $accepted_args Optional. Number of arguments. Default 1. */ public function add_filter( $hook, $component, $callback, $priority = 10, $accepted_args = 1 ) { $this->filters = $this->add( $this->filters, $hook, $component, $callback, $priority, $accepted_args ); } /** * A utility function that is used to register * the actions and hooks into a single collection. * * @since 1.0.0 * @access private * @param array $hooks Hooks that is being registered. * @param string $hook The name the filter. * @param object $component A reference to the instance. * @param string $callback The name of the function. * @param int $priority The priority. * @param int $accepted_args The number of arguments. * @return array $hooks Actions and filters registered. */ private function add( $hooks, $hook, $component, $callback, $priority, $accepted_args ) { $hooks[] = array( 'hook' => $hook, 'component' => $component, 'callback' => $callback, 'priority' => $priority, 'accepted_args' => $accepted_args, ); return $hooks; } /** * Register the filters and actions with WordPress. * * @since 1.0.0 */ public function run() { foreach ( $this->filters as $hook ) { add_filter( $hook['hook'], array( $hook['component'], $hook['callback'] ), $hook['priority'], $hook['accepted_args'] ); } foreach ( $this->actions as $hook ) { add_action( $hook['hook'], array( $hook['component'], $hook['callback'] ), $hook['priority'], $hook['accepted_args'] ); } } }