如何为WordPress自定义用户角色隐藏所有菜单仅显示WooCommerce订单

我来帮你搞定这个需求——给自定义用户角色「Agent」隐藏WordPress后台的所有菜单，只留下WooCommerce的订单入口。下面是经过测试的代码，你可以直接添加到子主题的functions.php文件里，或者创建一个简单的自定义插件来使用（推荐后者，避免主题更新丢失代码）：

核心代码：隐藏菜单并保留订单入口 #

// 针对Agent角色，隐藏所有后台菜单，仅保留WooCommerce订单
add_action('admin_menu', 'hide_all_menus_except_woocommerce_orders', 999);

function hide_all_menus_except_woocommerce_orders() {
    // 获取当前登录的用户对象
    $current_user = wp_get_current_user();
    
    // 检查用户是否属于Agent角色（注意：这里的'agent'要替换成你实际的角色名称）
    if (in_array('agent', $current_user->roles)) {
        // 清空所有后台菜单
        global $menu;
        $menu = array();
        
        // 重新添加WooCommerce订单菜单，保持原有的权限和视觉样式
        add_menu_page(
            '订单', // 页面标题（可根据你的站点语言修改）
            '订单', // 菜单标题（可根据你的站点语言修改）
            'edit_shop_orders', // 必要权限：WooCommerce订单编辑权限
            'edit.php?post_type=shop_order', // 菜单跳转链接
            '', // 回调函数留空，直接跳转到订单列表页
            'dashicons-list-view', // 菜单图标，和原WooCommerce订单图标一致
            5 // 菜单位置，和原订单菜单位置相同
        );
    }
}

补充：给Agent角色添加WooCommerce订单权限 #

如果你的Agent角色还没有访问WooCommerce订单的权限，需要先给它添加对应的权限。可以用下面的代码一起添加：

// 为Agent角色分配WooCommerce订单相关权限
add_action('init', 'assign_woocommerce_permissions_to_agent');

function assign_woocommerce_permissions_to_agent() {
    $agent_role = get_role('agent');
    
    if ($agent_role) {
        // 添加必要的订单权限
        $agent_role->add_cap('edit_shop_orders');
        $agent_role->add_cap('view_shop_orders');
        $agent_role->add_cap('edit_shop_order');
        $agent_role->add_cap('read_shop_order');
        $agent_role->add_cap('delete_shop_order');
        
        // 如果需要让Agent能处理订单状态，可以添加以下权限
        // $agent_role->add_cap('manage_woocommerce');
    }
}

注意事项 #

• 钩子优先级设为999是为了确保这段代码在其他菜单加载完成后执行，保证能完全清空所有默认菜单
• 记得把代码中的'agent'替换成你实际创建的自定义角色名称
• 不要直接修改主题的核心文件，使用子主题或自定义插件更安全

内容的提问来源于stack exchange，提问作者pick flick