diff --git a/wp-includes/nav-menu.php b/wp-includes/nav-menu.php index 7adf8e1a4e..53089a946b 100644 --- a/wp-includes/nav-menu.php +++ b/wp-includes/nav-menu.php @@ -184,6 +184,38 @@ function has_nav_menu( $location ) { return apply_filters( 'has_nav_menu', $has_nav_menu, $location ); } +/** + * Returns the name of a navigation menu. + * + * @since 4.9.0 + * + * @param string $location Menu location identifier. + * @return string Menu name. + */ +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 ); +} + /** * Determines whether the given ID is a nav menu item. * diff --git a/wp-includes/version.php b/wp-includes/version.php index b7018cd4c6..e300c112de 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -4,7 +4,7 @@ * * @global string $wp_version */ -$wp_version = '4.9-alpha-41765'; +$wp_version = '4.9-alpha-41766'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.