如何移除WordPress自定义文章类型Landing Page的URL Slug？

我懂你想要的效果——把Landing Page这个CPT的URL里的landing-page slug去掉，让文章直接以http://somedomain.com/test/这样的形式访问，之前试的两种rewrite参数设置没生效确实头疼，我给你一步步搞定这个问题：

为什么之前的方法没生效？ #

直接把slug设为/或者false的话，WordPress的重写规则引擎没办法正确解析，而且很容易和默认的Page类型产生冲突，另外刷新重写规则这一步很多人会漏掉，这也是设置不生效的常见原因。

正确的解决方案步骤 #

1. 重新配置CPT的注册参数 #

修改你的register_post_type函数，用以下参数来注册Landing Page：

function register_landing_page_cpt() {
    $args = array(
        'label'               => 'Landing Pages',
        'public'              => true,
        'publicly_queryable'  => true,
        'show_ui'             => true,
        'show_in_menu'        => true,
        'query_var'           => true,
        // 关键的rewrite配置
        'rewrite'             => array(
            'slug'         => '', // 空字符串来移除slug
            'with_front'   => false // 不要包含固定链接结构的前缀
        ),
        'capability_type'     => 'post',
        'has_archive'         => false, // 禁用归档页面，避免和其他页面冲突
        'hierarchical'        => false,
        'menu_position'       => null,
        'supports'            => array('title', 'editor', 'thumbnail')
    );
    register_post_type('landing_page', $args);
}
add_action('init', 'register_landing_page_cpt');

2. 强制刷新WordPress重写规则 #

这一步非常关键，不刷新的话新的规则不会生效：

• 登录WordPress后台，进入设置 → 固定链接
• 不用修改任何选项，直接点击「保存更改」按钮即可，WordPress会自动生成新的重写规则

3. 处理CPT与默认Page的冲突问题 #

如果你的Landing Page文章slug和已有的Page（页面）slug重复，WordPress会优先显示Page内容，我们可以通过钩子调整查询优先级，让CPT先被匹配：

function prioritize_landing_page_queries($query) {
    // 只处理前端的主查询，跳过后台操作
    if (!is_admin() && $query->is_main_query()) {
        // 当访问单篇内容时，检查是否存在匹配slug的Landing Page文章
        if ($query->is_single()) {
            $target_slug = $query->get('name');
            // 查询是否有对应slug的Landing Page
            $matching_landing_page = get_posts(array(
                'post_type'      => 'landing_page',
                'name'           => $target_slug,
                'posts_per_page' => 1,
                'fields'         => 'ids' // 只获取ID，提高查询效率
            ));
            
            if (!empty($matching_landing_page)) {
                // 强制查询Landing Page类型
                $query->set('post_type', 'landing_page');
            }
        }
    }
}
add_action('pre_get_posts', 'prioritize_landing_page_queries');

额外注意事项 #

• 缓存问题：如果设置后还是没生效，检查服务器缓存或者WordPress缓存插件，清空缓存再测试
• 唯一slug：尽量保证Landing Page的slug和现有Post、Page的slug不重复，避免不必要的冲突
• 归档页面：如果确实需要Landing Page的归档页面，不要把has_archive设为false，但需要额外配置归档的URL规则，避免和其他页面冲突

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