function hook_menu_link_alter

7.x system.api.php hook_menu_link_alter(&$item)
6.x core.php hook_menu_link_alter(&$item, $menu)

Alter the data being saved to the {menu_links} table by menu_link_save().

Parameters

$item: Associative array defining a menu link as passed into menu_link_save().

$menu: Associative array containg the menu router returned from menu_router_build().

Return value

None.

Related topics

Hooks
Allow modules to interact with the Drupal core.
1 invocation of hook_menu_link_alter()
menu_link_save in drupal-6.x/includes/menu.inc
Save a menu link.

File

documentation-6.x/developer/hooks/core.php, line 377
These are the hooks that are invoked by the Drupal core.

Code

function hook_menu_link_alter(&$item, $menu) {
  // Example 1 - make all new admin links hidden (a.k.a disabled).
  if (strpos($item['link_path'], 'admin') === 0 && empty($item['mlid'])) {
    $item['hidden'] = 1;
  }
  // Example 2  - flag a link to be altered by hook_translated_menu_link_alter()
  if ($item['link_path'] == 'devel/cache/clear') {
    $item['options']['alter'] = TRUE;
  }
}