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

Filters the navigation menu items being returned.

Использование

add_filter( 'wp_get_nav_menu_items', 'wp_kama_get_nav_menu_items_filter', 10, 3 );

/**
 * Function for `wp_get_nav_menu_items` filter-hook.
 * 
 * @param array  $items An array of menu item post objects.
 * @param object $menu  The menu object.
 * @param array  $args  An array of arguments used to retrieve menu item objects.
 *
 * @return array
 */
function wp_kama_get_nav_menu_items_filter( $items, $menu, $args ){

	// filter...
	return $items;
}
$items(массив)
An array of menu item post objects.
$menu(объект)
The menu object.
$args(массив)
An array of arguments used to retrieve menu item objects.

Список изменений

С версии 3.0.0 Введена.

Где вызывается хук

wp_get_nav_menu_items()
wp_get_nav_menu_items
wp-includes/nav-menu.php 752
return apply_filters( 'wp_get_nav_menu_items', $items, $menu, $args );

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

wp-includes/customize/class-wp-customize-nav-menu-item-setting.php 454
add_filter( 'wp_get_nav_menu_items', array( $this, 'filter_wp_get_nav_menu_items' ), 10, 3 );
wp-includes/customize/class-wp-customize-nav-menu-item-setting.php 458
add_filter( 'wp_get_nav_menu_items', array( __CLASS__, 'sort_wp_get_nav_menu_items' ), 1000, 3 );