wp_get_nav_menu_object │ filter-hook │ WP 4.3.0

Filters the nav_menu term retrieved for wp_get_nav_menu_object().

Usage

add_filter( 'wp_get_nav_menu_object', 'wp_kama_get_nav_menu_object_filter', 10, 2 );

/**
 * Function for `wp_get_nav_menu_object` filter-hook.
 * 
 * @param WP_Term|false      $menu_obj Term from nav_menu taxonomy, or false if nothing had been found.
 * @param int|string|WP_Term $menu     The menu ID, slug, name, or object passed to wp_get_nav_menu_object().
 *
 * @return WP_Term|false
 */
function wp_kama_get_nav_menu_object_filter( $menu_obj, $menu ){

	// filter...
	return $menu_obj;
}

$menu_obj(WP_Term|false)

Term from nav_menu taxonomy, or false if nothing had been found.

$menu(int|string|WP_Term)

The menu ID, slug, name, or object passed to wp_get_nav_menu_object().

Changelog

Where the hook is called

return apply_filters( 'wp_get_nav_menu_object', $menu_obj, $menu );

Where the hook is used in WordPress

add_filter( 'wp_get_nav_menu_object', array( $this, 'filter_wp_get_nav_menu_object' ), 10, 2 );