为WordPress自定义文章类型单页配置二级模板与URL结构

你的代码存在两个核心问题，导致/dbc/路径返回404：

1. 重写规则的目标URL格式错误，且缺少可靠的自定义标记来区分模板场景
2. 模板判断依赖$_SERVER['REQUEST_URI']稳定性不足，获取文章类型的方式有误

修正后的完整代码 #

// 注册自定义查询变量，标记当前是否为dbc路径请求
function register_dbc_query_var($vars) {
    $vars[] = 'is_dbc';
    return $vars;
}
add_filter('query_vars', 'register_dbc_query_var');

// 添加自定义重写规则
function custom_post_type_rewrite_rules() {
    $post_type = 'team-bio';
    
    // 保留原team-bio路径规则（若自定义文章类型注册时已配置rewrite，可省略此条）
    add_rewrite_rule('^team-bio/([^/]+)/?$', 'index.php?post_type=' . $post_type . '&name=$matches[1]', 'top');
    
    // dbc路径规则，通过is_dbc变量标记请求场景
    add_rewrite_rule('^dbc/([^/]+)/?$', 'index.php?post_type=' . $post_type . '&name=$matches[1]&is_dbc=1', 'top');
}
add_action('init', 'custom_post_type_rewrite_rules');

// 自定义模板加载逻辑
function custom_post_type_templates($template) {
    $post_type = 'team-bio';
    $current_post_type = get_post_type();
    
    // 匹配dbc路径的模板
    if ($current_post_type === $post_type && get_query_var('is_dbc')) {
        $dbc_template = get_template_directory() . '/templates/dbc.twig';
        if (file_exists($dbc_template)) {
            return $dbc_template;
        }
    }
    // 匹配原team-bio路径的模板
    elseif ($current_post_type === $post_type) {
        $team_template = get_template_directory() . '/templates/single-team-bio.twig';
        if (file_exists($team_template)) {
            return $team_template;
        }
    }
    
    return $template;
}
add_filter('single_template', 'custom_post_type_templates');

关键修正说明 #

• 重写规则修正：去掉目标URL中错误的index.php/dbc/路径格式，新增is_dbc=1自定义查询变量，用来精准识别/dbc/路径的请求
• 查询变量注册：通过query_vars过滤器注册is_dbc，确保WordPress能识别并传递这个自定义参数
• 模板判断优化：用get_post_type()获取当前文章类型，结合get_query_var('is_dbc')判断模板，避免$_SERVER['REQUEST_URI']带来的子目录、URL参数干扰问题
• 文件存在校验：添加file_exists()判断，防止模板文件不存在时触发错误

最后必做步骤 #

代码添加完成后，进入WordPress后台设置→固定链接，无需修改任何配置，直接点击「保存更改」，刷新WordPress重写规则缓存，新规则才能生效。

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