概述

nav_menu_items_{$post_type_name} 是一个 WordPress 过滤器钩子，用于控制当前文章类型菜单项元框中“查看全部”标签页显示的帖子列表。它允许开发者基于文章类型动态过滤帖子数据。

关键要点

• 钩子名称动态部分 $post_type_name 对应当前文章类型的 slug，例如 nav_menu_items_post 或 nav_menu_items_page。
• 参数包括 $posts（帖子数组，可能包含 WP_Post 对象或“伪”帖子对象）、$args（WP_Query 参数数组）和 $post_type（当前文章类型对象）。
• 从 WordPress 4.6.0 起，$post_type 参数接受 WP_Post_Type 对象，增强了类型安全性。

代码示例

$posts = apply_filters(
    "nav_menu_items_{$post_type_name}",
    $posts,
    $args,
    $post_type
);

注意事项

• 此钩子主要用于 wp_nav_menu_item_post_type_meta_box() 函数中，影响后台菜单管理界面。
• 开发者应确保过滤逻辑兼容不同文章类型，避免破坏菜单项的正常显示。