function hook_menu_get_item_alter

Alter a menu router item right after it has been retrieved from the database or cache.

This hook is invoked by menu_get_item() and allows for run-time alteration of router information (page_callback, title, and so on) before it is translated and checked for access. The passed-in $router_item is statically cached for the current request, so this hook is only invoked once for any router item that is retrieved via menu_get_item().

Usually, modules will only want to inspect the router item and conditionally perform other actions (such as preparing a state for the current request). Note that this hook is invoked for any router item that is retrieved by menu_get_item(), which may or may not be called on the path itself, so implementations should check the $path parameter if the alteration should fire for the current request only.

Parameters

$router_item: The menu router item for $path.

$path: The originally passed path, for which $router_item is responsible.

$original_map: The path argument map, as contained in $path.

See also

menu_get_item()

Related topics

1 invocation of hook_menu_get_item_alter()
menu_get_item in includes/menu.inc
Gets a router item.

File

modules/system/system.api.php, line 940

Code

function hook_menu_get_item_alter(&$router_item, $path, $original_map) {
    // When retrieving the router item for the current path...
    if ($path == $_GET['q']) {
        // ...call a function that prepares something for this request.
        mymodule_prepare_something();
    }
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.