PluginEngine.php in Crumbs, the Breadcrumbs suite 7

File

lib/PluginEngine.php

<?php

class crumbs_PluginEngine {
  protected $plugins;
  protected $weightKeeper;
  protected $pluginOrder_find = array();
  protected $pluginOrder_alter = array();
  function __construct(array $plugins, array $weights) {
    $this->plugins = $plugins;
    foreach ($plugins as $plugin_key => $plugin) {

      // $weights[$plugin_key] = FALSE;
    }
    $this->weightKeeper = new crumbs_RuleWeightKeeper($weights);
    foreach ($plugins as $plugin_key => $plugin) {
      $keeper = $this->weightKeeper
        ->prefixedWeightKeeper($plugin_key);
      $w_find = $keeper
        ->getSmallestWeight();
      if ($w_find !== FALSE) {
        $this->pluginOrder_find[$plugin_key] = $w_find;
      }
      $w_alter = $keeper
        ->findWeight();
      if ($w_alter !== FALSE) {
        $this->pluginOrder_alter[$plugin_key] = $w_alter;
      }
    }

    // lowest weight first = highest priority first
    asort($this->pluginOrder_find);

    // lowest weight last = highest priority last
    arsort($this->pluginOrder_alter);
    foreach ($this->pluginOrder_find as $plugin_key => $weight) {
      $this->pluginOrder_find[$plugin_key] = $plugins[$plugin_key];
    }
    foreach ($this->pluginOrder_alter as $plugin_key => $weight) {
      $this->pluginOrder_alter[$plugin_key] = $plugins[$plugin_key];
    }
  }

  /**
   * Invoke the plugin operation for all plugins, starting with the plugin with
   * highest priority. The function will stop when it has
   *
   * @param $plugin_operation
   *   an object that does the method call, and can maintain a state between
   *   different plugins' method calls.
   */
  function invokeAll_find(crumbs_PluginOperationInterface_find $plugin_operation) {
    foreach ($this->pluginOrder_find as $plugin_key => $plugin) {
      $weight_keeper = $this->weightKeeper
        ->prefixedWeightKeeper($plugin_key);
      $found = $plugin_operation
        ->invoke($plugin, $plugin_key, $weight_keeper);
      if ($found) {
        return $found;
      }
    }
  }

  /**
   * invokeAll for alter hooks.
   * These need to be called with the lowest priority first,
   * because later calls will overwrite earlier calls.
   */
  function invokeAll_alter(crumbs_PluginOperationInterface_alter $plugin_operation) {
    foreach ($this->pluginOrder_alter as $plugin_key => $plugin) {
      $plugin_operation
        ->invoke($plugin, $plugin_key);
    }
  }

}

Classes

Name	Description
crumbs_PluginEngine