WP_GET_NAV_MENU_NAME() │ WP 4.9.0

Функция wp_get_nav_menu_name() возвращает название навигационного меню в WordPress.

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

wp_get_nav_menu_name

Возвращаемое значение

Строка. Название меню.

Использование

wp_get_nav_menu_name( $location );

П��раметры

• $location (строка, обязательный) — идентификатор места для меню.

Примеры использования

Пример 1: Регистрация области меню и вывод названия меню

1. Зарегистрируйте область меню с идентификатором primary и названием "Главное меню".
2. В административной панели создайте меню с названием "Меню заголовка" и присвойте ему область "Главное меню".
3. Отобразите название меню, назначенное области с идентификатором 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( 'primary' );

// Вывод названия меню
echo $name_menu; //> Меню заголовка

Пример 2: Вывод названия меню перед отображением элементов меню

$locations = get_nav_menu_locations();
$menu = wp_get_nav_menu_object( $locations['registered-menu-location-slug'] );

echo '
' . esc_html( $menu->name ) . '
';

Изменения

С версии 4.9.0 — введено.

Код функции

Вот как выглядит код функции wp_get_nav_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;
        }
    }

    /**
     * Фильтрует название навигационного меню, которое возвращается.
     *
     * @param string $menu_name Название меню.
     * @param string $location  Идентификатор местоположения меню.
     */
    return apply_filters( 'wp_get_nav_menu_name', $menu_name, $location );
}

Связанные функции

• get_nav_menu_locations()
• register_nav_menu()
• wp_nav_menu()

Подсказка

Если вам нужно узнать, какие пункты меню находятся в конкретном меню, вы можете использовать wp_get_nav_menu_items().

Заметка

Не забывайте, что для правильного отображения меню необходимо его сначала зарегистрировать и создать в административной панели WordPress.