<?php

/**
 * In-plugin event dispatcher.
 * Dispatchers plugin-specific events.
 */
class RscDtgs_Dispatcher
{
  /**
   * @var RscDtgs_Environment;
   */
  protected $environment;

  /**
   * Constructor.
   * @param RscDtgs_Environment $environment Plugin environment.
   */
  public function __construct(RscDtgs_Environment $environment)
  {
    $this->environment = $environment;
  }

  /**
   * Adds action.
   *
   * @see add_action()
   * @see http://codex.wordpress.org/Function_Reference/add_action
   * @param string   $action   The name of the action to which $function is hooked.
   * @param callable $function The name of the function you wish to be hooked.
   * @param int      $priority Used to specify the order in which the functions associated with a particular action are executed.
   * @param int      $args     The number of arguments the hooked function accepts.
   * @throws InvalidArgumentException
   * @return RscDtgs_Dispatcher
   */
  public function on($action, $function, $priority = 10, $args = 1)
  {
    if (!is_callable($function)) {
      throw new InvalidArgumentException(sprintf('Argument 2 passed to RscDtgs_Dispatcher::on() must be a callable, %s given.', gettype($function)));
    }

    add_action($this->appendPrefix($action), $function, $priority, $args);

    return $this;
  }

  /**
   * Triggers the specified action.
   *
   * @param string $action Action name
   * @param array $parameters An array of the parameters.
   */
  public function dispatch($action, array $parameters = [])
  {
    do_action_ref_array($this->appendPrefix($action), $parameters);
  }

  /**
   * Applies filters (not ref-array).
   *
   * @param string $action Action name
   * @param array $arg1 First filtered parameter.
   * @return mixed
   */
  public function applyFilters($action, $arg1)
  {
    $args = func_get_args();
    $args[0] = $this->appendPrefix($args[0]);
    return call_user_func_array('apply_filters', $args);
  }

  /**
   * Applies filters.
   *
   * @param string $action Action name
   * @param array $parameters An array of the parameters.
   * @return mixed
   */
  public function apply($action, array $parameters = [])
  {
    return apply_filters_ref_array($this->appendPrefix($action), $parameters);
  }

  /**
   * Add filter
   *
   * @param type $action
   * @param type $function
   * @param type $priority
   * @param type $args
   * @return \RscDtgs_Dispatcher
   * @throws InvalidArgumentException
   */
  public function filter($action, $function, $priority = 10, $args = 1)
  {
    if (!is_callable($function)) {
      throw new InvalidArgumentException(sprintf('Argument 2 passed to RscDtgs_Dispatcher::filter() must be a callable, %s given.', gettype($function)));
    }

    add_filter($this->appendPrefix($action), $function, $priority, $args);

    return $this;
  }

  /**
   * Returns prefix for the hooks.
   * @return string
   */
  protected function getHooksPrefix()
  {
    $config = $this->environment->getConfig();

    return $config->get('hooks_prefix', $this->environment->getPluginName());
  }

  /**
   * Appends the prefix to the action name.
   * @param string $action Action name.
   * @return string
   */
  protected function appendPrefix($action)
  {
    return $this->getHooksPrefix() . $action;
  }
}
