nav_menu_items_(post_type_name)_recent filter-hookWP 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:

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

Since 4.3.0 Introduced.
Since 4.9.0 Added the $recent_args parameter.

Where the hook is called

wp_nav_menu_item_post_type_meta_box()
nav_menu_items_(post_type_name)_recent
wp-admin/includes/nav-menu.php 560
$most_recent = apply_filters( "nav_menu_items_{$post_type_name}_recent", $most_recent, $args, $box, $recent_args );

Where the hook is used in WordPress

Usage not found.