1 menu.inc menu_set_active_menu_names($menu_names = NULL)

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: 'system.core.active_menus_default' config item 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. For example, $conf['system.core']['active_menus_default'] = array('tools', 'main').

Related topics


core/includes/menu.inc, line 2484
API for the Backdrop menu system.


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

  if (isset($menu_names) && is_array($menu_names)) {
    $active = $menu_names;
  elseif (!isset($active)) {
    $active = config_get('system.core', 'active_menus_default') ? : array_keys(menu_list_system_menus());
  return $active;