DrupalAPI.de

1. drupal
   1. drupal6 core.php
   2. drupal7

Define menu items and page callbacks.

This hook enables modules to register paths, which determines whose requests are to be handled. Depending on the type of registration requested by each path, a link is placed in the the navigation block and/or an item appears in the menu administration page (q=admin/menu).

This hook is called rarely - for example when modules are enabled.

Rückgabewert

An array of menu items. Each menu item has a key corresponding to the Drupal path being registered. The item is an associative array that may contain the following key-value pairs:

• "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.
• "title arguments": Arguments to send to t() or your custom callback.
• "description": The untranslated description of the menu item.
• "page callback": The function to call to display a web page when the user visits the path. If omitted, the parent menu item's callback will be used instead.
• "page arguments": An array of arguments to pass to the page callback function. Integer values pass the corresponding URL component (see arg()).
• "access callback": A function returning a boolean value that determines whether the user has access rights to this menu item. Defaults to user_access() unless a value is inherited from a parent menu item.
• "access arguments": An array of arguments to pass to the access callback function. Integer values pass the corresponding URL component.
• "file": A file that will be included before the callbacks are accessed; this allows callback functions to be in separate files. The file should be relative to the implementing module's directory unless otherwise specified by the "file path" option.
• "file path": The path to the folder containing the file specified in "file". This defaults to the path to the module implementing the hook.
• "load arguments": An array of arguments to be passed to each of the object loaders in the path. For example, for the router item at node/%node/revisions/%/view, the array(1, 3) will call node_load() with the arguments corresponding to the second and fourth URL argument; as with other arguments, integers are automatically cast to URL arguments. There are also two "magic" values: "%index" will correspond to the URL index where the object's load function is specified; "%map" will correspond to the full menu map, passed in by reference to the load function.
• "weight": An integer that determines relative position of items in the menu; higher-weighted items sink. Defaults to 0. When in doubt, leave this alone; the default alphabetical order is usually best.
• "menu_name": Optional. Set this to a custom menu if you don't want your item to be placed in Navigation.
• "type": A bitmask of flags describing properties of the menu item. Many shortcut bitmasks are provided as constants in menu.inc:
  • MENU_NORMAL_ITEM: Normal menu items show up in the menu tree and can be moved/hidden by the administrator.
  • MENU_CALLBACK: Callbacks simply register a path so that the correct function is fired when the URL is accessed.
  • MENU_SUGGESTED_ITEM: Modules may "suggest" menu items that the administrator may enable.
  • MENU_LOCAL_TASK: Local tasks are rendered as tabs by default.
  • MENU_DEFAULT_LOCAL_TASK: Every set of local tasks should provide one "default" task, that links to the same path as its parent when clicked.

  If the "type" key is omitted, MENU_NORMAL_ITEM is assumed.

For a detailed usage example, see page_example.module. For comprehensive documentation on the menu system, see http://drupal.org/node/102338.

Verwandte Themen

Hooks

Allow modules to interact with the Drupal core.

Code

modules/menu/menu.api.php, line 79

<?php
function hook_menu() {
  $items = array();

  $items['blog'] = array(
    'title' => 'blogs',
    'page callback' => 'blog_page',
    'access arguments' => array('access content'),
    'type' => MENU_SUGGESTED_ITEM,
  );
  $items['blog/feed'] = array(
    'title' => 'RSS feed',
    'page callback' => 'blog_feed',
    'access arguments' => array('access content'),
    'type' => MENU_CALLBACK,
  );

  return $items;
}
?>