nav_menu_items_(post_type_name)_recent │ filter-hook │ WP 4.3.0

Filters the posts displayed in the 'Most Recent' tab of the current post type's menu items meta box.

The dynamic portion of the hook name, $post_type_name, refers to the post type name.

Possible hook names include:

• nav_menu_items_post_recent
• nav_menu_items_page_recent

Usage

add_filter( 'nav_menu_items_(post_type_name)_recent', 'wp_kama_nav_menu_items_post_type_name_recent_filter', 10, 4 );

/**
 * Function for `nav_menu_items_(post_type_name)_recent` filter-hook.
 * 
 * @param WP_Post[] $most_recent An array of post objects being listed.
 * @param array     $args        An array of `WP_Query` arguments for the meta box.
 * @param array     $box         Arguments passed to `wp_nav_menu_item_post_type_meta_box()`.
 * @param array     $recent_args An array of `WP_Query` arguments for 'Most Recent' tab.
 *
 * @return WP_Post[]
 */
function wp_kama_nav_menu_items_post_type_name_recent_filter( $most_recent, $args, $box, $recent_args ){

	// filter...
	return $most_recent;
}

$most_recent(WP_Post[])

An array of post objects being listed.

$args(array)

An array of WP_Query arguments for the meta box.

$box(array)

Arguments passed to wp_nav_menu_item_post_type_meta_box().

$recent_args(array)

An array of WP_Query arguments for 'Most Recent' tab.

Changelog

Where the hook is called

$most_recent = apply_filters(
	"nav_menu_items_{$post_type_name}_recent",
	$most_recent,
	$args,
	$box,
	$recent_args
);

Where the hook is used in WordPress