Callback.php in Crumbs, the Breadcrumbs suite 7.2

File

lib/EntityPlugin/Callback.php

<?php

class crumbs_EntityPlugin_Callback implements crumbs_EntityPlugin {

  /**
   * @var callable
   */
  protected $callback;

  /**
   * @var string
   */
  protected $module;

  /**
   * @var string
   */
  protected $key;

  /**
   * @var string
   *   Either 'entityParent' or 'entityTitle'.
   */
  protected $callbackType;

  /**
   * @param callable $callback
   * @param string $module
   * @param string $key
   * @param string $callback_type
   *   Either 'entityParent' or 'entityTitle'.
   */
  function __construct($callback, $module, $key, $callback_type) {
    $this->callback = $callback;
    $this->module = $module;
    $this->key = $key;
    $this->callbackType = $callback_type;
  }

  /**
   * @return array
   */
  function __sleep() {

    // Do not serialize the callback.
    return array(
      'module',
      'key',
      'callbackType',
    );
  }

  /**
   * @inheritdoc
   */
  function describe($api, $entity_type, $keys) {
    foreach ($keys as $key => $title) {
      $api
        ->addRule($key, $title);
    }
  }

  /**
   * @inheritdoc
   */
  function entityFindCandidate($entity, $entity_type, $distinction_key) {
    if (!isset($this->callback)) {

      // Restore the callback after serialization.
      $this->callback = crumbs()->callbackRestoration
        ->restoreCallback($this->module, $this->key, $this->callbackType);
    }
    if (!empty($this->callback)) {
      return call_user_func($this->callback, $entity, $entity_type, $distinction_key);
    }
    return NULL;
  }

}

Classes

Name	Description
crumbs_EntityPlugin_Callback