wp_nav_menu
Позволяет изменить HTML код меню навигации перед его выводом на экран.
Примерное содержимое:
<div class="menu-moyo-menyu-container"> <ul id="menu-moyo-menyu" class="menu"> <li id="menu-item-265" class="menu-item menu-item-type-post_type menu-item-object-page menu-item-265"> <a href="http://wp-test.ru/post-99">Обратная связь</a> </li> <li id="menu-item-266" class="menu-item menu-item-type-post_type menu-item-object-page menu-item-266"> <a href="http://wp-test.ru/post-98">Все статьи</a> </li> <li id="menu-item-267" class="menu-item menu-item-type-post_type menu-item-object-page menu-item-267"> <a href="http://wp-test.ru/post-97">Карта сайта</a> </li> </ul> </div>
Использование
add_filter( 'wp_nav_menu', 'wp_kama_nav_menu_filter', 10, 2 ); /** * Function for `wp_nav_menu` filter-hook. * * @param string $nav_menu The HTML content for the navigation menu. * @param stdClass $args An object containing wp_nav_menu() arguments. * * @return string */ function wp_kama_nav_menu_filter( $nav_menu, $args ){ // filter... return $nav_menu; }
- $nav_menu(строка)
- HTML содержимое меню.
- $args(stdClass)
- Объект с параметрами, переданными функции wp_nav_menu().
Примеры
#1 Обернём все меню специальным контейнером
add_filter( 'wp_nav_menu', 'change_wp_nav_menu', 10, 2 ); function change_wp_nav_menu( $nav_menu, $args ) { return '<section class="menu-wrap">' . $nav_menu . '</section>'; }
Список изменений
С версии 3.0.0 | Введена. |
Где вызывается хук
wp_nav_menu
wp-includes/nav-menu-template.php 307
$nav_menu = apply_filters( 'wp_nav_menu', $nav_menu, $args );
Где используется хук в WordPress
wp-includes/class-wp-customize-nav-menus.php 1339
add_filter( 'wp_nav_menu', array( $this, 'filter_wp_nav_menu' ), 10, 2 );