register_nav_menus() WP 3.0
Регистрируется сразу несколько расположений меню, к которым затем прикрепляются меню.
Произвольные меню настраиваются в админ-панели и выводятся в шаблоне функцией wp_nav_menu().
При создании меню в него можно добавить разные ссылки: на рубрики, метки, страницы, посты, внешние ссылки и т.д.
Функцию принято вызывать во время события after_setup_theme.
Эта функция автоматически регистрирует поддержку навигационных меню для темы, т.е. используя эту функцию нет необходимости предварительно вызывать функцию: add_theme_support( 'menus' );
В админ-панели в настройках меню, можно включить "расширенные настройки", которые позволят указать различные атрибуты у HTML тегов ссылок в меню.
register_nav_menu()Хуков нет.
Возвращает
Функция ничего не возвращает.
Использование
register_nav_menus( $locations );
- $locations(массив) (обязательный)
- Массив с названиями (ключи массива) и описаниями (значения ключей) каждого создаваемого меню.
Примеры
#1. Пример, регистрации сразу двух меню.
Такая регистрация сразу включает поддержку навигационных меню у темы.
add_action( 'after_setup_theme', function(){
register_nav_menus( [
'header_menu' => 'Меню в шапке',
'footer_menu' => 'Меню в подвале'
] );
} );
Выводить меню в шаблоне будем функцией wp_nav_menu().
Заметки
- Global. Массив.
$_wp_registered_nav_menus
Список изменений
| С версии 3.0.0 | Введена. |
Код register nav menus:
wp-includes/nav-menu.php
WP 5.2.2
Cвязанные функции
Из метки: nav_menu (меню навигации)
- _wp_menu_item_classes_by_context()
- get_nav_menu_locations()
- has_nav_menu()
- is_nav_menu()
- register_nav_menu()
Еще из раздела: Другие функции темы
- add_theme_support()
- bloginfo()
- body_class()
- current_theme_supports()
- get_custom_header_markup()
- get_custom_logo()
- get_header_image()
- get_header_image_tag()
- get_header_textcolor()
- get_header_video_url()
- get_page_templates()
- get_post_class()
- get_query_template()
- get_stylesheet()
- get_template()
- get_theme_mod()
- get_theme_mods()
- get_theme_root()
- has_custom_logo()
- has_header_image()
- has_header_video()
- is_child_theme()
- is_header_video_active()
- is_multi_author()
- post_class()
- register_theme_directory()
- remove_theme_mod()
- remove_theme_mods()
- remove_theme_support()
- search_theme_directories()
- set_theme_mod()
- single_month_title()
Доброго времени суток. Регистрирую меню с помощью данной функции, локализуя их
В админке названия меню не локализуются, отображаются как 'Primary menu', 'Footer menu', хотя в файле локализации они естественно переведены. Локализация подключена, работает везде по сайту, всё переводится корректно, кроме этих названий меню
Что странно, что в той же twentyfifteen таким же образом подключены меню и они отображаются на русском.
Может сможете что-то подсказать, в чём причина?
Разобрался, добавлю, может кто на такие же грабли наступит. Функция не была повешена на событие - в результате меню регистрировалось и работало, но не переводилось. Перенес вызов функции в событие 'after_setup_theme' - перевод заработал.
Спасибо за вопрос и ответ на него. Дополнил пример в описании.
Зарегистрировал 2 меню - в шапке и подвале, выявил проблему - в обоих меню отображаются одинаковые пункты, хотя должны быть разные по замыслу
Код регистрации меню в functions.php:
add_theme_support('menus'); add_action('after_setup_theme', function(){ register_nav_menus([ 'primary' => 'Главное шапке', 'footer_menu' => 'Меню в подвале' ] ); });Код вывода меню в шапке:
Код вывода меню в подвале:
Возможно, причина кроется в этом куске (были проблемы с отображением меню в шапке -пункты прилипали друг к другу)
//Добавление класса .nav-link к ссылкам из пунктов верхнего меню function add_class_to_all_menu_anchors( $atts ) { $atts['class'] = 'nav-link'; return $atts; } add_filter( 'nav_menu_link_attributes', 'add_class_to_all_menu_anchors', 10 );В общем, буду рад вашей помощи
Если используется
register_nav_menus, то нет смысла уже писатьadd_theme_support('menus'). Идём дальше - что за параметрtheme-location? Может всё-таки theme_location? Для футера ID области менюfooter_menu, а в wp_nav_menu передаётся footer.Приветствую. Сделал вот такую вещь
add_action('after_setup_theme', 'enqueue_menus'); $menus = array( 'header_nav' => 'Навигация', 'header_top_menu' => 'Верхнее меню в шапке' ); function enqueue_menus() { register_nav_menus($menus); }В результате выбивает ошибку Warning : array_merge(): Argument #2 is not an array in ... и т.д в какой то файл ведет wp-includes/nav-menu.php on line 93
Вопрос, почему?
Привет. Выучите основы PHP, в данном случае раздел видимости переменных.
Надо так (рекомендую):
add_action('after_setup_theme', 'enqueue_menus'); function enqueue_menus() { $menus = array( 'header_nav' => 'Навигация', 'header_top_menu' => 'Верхнее меню в шапке' ); register_nav_menus( $menus ); }Или хотя бы так (не рекомендую):
add_action('after_setup_theme', 'enqueue_menus'); $menus = array( 'header_nav' => 'Навигация', 'header_top_menu' => 'Верхнее меню в шапке' ); function enqueue_menus() { register_nav_menus( $GLOBALS['menus'] ); }Спасибо!