wp_get_nav_menu_name() │ WP 4.9.0

Повертає ім’я меню, вказане в адмінці, на основі переданого ідентифікатора області меню.

Зареєструвати місце меню можна за допомогою функції register_nav_menu() .

Хуки з функції

wp_get_nav_menu_name

Повертає

Строку. Назва меню або порожній рядок, якщо меню немає.

Використання

$menu_name = wp_get_nav_menu_name($location);

$location (рядок) (обов’язковий): Ідентифікатор області меню вказується в функції
register_nav_menu() .

Приклади

#1 Реєстрація області меню та виведення назви меню

Зареєструємо область меню з ідентифікатором primaryта назвою Основное меню;
В адмінці створимо меню з ім’ям “Меню в шапці” та вкажемо йому область меню Основное меню;
Виведемо назвою меню, закріплене за областю меню з ідентифікатором primary.

// Реєстрація області меню "Основне меню" з ідентифікатором "primary"
add_action( 'after_setup_theme', 'theme_register_nav_menu');
function theme_register_nav_menu() {
	register_nav_menu( 'primary', 'Основне меню');
}

// Отримання назва меню, закріплене за областю "primary"
$name_menu = wp_get_nav_menu_name($location);

// Виведення імені меню
echo $name_menu; //> Меню в шапці

список змін

З версії 4.9.0

Введено.

Код `wp_get_nav_menu_name() wp get nav menu name` ^{WP 6.0.2}

wp-includes/nav-menu.php

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 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 );
}

wp_get_nav_menu_name() │ WP 4.9.0

Хуки з функції

Повертає

Використання

Приклади

#1 Реєстрація області меню та виведення назви меню

список змін

Код wp_get_nav_menu_name() wp get nav menu name WP 6.0.2

Зв’язані функції

nav_menu (меню навігації)

Меню

Залишити відповідь Скасувати коментар

Код `wp_get_nav_menu_name() wp get nav menu name` ^{WP 6.0.2}