register_nav_menu()
Реєструється одне розташування/місце меню, до якого в адмінці потім прикріплюються меню.
Таке меню зручне тим, що його можна дуже гнучко редагувати в адмін панелі, додаючи до нього посилання на будь-які розділи та сторінки сайту, а також будь-які інші посилання. Меню виводиться у шаблоні функцією 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
(рядок) (обов’язковий) - Опис області меню, яке відображатиметься в адмінці.
Приклади
#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() register nav menu WP 6.0.2
function register_nav_menu( $location, $description ) {
register_nav_menus( array( $location => $description ) );
}