wp_get_nav_menu_items │ filter-hook │ WP 3.0.0

Filters the navigation menu items being returned.

Usage

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(array)

An array of menu item post objects.

$menu(object)

The menu object.

$args(array)

An array of arguments used to retrieve menu item objects.

Changelog

Where the hook is called

return apply_filters( 'wp_get_nav_menu_items', $items, $menu, $args );

Where the hook is used in WordPress

add_filter( 'wp_get_nav_menu_items', array( $this, 'filter_wp_get_nav_menu_items' ), 10, 3 );

add_filter( 'wp_get_nav_menu_items', array( __CLASS__, 'sort_wp_get_nav_menu_items' ), 1000, 3 );