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

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 Text e Wysiwyg vengono tradotti per ogni lingua.
• Le righe di Repeater e Flexible Content rimangono allineate tra le lingue.
• I campi Image, File e Gallery possono passare a risorse localizzate per ogni lingua.
• I campi Link, Relationship e Post Object rimangono collegati correttamente tra le lingue.
• I campi Date Picker, Color Picker, Map e gli altri campi interattivi si comportano correttamente per ogni 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 crei con ACF è lo stesso sito che diventa multilingue con ACFML, non un suo sottoinsieme.

Scegli cosa rimane uguale e cosa cambia per ogni 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 biografie, mantenendo intatta la struttura. La pagina Eventi mostra eventi diversi per un pubblico diverso: mostra eventi completamente diversi per ogni lingua. La pagina Specifiche del prodotto mostra un mix: traduci la descrizione, mantieni invariati lo SKU e il prezzo.

ACFML gestisce tutti e tre gli scenari in base al gruppo di campi: Stessi campi in tutte le lingue, Campi diversi nelle varie lingue e Modalità esperto per 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 ottiene la propria preferenza di traduzione:

• Traduci. Il valore del campo viene tradotto per ogni lingua.
• Copia. Il valore del campo rimane sincronizzato tra le lingue; modificalo una volta e si propagherà.
• Copia una volta. Il valore del campo fa da base per le nuove traduzioni, dopodiché la versione di ogni lingua può essere modificata in modo indipendente.
• Non tradurre. Il campo viene completamente ignorato (ad es., un campo interno solo per l’area di amministrazione).

Impostazioni predefinite sensate per tipo di campo sono già pronte all’uso: i campi Text e Wysiwyg sono preimpostati su Traduci, mentre i campi strutturati come Image, Link e Number sono preimpostati su Copia. Il riferimento completo alle preimpostazioni si trova su Come tradurre i campi personalizzati di ACF.

Le righe di 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 perdono la sincronizzazione, 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 ogni 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) offre 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 ACF > Strumenti e le schermate dell’area 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 passo si trova nella pagina delle istruzioni alla voce Impostare le 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 globalmente la preferenza predefinita per un tipo di campo, 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 a hook e costanti di ACFML.

Sviluppato e mantenuto insieme al team di ACF

WPML e il team di ACF lavorano a stretto contatto sulla compatibilità continua, confermata nella pagina di compatibilità di ACF congiunta. Quando ACF o ACF Pro pubblica una 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 invece di essere creata tramite reverse engineering.