class og_CrumbsMultiPlugin_group_post in Crumbs, the Breadcrumbs suite 7

Use the group node as a parent for group posts. The priorities can be configured per group content type.

Hierarchy

• class \og_CrumbsMultiPlugin_group_post implements crumbs_MultiPlugin

File

plugins/crumbs.og.2.inc, line 22

class og_CrumbsMultiPlugin_group_post implements crumbs_MultiPlugin {
  function describe($api) {
    $types = node_type_get_types();
    foreach ($types as $type) {
      if (og_is_group_content_type('node', $type->type)) {
        $api
          ->addRule($type->type);
      }
    }
  }

  /**
   * Attempts to find a breadcrumb parent path for node/%.
   * If that node is in a group, it will return the group page as a parent.
   *
   * @param string $path
   *   The path, e.g. node/123
   * @param array $item
   *   The router item, as returned by crumbs_get_router_item()
   */
  function findParent__node_x($path, $item) {
    $node = $item['map'][1];

    // Load the node if it hasn't been loaded due to a missing wildcard loader.
    $node = is_numeric($node) ? node_load($node) : $node;

    // field_get_items() performs a lot faster than og_get_entity_groups().
    // See http://drupal.org/node/1819300#comment-6633494
    // TODO:
    //   We cannot rely on the field name to always be og_group_ref.
    //   Instead, we could provide a separate plugin for each such field.
    //   This way, fields in disabled plugins get never triggered.
    $items = field_get_items('node', $node, 'og_group_ref');
    if (!empty($items)) {
      foreach ($items as $item) {
        $parent_path = $this
          ->getParentPath($item['target_id'], $node);
        return array(
          $node->type => $parent_path,
        );
      }
    }
  }

  /**
   * This method can be overridden by custom plugins that inherit from this one,
   * e.g. to set a different parent for group events than for group discussions.
   *
   * @param int $group_nid
   *   Node id of the group that was found to be the parent.
   * @param stdClass $group_post
   *   The node that is in the group, and that we are trying to find a parent
   *   path for.
   *
   * @return string
   *   A parent path. The native implementation returns just node/$nid.
   *   Custom module might subclass this class and override this method, to let
   *   it return e.g. node/$nid/events, or node/$nid/forum, depending on the
   *   $group_post argument.
   */
  protected function getParentPath($group_nid, $group_post) {
    return 'node/' . $group_nid;

    /*
     * Example:
     * switch ($group_post->type) {
     *   case 'event':
     *     return 'node/' . $group_nid . '/events';
     *   case 'discussion':
     *     return 'node/' . $group_nid . '/forum';
     *   default:
     *     return 'node/' . $group_nid;
     * }
     */
  }

}

Members

Name	Modifiers	Type	Description	Overrides
og_CrumbsMultiPlugin_group_post::describe		function	Overrides crumbs_MultiPlugin::describe
og_CrumbsMultiPlugin_group_post::findParent__node_x		function	Attempts to find a breadcrumb parent path for node/%. If that node is in a group, it will return the group page as a parent.
og_CrumbsMultiPlugin_group_post::getParentPath	protected	function	This method can be overridden by custom plugins that inherit from this one, e.g. to set a different parent for group events than for group discussions.