menu_get_item

Definition

menu_get_item($mid, $path = NULL, $reset = FALSE)
drupal/includes/menu.inc, line 271

Description

Retrieves the menu item specified by $mid, or by $path if $mid is not given.

Parameters

$mid The menu ID of the menu item to retrieve.

$path The internal path of the menu item to retrieve. Defaults to NULL. Only used if $mid is not set.

$reset Optional flag that resets the static variable cache of the menu tree, if set to TRUE. Default is FALSE.

Return value

The menu item found in the site menu, or an empty array if none could be found.

Related topics

Name	Description
Menu system	Define the navigation menus, and route page requests to code based on URLs.

Code

<?php
function menu_get_item($mid, $path = NULL, $reset = FALSE) {
  static $menu;

  if (!isset($menu) || $reset) {
    $menu = menu_get_menu();
  }

  if (isset($mid)) {
    return $menu['items'][$mid];
  }

  if (isset($path)) {
    return $menu['items'][$menu['path index'][$path]];
  }

  return array();
}
?>