如何根据用户角色显示自定义WooCommerce my-account.php页面

你之前的方案存在三个核心问题，无法正常运行：

• 自定义判断函数仅校验了org_manager角色，未覆盖beta_user等其他需要访问新仪表盘的角色
• 存在无限递归bug：你在子主题的woocommerce/my-account.php文件内，判断符合角色后又加载同路径的文件本身，会触发PHP反复执行当前文件直到内存溢出，直接报500错误
• 写死服务器绝对路径的写法兼容性极差，站点更换目录、迁移服务器后会直接找不到模板文件

用WooCommerce原生提供的模板定位钩子做加载逻辑切换，从模板加载入口做判断，完全避免递归问题，不需要在模板文件里写套娃逻辑。

1. 完善角色判断逻辑 #

将以下代码放到子主题的functions.php文件中：

/**
 * 校验当前用户是否有权限访问新版仪表盘
 * 允许角色：org_manager、beta_user
 */
function is_new_dashboard_allowed() {
    // 未登录用户直接走默认模板
    if ( ! is_user_logged_in() ) {
        return false;
    }
    $current_user = wp_get_current_user();
    $allowed_roles = [ 'org_manager', 'beta_user' ];
    // 用户拥有任意一个允许角色即返回true
    return ! empty( array_intersect( $allowed_roles, $current_user->roles ) );
}

2. 添加模板切换钩子 #

同样在子主题functions.php中添加以下代码，用WooCommerce原生过滤器切换模板：

add_filter( 'woocommerce_locate_template', 'custom_switch_myaccount_template', 20, 3 );
function custom_switch_myaccount_template( $template, $template_name, $template_path ) {
    // 仅处理我的账户主模板，不影响其他WooCommerce模板
    if ( 'myaccount/my-account.php' !== $template_name ) {
        return $template;
    }
    // 有权限用户加载新版仪表盘模板
    if ( is_new_dashboard_allowed() ) {
        // 新版模板单独命名，避免和默认模板重名
        $new_dashboard_path = get_stylesheet_directory() . '/woocommerce/my-account-new-dashboard.php';
        if ( file_exists( $new_dashboard_path ) ) {
            return $new_dashboard_path;
        }
    }
    // 无权限用户返回默认模板（子主题有常规覆写就走子主题，没有就走插件原生模板）
    return $template;
}

3. 模板文件存放规范 #

• 将你重构完成的新版仪表盘代码，放到子主题的woocommerce/my-account-new-dashboard.php文件中，绝对不要和默认覆写的my-account.php重名，从根源避免递归问题
• 删除你之前在子主题woocommerce/my-account.php里写的套娃判断逻辑，不需要保留这个文件也可以，钩子会自动完成模板加载判断
• 未分配对应角色的用户、未登录用户访问时，会自动加载WooCommerce插件原生的我的账户页面，完全符合需求

• 后续如果需要新增可访问新版仪表盘的角色，直接往$allowed_roles数组里添加对应角色的slug即可
• 上线前清理站点缓存、WooCommerce模板缓存，避免旧缓存导致逻辑不生效
• 所有模板路径调用统一用get_stylesheet_directory()获取子主题目录，不要写死绝对路径，保证站点迁移、换域名时逻辑正常

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