如何基于Taxonomy为Custom Post Type创建不同动态页面并保留默认页？

核心需求 #

保留自定义文章类型courses的默认单页（如http://example.com/courses/python/），同时新增带分类法level的动态子页面（如http://example.com/courses/python/advanced/）。

实现步骤 #

1. 添加重写规则

在主题的functions.php中添加以下代码，让WordPress识别新的URL结构：

function custom_course_level_rewrite_rule() {
    // 匹配 /courses/{课程别名}/{level别名}/ 的URL结构
    add_rewrite_rule(
        'courses/([^/]+)/([^/]+)/?$',
        'index.php?post_type=courses&name=$matches[1]&level=$matches[2]',
        'top'
    );
}
add_action('init', 'custom_course_level_rewrite_rule');

添加后，进入WordPress后台「设置」→「固定链接」，点击「保存更改」刷新重写规则。

2. 注册查询变量

让WordPress允许读取level这个自定义查询参数，避免被系统过滤：

function custom_course_level_query_var($vars) {
    $vars[] = 'level';
    return $vars;
}
add_filter('query_vars', 'custom_course_level_query_var');

3. 创建自定义模板

在主题目录下新建模板文件single-courses-level.php，用于渲染带level参数的页面：

<?php
// 获取当前课程文章和level参数
$course = get_post();
$level = get_query_var('level');

// 验证level是否为合法分类项
$valid_levels = ['beginner', 'advanced', 'professional'];
if (!in_array($level, $valid_levels)) {
    // 非法level返回404页面
    global $wp_query;
    $wp_query->set_404();
    status_header(404);
    get_template_part('404');
    exit;
}

// 加载模板头部
get_header();

// 输出课程标题和当前阶段
echo '<h1>' . get_the_title($course) . ' - ' . ucfirst($level) . '</h1>';

// 此处添加对应level的内容逻辑，示例为读取自定义字段
$level_content = get_post_meta($course->ID, 'course_' . $level . '_content', true);
if ($level_content) {
    echo '<div class="course-level-content">' . wpautop($level_content) . '</div>';
} else {
    echo '<p>暂无该阶段内容</p>';
}

// 加载模板尾部
get_footer();
?>

4. 模板优先级控制

WordPress会优先匹配更具体的模板：访问带level的URL时，自动使用single-courses-level.php；访问默认URL时，仍使用原有的single-courses.php（无该文件则用single.php）。

补充说明 #

• 若需让level分类项支持自定义别名，可在注册level分类法时调整rewrite参数，但本次实现通过重写规则直接映射，无需修改原分类法设置。
• 如需展示该课程下属于当前level的关联内容，可在模板中使用WP_Query进行精准查询。

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