wp_get_nav_menus │ filter-hook │ WP 3.0.0

Filters the navigation menu objects being returned.

Usage

add_filter( 'wp_get_nav_menus', 'wp_kama_get_nav_menus_filter', 10, 2 );

/**
 * Function for `wp_get_nav_menus` filter-hook.
 * 
 * @param WP_Term[] $menus An array of menu objects.
 * @param array     $args  An array of arguments used to retrieve menu objects.
 *
 * @return WP_Term[]
 */
function wp_kama_get_nav_menus_filter( $menus, $args ){

	// filter...
	return $menus;
}

$menus(WP_Term[])

An array of menu objects.

$args(array)

An array of arguments used to retrieve menu objects.

Changelog

Where the hook is called

return apply_filters( 'wp_get_nav_menus', get_terms( $args ), $args );

Where the hook is used in WordPress

add_filter( 'wp_get_nav_menus', array( $this, 'filter_wp_get_nav_menus' ), 10, 2 );