wp_nav_menu_items
Позволяет изменить уже сгенерированный HTML код пунктов меню.
Через фильтр проходит примерно следующее содержимое:
<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>
Использование
add_filter( 'wp_nav_menu_items', 'wp_kama_nav_menu_items_filter', 10, 2 );
/**
* Function for `wp_nav_menu_items` filter-hook.
*
* @param string $items The HTML list content for the menu items.
* @param stdClass $args An object containing wp_nav_menu() arguments.
*
* @return string
*/
function wp_kama_nav_menu_items_filter( $items, $args ){
// filter...
return $items;
}
- $items(строка)
- HTML код пунктов меню.
- $args(stdClass)
- Объект с параметрами, переданными функции wp_nav_menu().
Примеры
#1 Добавим форму поиска в меню
В меню, прикрепленное к области меню header-menu, добавим пункт с формой поиска.
add_filter( 'wp_nav_menu_items', 'change_nav_menu_items', 10, 2 );
function change_nav_menu_items( $items, $args ) {
if ( 'header-menu' == $args->theme_location ) {
$items .= '<li>' . get_search_form( false ) . '</li>';
}
return $items;
}
Список изменений
| С версии 3.0.0 | Введена. |
Где вызывается хук
wp_nav_menu_items
wp-includes/nav-menu-template.php 267
$items = apply_filters( 'wp_nav_menu_items', $items, $args );
