register_nav_menu

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

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

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

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

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

Хуков нет.

Возвращает

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

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

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

Примеры

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

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

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

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

Код из


wp-includes/nav-menu.php

WP 4.7.2

<?php
function register_nav_menu( $location, $description ) {
	register_nav_menus( array( $location => $description ) );
}

Комментарии:


Оставить комментарий

Your email address will not be published. Required fields are marked *