ACFML — многоязычные произвольные поля ACF и ACF Pro в WordPress

Все типы полей 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 не имеют универсального поведения при переводе. Страница Наша команда на Вашем сайте показывает одних и тех же сотрудников на каждом языке: переведите их имена и биографии, сохранив структуру неизменной. Страница Мероприятия показывает разные события для разной аудитории: показывайте совершенно разные мероприятия для каждого языка. Страница Характеристики товара показывает смешанный вариант: переведите описание, но оставьте артикул и цену одинаковыми.

Та же страница команды на французском языке

ACFML обрабатывает все три варианта на уровне группы полей: Same fields across languages, Different fields across languages и Expert Mode для смешанных настроек. Выберите режим, который соответствует назначению каждой группы полей; ACFML настроит поведение перевода автоматически.

Управление переводом для каждого поля

Внутри группы полей каждое поле получает свою настройку перевода:

Перевести. Значение поля переводится для каждого языка.
Копировать. Значение поля синхронизируется между языками; измените его один раз, и оно обновится везде.
Копировать один раз. Значение поля копируется при создании перевода, после чего каждая языковая версия может редактироваться независимо.
Не переводить. Поле полностью игнорируется (например, внутреннее поле только для админ-панели).

Разумные настройки по умолчанию для каждого типа поля доступны сразу после установки: для полей Text и Wysiwyg по умолчанию установлено Перевести, для структурированных полей, таких как Image, Link и Number, — Копировать. Полный справочник по настройкам по умолчанию находится на странице Как переводить произвольные поля ACF.

Строки Repeater и Flexible Content остаются синхронизированными на всех языках

Поля Repeater и Flexible Content — это то место, где многоязычные настройки ACF часто ломаются в других инструментах: строки рассинхронизируются, макеты расходятся, а переводчики видят контент, который они не узнают. ACFML по умолчанию сохраняет структуру строк синхронизированной на всех языках. Переводчики видят те же строки в том же порядке, с каждым переводимым подполем на своем месте. Если Вам нужны разные структуры для разных языков (например, разный список мероприятий на каждом языке), настройка Копировать один раз позволяет это сделать.

Локальные поля (зарегистрированные в PHP) получают такое же поведение при переводе

Многие рабочие сайты регистрируют поля ACF в PHP, а не в пользовательском интерфейсе админ-панели ACF (для переносимости, контроля версий или конфигураций, встроенных в тему). ACFML 2.2.0 (февраль 2026 года) добавляет полную поддержку локальных полей. Вы задаете настройку перевода каждого поля с помощью ключа wpml_cf_preferences в определении группы полей, синхронизируете её в WPML из ACFTools, и экраны админ-панели отражают то, что объявлено в группе полей. Локальные JSON-файлы ACF переносят эти настройки при экспорте и импорте между сайтами. Пошаговая процедура описана на странице инструкций в разделе Настройка параметров для полей, зарегистрированных в 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 для нового поведения перевода, интеграция создается совместно, а не с помощью обратной разработки.