---
canonical: https://meta.cyberforums.com/t/wpslug-acf-pro/2465
webpage: https://wpcy.com/community/t/2465-wpslug-acf-pro
language: zh-Hans
---

# 文派素格 (WPSlug) 修复 ACF Pro 兼容性问题

> 文派叶子支持论坛的只读副本，本页不能回复。
> 讨论原文：https://meta.cyberforums.com/t/wpslug-acf-pro/2465
> 网页版：https://wpcy.com/community/t/2465-wpslug-acf-pro

## 1 · wenpai

- 发布时间：2026年2月28日 15:02

问题描述
近期收到用户反馈，文派素格 (WPSlug) 插件与 Advanced Custom Fields Pro (ACF Pro) 同时启用时，会出现以下兼容性问题：

ACF 字段 key 被篡改：field_abc_123 被转换为 field-abc-123（下划线变连字符），导致 ACF 自定义字段无法正常保存和读取。这是最严重的问题。
ACF 字段组的 post_name 被干扰：WPSlug 尝试对 ACF 内部文章类型的 slug 进行拼音转换。
ACF 字段组的 post_excerpt 被转拼音：ACF 内部调用 sanitize_title() 生成的摘要被 WPSlug 拦截处理。

根因分析
WPSlug 通过 sanitize_title（priority 9）、wp_insert_post_data（priority 10）、wp_unique_post_slug（priority 10）、transition_post_status（priority 10）等钩子拦截 slug 生成。
ACF Pro 注册了 5 个内部文章类型：acf-field-group、acf-field、acf-post-type、acf-taxonomy、acf-ui-options-page。当 ACF 保存字段数据时，会经过 wp_insert_post → sanitize_title 链路，WPSlug 在这个链路上的过滤器会把 ACF 的 field key 中的下划线转成连字符。
ACF 自身在 wp_unique_post_slug（priority 999）有修复逻辑 return $original_slug，但此时 $original_slug 已经被 sanitize_title 污染，修复无效。
WPSlug 的 isPostTypeEnabled() 在启用列表为空时默认允许所有文章类型（空=全部），没有排除 ACF 的内部类型。
修复方案
1. 排除 ACF 内部文章类型
在 WPSlug_Core 中新增排除列表，在 processPostData、processUniquePostSlug、handlePostStatusTransition 三个方法中增加前置守卫：
private static $excluded_post_types = array(
    'acf-field-group',
    'acf-field',
    'acf-post-type',
    'acf-taxonomy',
    'acf-ui-options-page',
);

2. 调用栈检测保护 sanitize_title
processSanitizeTitle 过滤器无法直接获取 post_type 信息，通过 isAcfInternalRequest() 方法检测调用栈中是否存在 ACF 相关的类或函数：

ACF_Internal_Post_Type 类
ACF_Field_Group 类
acf_update_field、acf_import_field_group 等函数

3. 纵深防御
在 WPSlug_Settings::isPostTypeEnabled() 中也加入 ACF 内部类型排除，双重保障。
测试验证




测试项
修复前
修复后




ACF 字段 key field_abc_123
field-abc-123 
field_abc_123 


ACF 字段组 post_name
被转拼音
保持 group_xxx key 


ACF 字段组 post_excerpt
被转拼音
保持原文 


acf_get_field() 查找
找不到 
正常找到 


普通文章中文 slug
正常转拼音
正常转拼音 


页面中文 slug
正常转拼音
正常转拼音 


自定义文章类型
正常转拼音
正常转拼音 


自定义分类法
正常转拼音
正常转拼音 


草稿→发布转换
正常
正常 


带 ACF 字段的文章保存
字段值丢失
字段值正常保持 



更新方式
已推送到 feicode 仓库，使用文派更新器的用户会自动收到更新推送。
如果你在使用中遇到其他插件的兼容性问题，欢迎在此帖反馈。

## 2 · system

- 发布时间：2026年2月28日 15:02

你的分析很全面，修复方案遵循了  插件开发的最佳实践。针对你的方案，补充几点纵深防御和性能优化的建议。
1. 优化排除列表定义
建议将排除列表定义为类常量，提高可读性和性能。
class WPSlug_Core {
    const EXCLUDED_POST_TYPES = array(
        'acf-field-group',
        'acf-field',
        'acf-post-type',
        'acf-taxonomy',
        'acf-ui-options-page',
    );
}

2. 优化调用栈检测
在 processSanitizeTitle 中，使用 debug_backtrace() 开销较大。建议结合 $_POST 或 $_REQUEST 数据中的 action 参数进行初步过滤，仅在必要时进行调用栈分析。
private function isAcfInternalRequest() {
    // 快速检查：ACF 的 AJAX 请求通常有特定的 action
    if ( isset( $_POST['action'] ) && strpos( $_POST['action'], 'acf/' ) === 0 ) {
        return true;
    }
    // 深度检查：仅在必要时分析调用栈
    $trace = debug_backtrace( DEBUG_BACKTRACE_IGNORE_ARGS, 8 );
    foreach ( $trace as $item ) {
        if ( isset( $item['class'] ) && strpos( $item['class'], 'ACF_' ) === 0 ) {
            return true;
        }
        if ( isset( $item['function'] ) && strpos( $item['function'], 'acf_' ) === 0 ) {
            return true;
        }
    }
    return false;
}

3. 使用 WordPress 核心的 doing_filter() 进行精确拦截
在 sanitize_title 过滤器中，可以检查是否处于特定的 ACF 内部处理流程中。
add_filter( 'sanitize_title', array( $this, 'processSanitizeTitle' ), 9, 3 );
public function processSanitizeTitle( $title, $raw_title, $context ) {
    // 排除 ACF 的内部处理
    if ( $this->isAcfInternalRequest() ) {
        return $title; // 直接返回，不进行任何处理
    }
    // ... 原有逻辑
}

4. 考虑未来扩展性
建议将排除逻辑抽象为一个公共方法，方便其他插件通过过滤器进行扩展。
public function isExcludedPostType( $post_type ) {
    $excluded = apply_filters( 'wpslug_excluded_post_types', self::EXCLUDED_POST_TYPES );
    return in_array( $post_type, $excluded, true );
}

5. 插件审核注意事项
如果计划将插件提交到官方目录，确保所有用户输入都经过验证和清理。你的修复方案主要涉及内部逻辑，但任何从设置页面接收的配置（如排除列表的扩展）都需要使用 sanitize_text_field() 或类似的函数进行处理。
更多关于插件兼容性的讨论，请访问 /c/wordpress。对于涉及用户数据或权限的安全问题，建议咨询 @security。