register_nav_menu() │ WP 3.0.0

Регистрирует одну локацию (место) для меню, к которому затем можно прикрепить меню в админке.

Такое меню удобно тем, что его можно очень гибко редактировать в админ панели, добавляя в него ссылки на любые разделы и страницы сайта, а также и любые другие ссылки. Меню выводиться в шаблоне функцией wp_nav_menu().

Функция автоматически регистрирует поддержку навигационных меню для темы.

Т.е. используя эту функцию нет необходимости предварительно регистрировать поддержку меню для темы: add_theme_support('menus').

Чтобы зарегистрировать сразу несколько локаций для меню используйте register_nav_menus().

Функцию принято вызывать во время события after_setup_theme.

Работает на основе: register_nav_menus()

Хуков нет.

Возвращает

null. Функция ничего не возвращает, просто регистрирует расположение меню.

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

<?php register_nav_menu( $location, $description ); ?>
$location(строка) (обязательный)
Идентификатор расположения меню, как слаг - литая строка.
$description(строка) (обязательный)
Описание области меню, которое будет отображаться в админке.

Примеры

8

#1 Пример регистрации меню

Используем этот код в файле темы functions.php.

add_action( 'after_setup_theme', 'theme_register_nav_menu' );

function theme_register_nav_menu() {
	register_nav_menu( 'primary', 'Primary Menu' );
}

После того, как меню зарегистрировано, зайдите в админку и добавьте в него элементы, а затем выведите его в шаблоне с помощью wp_nav_menu().

Список изменений

С версии 3.0.0 Введена.

Код register_nav_menu() WP 6.9.1

wp-includes/nav-menu.php 
function register_nav_menu( $location, $description ) {
	register_nav_menus( array( $location => $description ) );
}

nav_menu (меню навигации)

Другие функции темы