Sets (or gets) the active menu for the current page.

The active menu for the 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()
book_page_alter in modules/book/book.module
Implements hook_page_alter().
menu_get_active_menu_names in includes/menu.inc
Gets the active menu for the current page.

File

includes/menu.inc, line 2335
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;
}