Same name and namespace in other branches
  1. 4.7.x includes/menu.inc \menu_get_item()
  2. 6.x includes/menu.inc \menu_get_item()
  3. 7.x includes/menu.inc \menu_get_item()

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

14 calls to menu_get_item()
menu_confirm_disable_item in modules/menu/menu.module
Menu callback; hide a menu item.
menu_get_active_breadcrumb in includes/menu.inc
Returns an array of rendered menu items in the active breadcrumb trail.
menu_get_active_nontask_item in includes/menu.inc
Returns the ID of the current menu item or, if the current item is a local task, the menu item to which this task is attached.
menu_get_active_title in includes/menu.inc
Returns the title of the active menu item.
menu_get_menu in includes/menu.inc
Return the menu data structure.

... See full list

File

includes/menu.inc, line 271
API for the Drupal menu system.

Code

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();
}