ACFML – Campi personalizzati multilingue di ACF e ACF Pro in WordPress

Ogni tipo di campo di ACF è multilingue

Se costruisci siti con ACF, ACFML copre ogni tipo di campo nel catalogo di ACF e ACF Pro:

• I campi Text e Wysiwyg si traducono per lingua.
• Le righe Repeater e Flexible Content rimangono allineate tra le lingue.
• I campi Image, File e Gallery possono passare a risorse localizzate per lingua.
• I campi Link, Relationship e Post Object rimangono collegati correttamente tra le lingue.
• Date Picker, Color Picker, Map e gli altri campi interattivi si comportano correttamente per lingua.

Anche i tipi di post personalizzati, le tassonomie e le pagine delle opzioni che registri tramite ACF vengono tradotti, incluse le loro etichette. Il sito che costruisci con ACF è il sito che diventa multilingue con ACFML, non un suo sottoinsieme.

Scegli cosa rimane uguale e cosa cambia per lingua

I gruppi di campi di ACF non hanno un comportamento di traduzione universale. La pagina Il nostro team del tuo sito mostra gli stessi membri del team in ogni lingua: traduci i loro nomi e le biografie, mantenendo intatta la struttura. La pagina Eventi mostra eventi diversi per pubblici diversi: mostra eventi completamente diversi per lingua. La pagina Specifiche del prodotto mostra un mix: traduci la descrizione, mantenendo invariati lo SKU e il prezzo.

ACFML gestisce tutte e tre le situazioni in base al gruppo di campi: Stessi campi in tutte le lingue, Campi diversi in lingue diverse e Modalità esperto per le configurazioni miste. Scegli la modalità che corrisponde allo scopo di ciascun gruppo di campi; ACFML imposta automaticamente il comportamento di traduzione.

Controllo della traduzione a livello di campo

All’interno di un gruppo di campi, ogni campo ottiene la propria preferenza di traduzione:

• Traduci. Il valore del campo viene tradotto per lingua.
• Copia. Il valore del campo rimane sincronizzato tra le lingue; modificalo una volta e si propaga.
• 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 es., un campo interno solo per l’area di amministrazione).

I valori predefiniti sensati per tipo di campo sono già pronti all’uso: i campi Text e Wysiwyg sono impostati su Traduci, mentre i campi strutturati come Image, Link e Number sono impostati su Copia. Il riferimento completo ai preset si trova in Come tradurre i campi personalizzati di ACF.

Le righe Repeater e Flexible Content rimangono allineate tra 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 tra 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 divergenti per lingua (ad es., 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 ciascun campo con la chiave wpml_cf_preferences nella definizione del gruppo di campi, la sincronizzi in WPML da ACF > Strumenti e le schermate di amministrazione rispecchiano ciò che il gruppo di campi dichiara. I file JSON locali di ACF portano con sé le preferenze quando esporti e importi tra siti. La procedura passo dopo passo si trova nella pagina delle istruzioni alla voce Impostazione delle preferenze per i campi registrati in PHP o JSON.

Hook per sviluppatori per 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 in 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 pubblicano una versione, ACFML si adegua; quando ACFML ha bisogno del supporto lato ACF per un nuovo comportamento di traduzione, l’integrazione viene sviluppata insieme anziché tramite ingegneria inversa.