get_nav_menu_locations()

Retrieves all registered navigation menu locations and the menus assigned to them.

Contents

Return

(int[]) Associative array of registered navigation menu IDs keyed by their location name. If none are registered, an empty array.

Top ↑

Source

File: wp-includes/nav-menu.php 

function get_nav_menu_locations() {
	$locations = get_theme_mod( 'nav_menu_locations' );
	return ( is_array( $locations ) ) ? $locations : array();
}

Expand full source code Collapse full source code View on Trac View on GitHub

Top ↑

Top ↑

Uses

Uses
Uses Description
wp-includes/theme.php: get_theme_mod()

Retrieves theme modification value for the current theme.

Top ↑

Used By

Used By
Used By Description
wp-includes/rest-api/endpoints/class-wp-rest-menus-controller.php: WP_REST_Menus_Controller::get_menu_locations()

Returns the names of the locations assigned to the menu.
wp-includes/rest-api/endpoints/class-wp-rest-menus-controller.php: WP_REST_Menus_Controller::handle_locations()

Updates the menu’s locations from a REST request.
wp-includes/rest-api/endpoints/class-wp-rest-menu-locations-controller.php: WP_REST_Menu_Locations_Controller::prepare_item_for_response()

Prepares a menu location object for serialization.
wp-includes/rest-api/endpoints/class-wp-rest-menu-locations-controller.php: WP_REST_Menu_Locations_Controller::prepare_links()

Prepares links for the request.
wp-includes/nav-menu.php: _wp_menus_changed()

Handle menu config after theme change.
wp-includes/nav-menu.php: wp_get_nav_menu_name()

Returns the name of a navigation menu.
wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::__construct()

Constructor.
wp-includes/nav-menu-template.php: wp_nav_menu()

Displays a navigation menu.
wp-includes/nav-menu.php: has_nav_menu()

Determines whether a registered nav menu location has a menu assigned to it.
wp-includes/nav-menu.php: wp_delete_nav_menu()

Delete a Navigation Menu.
Show 5 more used by Hide more used by

Top ↑

Changelog

Changelog
Version Description
3.0.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
    Contributed by madastro —

    Allows the editor role to modify menus

    function allow_menu_editor() {
	$arr_menu = array_filter(get_nav_menu_locations());
	if ( ! empty($arr_menu) ) {
		$obj_role = get_role('editor');
		$obj_role->add_cap('edit_theme_options');
	}
}
add_action( 'admin_menu', 'allow_menu_editor', 999);
  2. Skip to note 2 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
    Contributed by khangaitan — 
    $menu_name = 'menu1';
$menu_item = wp_get_nav_menu_object( get_nav_menu_locations( $menu_name )[ $menu_name ] )->name;

echo $menu_item ? $menu_item : __( 'Insert menus', 'textdomain' );
wp_nav_menu( array(
	'theme_location' => $menu_name,
	'container'      => ''
) );

$menu_name = '';

$menu_name = 'menu2';
$menu_item = wp_get_nav_menu_object( get_nav_menu_locations( $menu_name )[ $menu_name ] )->name;

echo $menu_item ? $menu_item : __( 'Insert menus', 'textdomain' );
wp_nav_menu( array(
	'theme_location' => $menu_name,
	'container'      => ''
) );

$menu_name = '';

$menu_name = 'menu3';
$menu_item = wp_get_nav_menu_object( get_nav_menu_locations( $menu_name )[ $menu_name ] )->name;

echo $menu_item ? $menu_item : __( 'Insert menus', 'textdomain' );
wp_nav_menu( array(
	'theme_location' => $menu_name,
	'container'      => ''
) );

    Expand full source codeCollapse full source code

You must log in before being able to contribute a note or feedback.