menu_set_active_menu_names

Set (or get) the active menu for the current page - determines the active trail.

Return value

An array of menu machine names, in order of preference. The 'menu_default_active_menus' variable may be used to assert a menu order different from the order of creation, or to prevent a particular menu from being used at all in the active trail. E.g., $conf['menu_default_active_menus'] = array('navigation', 'main-menu')

Related topics

Menu system

Define the navigation menus, and route page requests to code based on URLs.

2 calls to menu_set_active_menu_names()

File

includes/menu.inc, line 2292

API for the Drupal menu system.

Code

function menu_set_active_menu_names($menu_names = NULL) {
  $active = &drupal_static(__FUNCTION__);

  if (isset($menu_names) && is_array($menu_names)) {
    $active = $menu_names;
  }
  elseif (!isset($active)) {
    $active = variable_get('menu_default_active_menus', array_keys(menu_list_system_menus()));
  }
  return $active;
}