wp_get_nav_menu_name() – Function | Developer.WordPress.org

Returns the name of a navigation menu.

Parameters

$locationstringrequired: Menu location identifier.

Return

string Menu name.

Source

function wp_get_nav_menu_name( $location ) {
	$menu_name = '';

	$locations = get_nav_menu_locations();

	if ( isset( $locations[ $location ] ) ) {
		$menu = wp_get_nav_menu_object( $locations[ $location ] );

		if ( $menu && $menu->name ) {
			$menu_name = $menu->name;
		}
	}

	/**
	 * Filters the navigation menu name being returned.
	 *
	 * @since 4.9.0
	 *
	 * @param string $menu_name Menu name.
	 * @param string $location  Menu location identifier.
	 */
	return apply_filters( 'wp_get_nav_menu_name', $menu_name, $location );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘wp_get_nav_menu_name’, string $menu_name, string $location ): Filters the navigation menu name being returned.

Uses	Description
wp_get_nav_menu_object()`wp-includes/nav-menu.php`	Returns a navigation menu object.
get_nav_menu_locations()`wp-includes/nav-menu.php`	Retrieves all registered navigation menu locations and the menus assigned to them.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Show 1 more Show less

Changelog

Version	Description
4.9.0	Introduced.

User Contributed Notes

Skip to note 3 content

pixelstorm 4 years ago

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
Output the name of the menu before displaying the menus items to the user.
```
$locations = get_nav_menu_locations();
$menu = wp_get_nav_menu_object( $locations['registered-menu-location-slug'] );
echo '<div class="footer-menu__title">' . wp_kses_post( $menu->name ) . '</div>';
```
Log in to add feedback
Skip to note 4 content

Asadiyan 10 months ago

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
Dynamic title based on name of a navigation menu.
```
if ( has_nav_menu( 'theme_location' ) ) {
	echo wp_get_nav_menu_name( 'theme_location' );
	wp_nav_menu( 'theme_location' );
}
```
Log in to add feedback

wp_get_nav_menu_name( string $location ): string

In this article

Parameters

Return

Source

Hooks

Changelog

User Contributed Notes

wp_get_nav_menu_name( string $location ): string

In this article

Parameters

Return

Source

Hooks

Related

Changelog

User Contributed Notes