如何在WordPress中实现指定的自定义URL结构？

要实现你想要的example.com/awards/oscars/year/2011和example.com/awards/oscars/best-actor/这类URL结构，我们需要从CPT/分类法注册、Rewrite规则配置、模板加载这几个核心环节入手，一步步来：

1. 调整CPT与分类法的注册代码 #

首先要确保自定义文章类型和分类法的Rewrite基础设置正确，避免和WordPress默认规则冲突：

注册Awards自定义文章类型 #

function register_awards_cpt() {
    $args = array(
        'public' => true,
        'label'  => 'Awards',
        'supports' => array('title', 'editor', 'thumbnail'), // 按需添加支持的功能
        'rewrite' => array(
            'slug' => 'awards',
            'with_front' => false, // 去掉WordPress默认的前缀（比如/blog/）
        ),
    );
    register_post_type( 'awards', $args );
}
add_action( 'init', 'register_awards_cpt' );

注册三个自定义分类法 #

注册时要禁用默认的Rewrite规则，因为我们要把分类法嵌入到CPT的URL结构里，而不是用独立的分类URL：

// 注册Award Giver分类法
function register_award_giver_tax() {
    $args = array(
        'hierarchical' => true,
        'label' => 'Award Giver',
        'rewrite' => false, // 禁用默认规则，后续自定义
        'show_admin_column' => true,
    );
    register_taxonomy( 'awards-giver', 'awards', $args );
}
add_action( 'init', 'register_award_giver_tax' );

// 注册Award Types分类法
function register_award_type_tax() {
    $args = array(
        'hierarchical' => true,
        'label' => 'Awards Types',
        'rewrite' => false,
        'show_admin_column' => true,
    );
    register_taxonomy( 'award-type', 'awards', $args );
}
add_action( 'init', 'register_award_type_tax' );

// 注册Award Year分类法
function register_award_year_tax() {
    $args = array(
        'hierarchical' => true,
        'label' => 'Award Year',
        'rewrite' => false,
        'show_admin_column' => true,
    );
    register_taxonomy( 'award-year', 'awards', $args );
}
add_action( 'init', 'register_award_year_tax' );

2. 注册自定义Query变量 #

WordPress默认不会识别我们的分类法参数，需要把它们加入允许的查询变量列表：

function add_award_query_vars( $vars ) {
    $vars[] = 'awards-giver';
    $vars[] = 'award-type';
    $vars[] = 'award-year';
    return $vars;
}
add_filter( 'query_vars', 'add_award_query_vars' );

3. 添加自定义Rewrite规则 #

这是实现自定义URL的核心，我们要告诉WordPress如何解析目标URL，映射到对应的查询参数：

function add_award_rewrite_rules() {
    // 规则1: 匹配 /awards/{颁奖礼别名}/year/{年份}
    add_rewrite_rule(
        '^awards/([^/]+)/year/([0-9]+)/?$',
        'index.php?post_type=awards&awards-giver=$matches[1]&award-year=$matches[2]',
        'top' // 让这个规则优先于默认规则
    );

    // 规则2: 匹配 /awards/{颁奖礼别名}/{奖项类型别名}
    add_rewrite_rule(
        '^awards/([^/]+)/([^/]+)/?$',
        'index.php?post_type=awards&awards-giver=$matches[1]&award-type=$matches[2]',
        'top'
    );
}
add_action( 'init', 'add_award_rewrite_rules' );

4. 配置模板加载逻辑 #

现在WordPress能解析URL了，但需要指定对应的模板来展示内容。我们通过template_include过滤器来匹配场景，加载自定义模板：

function award_template_include( $template ) {
    $post_type = get_query_var( 'post_type' );
    $giver_slug = get_query_var( 'awards-giver' );
    $type_slug = get_query_var( 'award-type' );
    $year_slug = get_query_var( 'award-year' );

    // 仅处理Awards相关的查询
    if ( $post_type === 'awards' ) {
        // 场景1: 某颁奖礼某一年的奖项列表
        if ( $giver_slug && $year_slug ) {
            $custom_template = locate_template( 'archive-awards-year.php' );
            if ( $custom_template ) return $custom_template;
        }
        // 场景2: 某颁奖礼某类型的跨年份获奖者列表
        elseif ( $giver_slug && $type_slug ) {
            $custom_template = locate_template( 'archive-awards-type.php' );
            if ( $custom_template ) return $custom_template;
        }
    }

    // 没有自定义模板时返回默认模板
    return $template;
}
add_filter( 'template_include', 'award_template_include' );

创建对应模板文件 #

在你的主题目录下创建两个模板文件：

• archive-awards-year.php：展示某颁奖礼某一年的所有奖项
• archive-awards-type.php：展示某颁奖礼某类型的所有年份获奖者

举个archive-awards-type.php的示例：

<?php get_header(); ?>

<?php
$giver_term = get_term_by( 'slug', get_query_var('awards-giver'), 'awards-giver' );
$type_term = get_term_by( 'slug', get_query_var('award-type'), 'award-type' );
?>

<h1><?php echo $giver_term->name; ?> - <?php echo $type_term->name; ?> 历届获奖者</h1>

<?php if ( have_posts() ) : ?>
    <div class="award-list">
        <?php while ( have_posts() ) : the_post(); ?>
            <?php $year_term = get_the_terms(get_the_ID(), 'award-year')[0]; ?>
            <article>
                <h3><?php the_title(); ?></h3>
                <p>年份: <?php echo $year_term->name; ?></p>
                <?php the_excerpt(); ?>
            </article>
        <?php endwhile; ?>
    </div>
<?php else : ?>
    <p>暂无相关获奖记录</p>
<?php endif; ?>

<?php get_footer(); ?>

5. 刷新Rewrite规则 #

最后一步必须做，添加完规则后要刷新WordPress的Rewrite规则才能生效：

1. 登录WordPress后台，进入设置 → 固定链接
2. 不需要修改任何设置，直接点击保存更改按钮即可（这会触发规则刷新）

或者你可以在主题/插件激活时自动刷新规则（仅在激活时调用，不要每次加载都调用）：

function activate_award_setup() {
    register_awards_cpt();
    register_award_giver_tax();
    register_award_type_tax();
    register_award_year_tax();
    add_award_rewrite_rules();
    flush_rewrite_rules();
}
register_activation_hook( __FILE__, 'activate_award_setup' );

• 确保分类法的别名（slug）和URL中使用的一致，比如Oscars的slug设为oscars，Best Actor的slug设为best-actor
• 固定链接必须设置为非默认模式（比如“文章名”模式），默认的“朴素”模式不支持自定义Rewrite规则
• 如果WordPress安装在子目录下，需要调整Rewrite规则的开头，比如把^awards/改成^你的子目录名/awards/

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