Ogni tipo di campo di ACF è multilingue
Se crei siti con ACF, ACFML copre ogni tipo di campo nel catalogo di ACF e ACF Pro:
- I campi di testo e Wysiwyg si traducono per lingua.
- Le righe Repeater e Flexible Content rimangono allineate in tutte le lingue.
- I campi Immagine, File e Galleria possono passare a risorse localizzate per ogni lingua.
- I campi Link, Relazione e Oggetto post rimangono collegati correttamente tra le lingue.
- I campi Selettore data, Selettore colore, Mappa e gli altri campi interattivi si comportano correttamente in base alla lingua.
Anche i tipi di post personalizzati, le tassonomie e le pagine delle opzioni che registri tramite ACF si traducono, incluse le loro etichette. Il sito che crei con ACF è il sito che diventa multilingue con ACFML, non un suo sottoinsieme.
Scegli cosa è uguale e cosa è diverso per lingua
I gruppi di campi di ACF non hanno un comportamento di traduzione universale. La pagina Il nostro team sul tuo sito mostra gli stessi membri del team in ogni lingua: traduci i loro nomi e le loro biografie, mantieni intatta la struttura. La pagina Eventi mostra eventi diversi per un pubblico diverso: mostra eventi completamente diversi per lingua. La pagina Specifiche del prodotto mostra un mix: traduci la descrizione, mantieni invariati lo SKU e il prezzo.
ACFML gestisce tutti e tre i casi in base al gruppo di campi: Stessi campi in tutte le lingue, Campi diversi nelle varie lingue e Modalità esperto per le configurazioni miste. Scegli la modalità che corrisponde allo scopo di ogni gruppo di campi; ACFML collega automaticamente il comportamento di traduzione.
Controllo della traduzione a livello di campo
All’interno di un gruppo di campi, ogni campo ha la propria preferenza di traduzione:
- Traduci. Il valore del campo si traduce per lingua.
- Copia. Il valore del campo rimane sincronizzato in tutte le lingue; modificalo una volta e si propagherà.
- Copia una volta. Il valore del campo fa da base per le nuove traduzioni, dopodiché ogni versione linguistica può essere modificata in modo indipendente.
- Non tradurre. Il campo viene ignorato del tutto (ad esempio, un campo interno solo per l’area di amministrazione).
I valori predefiniti sensati per ogni tipo di campo sono già pronti all’uso: i campi di testo e Wysiwyg sono preimpostati su Traduci, mentre i campi strutturati come Immagine, Link e Numero su Copia. Il riferimento completo ai preset si trova su Come tradurre i campi personalizzati di ACF.
Le righe Repeater e Flexible Content rimangono allineate in tutte le lingue
I campi Repeater e Flexible Content sono quelli in cui le configurazioni multilingue di ACF spesso si interrompono in altri strumenti: le righe non sono più sincronizzate, i layout divergono e i traduttori vedono contenuti che non riconoscono. ACFML mantiene la struttura delle righe allineata in tutte le lingue per impostazione predefinita. I traduttori vedono le stesse righe nello stesso ordine, con ogni sottocampo traducibile al suo posto. Se hai bisogno di strutture diverse per lingua (ad esempio, un elenco di eventi diverso in ogni lingua), la preferenza Copia una volta ti permette di farlo.
I campi locali (registrati in PHP) ottengono lo stesso comportamento di traduzione
Molti siti di produzione registrano i campi di ACF in PHP anziché nell'interfaccia utente dell'area di amministrazione di ACF (per portabilità, controllo della versione o configurazioni incluse nel tema). ACFML 2.2.0 (febbraio 2026) introduce il supporto completo per i campi locali. Imposti la preferenza di traduzione di ogni campo con la chiave wpml_cf_preferences nella definizione del gruppo di campi, la sincronizzi in WPML da ACFStrumenti, e le schermate di amministrazione rispecchiano ciò che dichiara il gruppo di campi. I file JSON locali di ACF portano con sé le preferenze quando esporti e importi tra siti. La procedura dettagliata si trova nella pagina delle istruzioni alla voce Impostare le preferenze per i campi registrati in PHP o JSON.
Hook per sviluppatori per i casi limite
Per i siti con una logica di traduzione dei campi personalizzata (escludere campi specifici, sovrascrivere la preferenza predefinita per un tipo di campo a livello globale, nascondere le annotazioni ai traduttori), ACFML espone due filtri (acfml_should_translate_acf_entity, acfml_field_group_mode_field_translation_preference) e quattro costanti (ACFML_EXCLUDE_FIELD_GROUP_STRINGS_IN_POST_JOBS, ACFML_HIDE_FIELD_ANNOTATIONS, ACFML_REPEATER_SYNC_DEFAULT, ACFML_SCAN_LOCAL_FIELDS). Il riferimento completo con esempi di codice si trova su Riferimento agli hook e alle costanti di ACFML.
Sviluppato e mantenuto insieme al team di ACF
WPML e il team di ACF lavorano a stretto contatto per una compatibilità continua, confermata sulla pagina di compatibilità congiunta di ACF. Quando ACF o ACF Pro pubblica una nuova versione, ACFML si aggiorna di conseguenza; quando ACFML ha bisogno del supporto lato ACF per un nuovo comportamento di traduzione, l’integrazione viene sviluppata insieme anziché tramite reverse engineering.