如何修改ACF创建的WordPress自定义文章类型固定链接（移除CPT slug）

关于ACF插件的说明 #

ACF（Advanced Custom Fields）本身无法直接控制自定义文章类型（CPT）的URL结构，因为ACF的核心功能是扩展内容的自定义字段，而CPT的注册、固定链接规则属于WordPress核心的自定义文章类型系统范畴。

修改CPT注册代码实现目标URL结构 #

要实现https://yourwebsite.com/slug的URL格式，需要在注册自定义文章类型时调整rewrite参数，并添加额外的重写规则和查询调整来避免与默认文章、页面冲突。

步骤1：调整CPT注册代码 #

在注册CPT时，修改rewrite参数，将slug设为根路径，并关闭with_front：

function register_custom_post_type() {
    $args = array(
        'public' => true,
        'label'  => '自定义文章类型',
        'rewrite' => array(
            'slug' => '/', // 设置为根路径
            'with_front' => false, // 不包含固定链接设置中的前缀
        ),
        // 其他CPT参数（如supports、hierarchical等）
    );
    register_post_type( 'custom_post_type', $args );
}
add_action( 'init', 'register_custom_post_type' );

步骤2：添加重写规则并调整查询 #

仅修改注册参数会导致与默认文章、页面的URL冲突，需要添加重写规则并调整查询优先级：

// 添加重写规则，匹配根路径下的slug
function add_custom_post_type_rewrite_rule() {
    add_rewrite_rule(
        '^([^/]+)/?$',
        'index.php?custom_post_type=$matches[1]',
        'top' // 设置为最高优先级，优先匹配CPT
    );
}
add_action( 'init', 'add_custom_post_type_rewrite_rule' );

// 调整查询，确保WordPress正确识别CPT内容
function adjust_custom_post_type_query( $query ) {
    if ( ! is_admin() && $query->is_main_query() && ! $query->is_home() && ! $query->is_page() && ! $query->is_single() ) {
        $query->set( 'post_type', array( 'custom_post_type', 'post', 'page' ) );
    }
}
add_action( 'pre_get_posts', 'adjust_custom_post_type_query' );

步骤3：刷新固定链接设置 #

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

注意事项 #

• Slug唯一性：确保自定义文章类型的slug与现有页面、文章的slug不重复，否则会出现内容冲突（优先级由重写规则的top参数决定）。
• 多CPT处理：如果有多个需要根路径slug的CPT，需要更复杂的重写规则来区分（比如通过分类或其他标识），避免互相冲突。
• 缓存问题：如果使用了缓存插件，修改后需要清除缓存才能生效。

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