get_nav_menu_locations()

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

Contents

Description Description

Return Return

(array) Registered navigation menu locations and the menus assigned them. If none are registered, an empty array.

Top ↑

Source 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

Top ↑

Changelog Changelog

Changelog
Version Description
3.0.0 Introduced.

Top ↑

Top ↑

Uses Uses

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

Retrieve theme modification value for the current theme.

Top ↑

Used By Used By

Used By
Used By Description
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 1 more used by Hide more used by

Top ↑

User Contributed Notes 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.