WordPress后台子菜单链接排序异常问题求助

我来帮你分析下这个问题——这种子菜单排序混乱的情况，大概率不是WordPress的bug，而是咱们在钩子执行优先级或者子菜单添加逻辑上没处理好，下面给你拆解原因和解决办法：

首先得明确WordPress处理后台子菜单排序的两个关键点：

• admin_menu钩子的执行优先级：你在不同类里调用add_action("admin_menu", ...)，如果没指定钩子优先级（第三个参数），默认都是10。但如果这些类的初始化时机不同，或者有的钩子被设置了更高/更低的优先级，就会导致子菜单的添加顺序不一致——WordPress默认的子菜单排序逻辑，会先依赖添加顺序，再尝试按position参数调整，这很容易出问题。
• add_submenu_page的position参数逻辑：这个参数是用来指定子菜单项的显示位置，但WordPress并不会在每次添加子菜单时就全局重新排序，而是先按添加顺序把菜单项存入数组，最后在渲染菜单时才调用排序函数。如果某些子菜单的position参数被意外覆盖，或者钩子执行顺序导致排序函数没正确处理，就会出现像你遇到的40排在50后面的混乱情况。

1. 统一所有子菜单的钩子优先级 #

确保所有添加子菜单的add_action调用使用相同的优先级，避免因为钩子执行顺序导致的添加顺序混乱。比如统一设置为10：

// 每个类里的add_action都明确指定优先级
add_action("admin_menu", array($this,"a_function"), 10);

这样所有子菜单都会在同一阶段被添加，WordPress的默认排序函数就能正确按position参数排序。

2. 手动强制排序子菜单 #

如果统一优先级后还是有问题，可以在所有子菜单添加完成后，手动对父菜单的子菜单项进行排序。在你的插件主文件里添加以下代码：

add_action('admin_menu', 'custom_sort_my_plugin_submenu', 999);
function custom_sort_my_plugin_submenu() {
    global $submenu;
    $parent_slug = 'a_parent_slug'; // 替换成你的父菜单slug
    
    if (isset($submenu[$parent_slug])) {
        // 按position参数从小到大排序
        usort($submenu[$parent_slug], function($item_a, $item_b) {
            // 获取每个菜单项的position，默认设为极大值确保未设置的排在最后
            $pos_a = isset($item_a[4]) ? (int)$item_a[4] : PHP_INT_MAX;
            $pos_b = isset($item_b[4]) ? (int)$item_b[4] : PHP_INT_MAX;
            
            return $pos_a - $pos_b;
        });
    }
}

这个函数会在admin_menu钩子的最后阶段（优先级999，确保所有子菜单都已添加）执行，手动按position数值排序，彻底解决顺序混乱的问题。

如果按照上面的方法处理后，排序仍然异常（比如确认所有position参数正确、钩子优先级统一，但排序还是不对），那有可能是WordPress核心的排序逻辑出现了bug，这时候可以去WordPress Trac提交问题。但绝大多数情况下，这类问题都是钩子优先级或添加顺序导致的，先按上面的方案排查解决即可。

内容的提问来源于stack exchange，提问作者Scott L