ACFML — многоязычные произвольные поля ACF и ACF Pro в WordPress
Сделайте каждое произвольное поле на Вашем сайте многоязычным. ACFML добавляет поддержку многоязычности в Advanced Custom Fields и ACF Pro. Он охватывает все типы полей, все группы полей, все страницы настроек, а также сами названия полей. Поддерживаются конфигурации ACF Pro с полями Repeater, Flexible Content, Clone, условной логикой и локальными полями, зарегистрированными в PHP. Включено в Multilingual CMS и Agency.
Все типы полей 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 поддерживает все три варианта для каждой группы полей: Одинаковые поля для всех языков, Разные поля для разных языков и Экспертный режим для смешанных конфигураций. Выберите режим, который соответствует назначению каждой группы полей; 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 в меню ACF > Инструменты, и экраны админ-панели отражают то, что объявлено в группе полей. Локальные 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 для нового поведения перевода, интеграция создается совместно, а не с помощью обратной разработки.
ACFML включен в состав WPML
ACFML поставляется вместе с Multilingual CMS и WPML Agency. Никаких отдельных покупок или платы за каждый сайт. Купите WPML один раз, и каждый сайт на ACF, который охватывает Ваша учетная запись, станет многоязычным. Если у Вас уже есть WPML, активируйте ACFML на странице загрузок WPML.