function menu_link_load

7.x menu.inc menu_link_load($mlid)
6.x menu.inc menu_link_load($mlid)

Get a menu link by its mlid, access checked and link translated for rendering.

This function should never be called from within node_load() or any other function used as a menu object load function since an infinite recursion may occur.

Parameters

$mlid: The mlid of the menu item.

Return value

A menu link, with $item['access'] filled and link translated for rendering.

Related topics

Menu system
Define the navigation menus, and route page requests to code based on URLs.
3 calls to menu_link_load()
menu_edit_menu_submit in drupal-6.x/modules/menu/menu.admin.inc
Submit function for adding or editing a custom menu.
menu_nodeapi in drupal-6.x/modules/menu/menu.module
Implementation of hook_nodeapi().
_menu_delete_item in drupal-6.x/includes/menu.inc
Helper function for menu_link_delete; deletes a single menu link.

File

drupal-6.x/includes/menu.inc, line 1653
API for the Drupal menu system.

Code

function menu_link_load($mlid) {
  if (is_numeric($mlid) && $item = db_fetch_array(db_query("SELECT m.*, ml.* FROM {menu_links} ml LEFT JOIN {menu_router} m ON m.path = ml.router_path WHERE ml.mlid = %d", $mlid))) {
    _menu_link_translate($item);
    return $item;
  }
  return FALSE;
}