<?php
/**
 * Suppress "error - 0 - No summary was found for this file" on phpdoc generation
 *
 * @package plugin\includes
 */

/**
 * Class WP_Data_Access_Loader
 *
 * Adds and activates plugin filters and actions.
 *
 * @author  Peter Schulz
 * @since   1.0.0
 */
class WP_Data_Access_Loader {

	/**
	 * Registered plugin actions
	 *
	 * @var array
	 */
	protected $actions = array();

	/**
	 * Registered plugin filters
	 *
	 * @var array
	 */
	protected $filters = array();

	/**
	 * Adds an action to the action array
	 *
	 * Calls method add the create array element to be added to action array.
	 *
	 * @param string $hook Action name to be registered.
	 * @param object $component Reference to object to which the action will be applied.
	 * @param string $callback Callback function: method of $component object.
	 * @param int    $priority Priority of the action (default = 10).
	 * @param int    $accepted_args Number of accepted arguments of callback (default = 1).
	 *
	 * @see WP_Data_Access_Loader::add()
	 *
	 * @since   1.0.0
	 */
	public function add_action( $hook, $component, $callback, $priority = 10, $accepted_args = 1 ) {
		$this->actions = $this->add( $this->actions, $hook, $component, $callback, $priority, $accepted_args );
	}

	/**
	 * Create action or filter element
	 *
	 * Generic creation of an element that can be added to the action array or filter array.
	 *
	 * @param array  $hooks Action or filter array to which the hook is added.
	 * @param string $hook Action or filter name to be registered.
	 * @param object $component Reference to object to which the action or filter will be applied.
	 * @param string $callback Callback function: method of $component object.
	 * @param int    $priority Priority of the action or action.
	 * @param int    $accepted_args Number of accepted arguments of callback.
	 *
	 * @return array
	 * @since   1.0.0
	 */
	protected 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;
	}

	/**
	 * Adds a filter to the filter array
	 *
	 * Calls method add the create array element to be added to filter array.
	 *
	 * @param string $hook Filter name to be registered.
	 * @param object $component Reference to object to which the filter will be applied.
	 * @param string $callback Callback function: method of $component object.
	 * @param int    $priority Priority of the filter (default = 10).
	 * @param int    $accepted_args Number of accepted arguments of callback (default = 1).
	 *
	 * @see WP_Data_Access_Loader::add()
	 *
	 * @since   1.0.0
	 */
	public function add_filter( $hook, $component, $callback, $priority = 10, $accepted_args = 1 ) {
		$this->filters = $this->add( $this->filters, $hook, $component, $callback, $priority, $accepted_args );
	}

	/**
	 * Registration of filters and actions
	 *
	 * @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']
			);
		}
	}

}