W3cubDocs

/WordPress

has_nav_menu( string $location )

Determines whether a registered nav menu location has a menu assigned to it.

Parameters

$location

(string) (Required) Menu location identifier.

Return

(bool) Whether location has a menu.

Source

File: wp-includes/nav-menu.php 

function has_nav_menu( $location ) {
	$has_nav_menu = false;

	$registered_nav_menus = get_registered_nav_menus();
	if ( isset( $registered_nav_menus[ $location ] ) ) {
		$locations    = get_nav_menu_locations();
		$has_nav_menu = ! empty( $locations[ $location ] );
	}

	/**
	 * Filters whether a nav menu is assigned to the specified location.
	 *
	 * @since 4.3.0
	 *
	 * @param bool   $has_nav_menu Whether there is a menu assigned to a location.
	 * @param string $location     Menu location.
	 */
	return apply_filters( 'has_nav_menu', $has_nav_menu, $location );
}

Uses

Uses Description
wp-includes/nav-menu.php: has_nav_menu

Filters whether a nav menu is assigned to the specified location.
wp-includes/plugin.php: apply_filters()

Calls the callback functions that have been added to a filter hook.
wp-includes/nav-menu.php: get_registered_nav_menus()

Retrieves all registered navigation menu locations in a theme.
wp-includes/nav-menu.php: get_nav_menu_locations()

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

Changelog

Version Description
3.0.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/has_nav_menu