ACFML – WordPress 中的多语言 ACF 和 ACF Pro 自定义字段

每种 ACF 字段类型均支持多语言

如果您使用 ACF 构建网站，ACFML 涵盖了 ACF 和 ACF Pro 目录中的每种字段类型：

• Text 和 Wysiwyg 字段可按语言进行翻译。
• Repeater 和 Flexible Content 行在不同语言之间保持对齐。
• Image、File 和 Gallery 字段可按语言切换为本地化资源。
• Link、Relationship 和 Post Object 字段在不同语言之间保持正确的关联。
• Date Picker、Color Picker、Map 及其他交互式字段在每种语言中都能正确运行。

您通过 ACF 注册的自定义文章类型、分类法和选项页面也可以进行翻译，包括它们的标签。您使用 ACF 构建的完整网站都将通过 ACFML 变成多语言网站，而不仅仅是其中的一部分。

选择每种语言中相同和不同的内容

ACF 字段组没有一成不变的翻译行为。您网站上的 Our Team 页面在每种语言中显示相同的团队成员：翻译他们的姓名和简介，保持结构不变。Events 页面针对不同受众显示不同的事件：在每种语言中显示完全不同的事件。Product Specs 页面则是混合形式：翻译说明，保持 SKU 和价格相同。

ACFML 基于每个字段组处理这三种情况：跨语言相同的字段、跨语言不同的字段，以及用于混合设置的专家模式。选择与每个字段组用途相匹配的模式；ACFML 会自动连接翻译行为。

按字段的翻译控制

在字段组内，每个字段都有自己的翻译首选项：

• 翻译。字段的值按语言进行翻译。
• 复制。字段的值在不同语言之间保持同步；编辑一次即可传播到所有语言。
• 复制一次。字段的值将作为新翻译的初始内容，随后每个语言版本都可以独立编辑。
• 不翻译。完全忽略该字段（例如，仅限内部管理后台使用的字段）。

每种字段类型开箱即用并配有合理的默认设置：Text 和 Wysiwyg 字段默认为翻译，Image、Link 和 Number 等结构化字段默认为复制。完整的预设参考请参阅如何翻译 ACF 自定义字段。

Repeater 和 Flexible Content 行在跨语言时保持对齐

在其他工具中，Repeater 和 Flexible Content 字段通常是多语言 ACF 设置容易出错的地方：行失去同步，布局出现分歧，译者看到他们无法识别的内容。ACFML 默认在不同语言之间保持行结构对齐。译者以相同的顺序看到相同的行，并且每个可翻译的子字段都在原位。如果您需要每种语言有不同的结构（例如，每种语言有不同的事件列表），可以通过复制一次首选项来实现。

本地字段（PHP 注册）获得相同的翻译行为

许多生产站点在 PHP 中而不是 ACF 管理后台 UI 中注册 ACF 字段（出于可移植性、版本控制或主题捆绑配置的考虑）。ACFML 2.2.0（2026年2月）带来了对本地字段的全面支持。您可以在字段组定义中使用 wpml_cf_preferences 键设置每个字段的翻译首选项，从 ACF > Tools 将其同步到 WPML，管理后台屏幕将反映字段组声明的内容。当您在站点之间导出和导入时，ACF 的本地 JSON 文件会随身携带这些首选项。分步过程请参阅操作指南页面中的为在 PHP 或 JSON 中注册的字段设置首选项。

适用于边缘情况的开发者钩子

对于具有自定义字段翻译逻辑的站点（选择排除特定字段、全局覆盖字段类型的默认首选项、向译者隐藏注释），ACFML 公开了两个过滤器（acfml_should_translate_acf_entity、acfml_field_group_mode_field_translation_preference）和四个常量（ACFML_EXCLUDE_FIELD_GROUP_STRINGS_IN_POST_JOBS、ACFML_HIDE_FIELD_ANNOTATIONS、ACFML_REPEATER_SYNC_DEFAULT、ACFML_SCAN_LOCAL_FIELDS）。包含代码示例的完整参考请见 ACFML 钩子和常量参考。

与 ACF 团队共同构建和维护

WPML 和 ACF 团队在持续兼容性方面密切合作，这在联合的 ACF 兼容性页面上得到了证实。当 ACF 或 ACF Pro 发布新版本时，ACFML 会紧跟步伐；当 ACFML 需要 ACF 方面支持新的翻译行为时，双方会共同构建集成，而不是进行逆向工程。