Same name and namespace in other branches
  1. 4.6.x includes/menu.inc \menu_item_link()
  2. 4.7.x includes/menu.inc \menu_item_link()

Returns the rendered link to a menu item.

Parameters

$mid: The menu item id to render.

$theme: Whether to return a themed link or the link as an array

Related topics

Menu system
Define the navigation menus, and route page requests to code based on URLs.
4 calls to menu_item_link()
menu_get_active_breadcrumb in includes/menu.inc
Returns an array of rendered menu items in the active breadcrumb trail.
menu_primary_links in includes/menu.inc
Returns an array containing the primary links. Can optionally descend from the root of the Primary links menu towards the current node for a specified number of levels and return that submenu. Used to generate a primary/secondary menu from different…
theme_menu_item in includes/menu.inc
Generate the HTML output for a single menu item.
theme_menu_local_task in includes/menu.inc
Generate the HTML representing a given menu item ID as a tab.

File

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

Code

function menu_item_link($mid, $theme = TRUE) {
  $item = menu_get_item($mid);
  $link_item = $item;
  $link = '';
  while ($link_item['type'] & MENU_LINKS_TO_PARENT) {
    $link_item = menu_get_item($link_item['pid']);
  }
  if ($theme) {
    $link = theme('menu_item_link', $item, $link_item);
  }
  else {
    $link = array(
      'title' => $item['title'],
      'href' => $link_item['path'],
      'attributes' => !empty($item['description']) ? array(
        'title' => $item['description'],
      ) : array(),
    );
  }
  return $link;
}