hook_menu_alter

6 core.php	`hook_menu_alter(&$items)`
7 system.api.php	`hook_menu_alter(&$items)`
8 system.api.php	`hook_menu_alter(&$items)`

Alter the data being saved to the {menu_router} table after hook_menu is invoked.

This hook is invoked by menu_router_build(). The menu definitions are passed in by reference. Each element of the $items array is one item returned by a module from hook_menu. Additional items may be added, or existing items altered.

Parameters

$items: Associative array of menu router definitions returned from hook_menu().

▸ 1 function implements hook_menu_alter()

▾ 1 function implements hook_menu_alter()

comment_menu_alter in modules/comment/comment.module: Implements hook_menu_alter().

File

modules/system/system.api.php, line 1238: Hooks provided by Drupal core and the System module.

Code

<?php
function hook_menu_alter(&$items) {
  // Example - disable the page at node/add
  $items['node/add']['access callback'] = FALSE;
}
?>

Comments

When I alter a item,a blank item is be added to the navigation.

Posted by yescookie on February 2, 2011 at 9:51pm

I alter a menu item as follow:

<?php
function menufun_menu_alter(&$items) {
    $items['logout']['page callback'] = 'menufun_user_logout';
    $items['logout']['access callback'] = 'user_is_logged_in';
    unset($items['logout']['file']);
}
?>

It also add a blank item to the navigation.So what's wrong with my code?

You may be wanting to alter

Posted by Alan D. on August 28, 2011 at 1:22pm

You may be wanting to alter 'user/logout' rather than just 'logout' in case you are using Drupal 7.

You can remove them by

Posted by Frederic wbase on April 27, 2011 at 11:27am

You can remove them by unsetting the variable.

for example
unset($items['user/%user/edit'])

change menu item title

Posted by andreyks on October 16, 2011 at 12:22pm

$items['contact']['access callback'] = FALSE;
works fine, but
$items['contact']['title'] = 'Whatever';
does not work. Why?

use

Posted by pandikamal on November 11, 2011 at 10:45am

use $items['contact']['title'] = t('Whatever');
its work fine.

You shouldn't use t() in

Posted by iMiksu on December 12, 2011 at 1:59pm

You shouldn't use t() in Drupal 7 unless the title callback is changed. Drupal core uses t() function as a default title callback.

"title": Required. The untranslated title of the menu item.
"title callback": Function to generate the title; defaults to t(). If you require only the raw string to be output, set this to FALSE.