_menu_item_is_accessible

Versions
4.6 – 5
_menu_item_is_accessible($mid)

Determine whether the given menu item is accessible to the current user.

Use this instead of just checking the "access" property of a menu item to properly handle items with fall-through semantics.

▾ 7 functions call _menu_item_is_accessible()

menu_execute_active_handler in includes/menu.inc
Execute the handler associated with the active menu item.
menu_get_active_help in includes/menu.inc
Returns the help associated with the active menu item.
system_admin_menu_block in modules/system/system.module
Provide a single block on the administration overview page.
system_get_module_admin_tasks in modules/system/system.module
_menu_append_contextual_items in includes/menu.inc
Account for menu items that are only defined at certain paths, so will not be cached.
_menu_build_local_tasks in includes/menu.inc
Find all the items in the current local task tree.
_menu_build_visible_tree in includes/menu.inc
Find all visible items in the menu tree, for ease in displaying to user.

Code

includes/menu.inc, line 1157

<?php
function _menu_item_is_accessible($mid) {
  $menu = menu_get_menu();

  // Follow the path up to find the first "access" attribute.
  $path = isset($menu['items'][$mid]['path']) ? $menu['items'][$mid]['path'] : NULL;
  while ($path && (!isset($menu['path index'][$path]) || !isset($menu['items'][$menu['path index'][$path]]['access']))) {
    $path = substr($path, 0, strrpos($path, '/'));
  }
  if (empty($path)) {
    // Items without any access attribute up the chain are denied, unless they
    // were created by the admin. They most likely point to non-Drupal directories
    // or to an external URL and should be allowed.
    return $menu['items'][$mid]['type'] & MENU_CREATED_BY_ADMIN;
  }
  return $menu['items'][$menu['path index'][$path]]['access'];
}
?>
Login or register to post comments
 
 

All source code and documentation on this site is released under the terms of the GNU General Public License, version 2 and later. Drupal is a registered trademark of Dries Buytaert.