ACFML: campos personalizados de ACF y ACF Pro multilingües en WordPress

Todos los tipos de campo de ACF son multilingües

Si crea sitios con ACF, ACFML cubre todos los tipos de campo del catálogo de ACF y ACF Pro:

• Los campos de Texto y Wysiwyg se traducen por idioma.
• Las filas de Repetidor y Contenido flexible se mantienen alineadas en todos los idiomas.
• Los campos de Imagen, Archivo y Galería pueden cambiarse por recursos localizados en cada idioma.
• Los campos de Enlace, Relación y Objeto de entrada se mantienen correctamente enlazados entre los idiomas.
• Los campos de Selector de fecha, Selector de color, Mapa y los demás campos interactivos se comportan correctamente en cada idioma.

Los tipos de contenido personalizado, las taxonomías y las páginas de opciones que registre a través de ACF también se traducen, incluidas sus etiquetas. El sitio que crea con ACF es el mismo que se vuelve multilingüe con ACFML, no un subconjunto.

Elija qué es igual y qué es diferente en cada idioma

Los grupos de campos de ACF no tienen un comportamiento de traducción único para todos los casos. La página Nuestro equipo de su sitio muestra los mismos miembros del equipo en todos los idiomas: traduzca sus nombres y biografías, y mantenga su estructura intacta. La página Eventos muestra eventos diferentes para públicos distintos: muestre eventos totalmente diferentes en cada idioma. La página Especificaciones del producto muestra una mezcla: traduzca la descripción, pero mantenga el SKU y el precio iguales.

ACFML gestiona los tres casos a nivel de grupo de campos: Mismos campos en todos los idiomas, Campos diferentes en cada idioma y Modo experto para configuraciones mixtas. Elija el modo que coincida con el propósito de cada grupo de campos; ACFML configura el comportamiento de traducción automáticamente.

Control de traducción por campo

Dentro de un grupo de campos, cada campo tiene su propia preferencia de traducción:

• Traducir. El valor del campo se traduce por idioma.
• Copiar. El valor del campo se mantiene sincronizado en todos los idiomas; edítelo una vez y se propagará.
• Copiar una vez. El valor del campo sirve de base para las nuevas traducciones y, a continuación, la versión de cada idioma se puede editar de forma independiente.
• No traducir. El campo se ignora por completo (por ejemplo, un campo interno exclusivo para el administrador).

Desde el primer momento se incluyen valores predeterminados lógicos por tipo de campo: los campos de Texto y Wysiwyg tienen el valor predeterminado Traducir, mientras que los campos estructurados como Imagen, Enlace y Número tienen el valor predeterminado Copiar. La referencia completa de ajustes preestablecidos se encuentra en Cómo traducir campos personalizados de ACF.

Las filas de Repetidor y Contenido flexible se mantienen alineadas en todos los idiomas

Los campos de Repetidor y Contenido flexible son los puntos donde las configuraciones multilingües de ACF suelen fallar con otras herramientas: las filas se desincronizan, los diseños divergen y los traductores ven contenido que no reconocen. ACFML mantiene la estructura de las filas alineada en todos los idiomas de forma predeterminada. Los traductores ven las mismas filas en el mismo orden, con cada subcampo traducible en su lugar. Si necesita estructuras divergentes por idioma (por ejemplo, una lista de eventos diferente en cada idioma), la preferencia Copiar una vez le permite hacerlo.

Los campos locales (registrados en PHP) obtienen el mismo comportamiento de traducción

Muchos sitios de producción registran los campos de ACF en PHP en lugar de la interfaz de administración de ACF (por portabilidad, control de versiones o configuraciones incluidas en el tema). ACFML 2.2.0 (febrero de 2026) incluye compatibilidad total con campos locales. Usted establece la preferencia de traducción de cada campo con la clave wpml_cf_preferences en la definición del grupo de campos, la sincroniza en WPML desde ACF > Herramientas y las pantallas de administración reflejan lo que declara el grupo de campos. Los archivos JSON locales de ACF llevan consigo las preferencias cuando exporta e importa entre sitios. El procedimiento paso a paso se encuentra en la página de instrucciones, en la sección Establecer preferencias para campos registrados en PHP o JSON.

Hooks de desarrollador para casos extremos

Para los sitios con lógica de traducción de campos personalizada (excluir campos específicos, anular la preferencia predeterminada para un tipo de campo a nivel global, ocultar anotaciones a los traductores), ACFML expone dos filtros (acfml_should_translate_acf_entity, acfml_field_group_mode_field_translation_preference) y cuatro constantes (ACFML_EXCLUDE_FIELD_GROUP_STRINGS_IN_POST_JOBS, ACFML_HIDE_FIELD_ANNOTATIONS, ACFML_REPEATER_SYNC_DEFAULT, ACFML_SCAN_LOCAL_FIELDS). La referencia completa con ejemplos de código se encuentra en Referencia de hooks y constantes de ACFML.

Desarrollado y mantenido junto con el equipo de ACF

WPML y el equipo de ACF trabajan en estrecha colaboración para ofrecer una compatibilidad continua, confirmada en la página conjunta de compatibilidad de ACF. Cuando ACF o ACF Pro publican una versión, ACFML se mantiene al día; cuando ACFML necesita compatibilidad por parte de ACF para un nuevo comportamiento de traducción, la integración se desarrolla en conjunto en lugar de usar ingeniería inversa.