wp_nav_menuхук-фильтрWP 3.0.0

Позволяет изменить 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().

Примеры

6

#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_nav_menu
wp-includes/nav-menu-template.php 302
$nav_menu = apply_filters( 'wp_nav_menu', $nav_menu, $args );

Где используется хук в WordPress

wp-includes/class-wp-customize-nav-menus.php 1350
add_filter( 'wp_nav_menu', array( $this, 'filter_wp_nav_menu' ), 10, 2 );