Advanced Custom Fields Multilingual (ACFML)

Az Advanced Custom Fields Multilingual (ACFML) egy összekötő (bridge) bővítmény, amely az Advanced Custom Fields mezőket összehangolja a WPML fordítási rendszerével.

A feladata az, hogy az ACF-mezők:

• ne vesszenek el fordítás közben,
• helyesen jelenjenek meg az Advanced Translation Editorban (ATE),
• nyelvenként megfelelő értékeket, címkéket és választási listákat (choices) használjanak.

Megoldja az olyan tipikus hibákat, mint:

• üres vagy hiányzó ACF mezők az ATE-ben,
• rosszul másolt repeater vagy flexible content struktúrák,
• nem fordított mezőcímkék,
• hibás nyelvi összerendelések.

Kötelező előfeltételek

A bővítmény csak akkor működik megfelelően, ha az alábbiak telepítve vannak:

• ACF vagy ACF PRO
• WPML alap plugin
• WPML String Translation
• Advanced Custom Fields Multilingual (ACFML)

Fejlesztő: OnTheGoSystems
Az ACFML a WPML csomag részeként érhető el.

Hogyan működik röviden?

Az ACFML aktiválása után az ACF → Field Groups felületen megjelenik egy Multilingual Setup rész.

Itt mezőcsoportonként döntheted el, hogyan viselkedjenek a mezők több nyelven:

• Same fields across languages
  Azonos mezőstruktúra minden nyelven.
  A tartalom az ATE-ben fordítható (manuálisan vagy automatikusan).
• Different fields across languages
  Nyelvenként eltérő mezőértékek vagy struktúra.
  A fordítás a WordPress editorban vagy page builderben történik.
• Expert mód
  Mezőnként szabályozható, hogy:
  • Translate
  • Copy
  • Copy once
  • Don’t translate

A fordítás mindig a WPML felületéről indul, majd az ATE-ben vagy natív szerkesztőben zárul.

Mit fordít az ACFML?

Mezőértékek
Szöveges, WYSIWYG és egyéb tartalommezők fordíthatók.

Mezőcímkék és Choices
Nem csak a frontend szöveg, hanem az adminban látható címkék és választási listák is többnyelvűek lehetnek.

ACF Blocks
Gutenberg alapú ACF blokkok tartalma fordítható ATE-vel vagy natív szerkesztéssel.

Page builder integráció
Elementor PRO esetén az ACF dinamikus mezők megfelelően jelennek meg a fordításnál.

Taxonómia mezők
A taxonómiák neve, slugja és az ACF-hez kötött metaadatok is helyesen kezelhetők.

Média mezők
Image és File mezőknél nyelvenként eltérő fájlok használhatók.
„Same fields” módban a Media Translation használata javasolt.

Repeater és Flexible Content kezelés

• Alapértelmezetten a sorstruktúra szinkronizálható nyelvek között.
• A szinkron kikapcsolható, ha nyelvenként eltérő tartalom szükséges.
• Beágyazott (nested) repeater mezők is támogatottak.

Fejlesztői finomhangolás

Az ACFML tartalmaz konstansokat és hookokat speciális esetekre.

Példák:

define('ACFML_REPEATER_SYNC_DEFAULT', false);
define('ACFML_HIDE_FIELD_ANNOTATIONS', true);

Ezekkel szabályozható például a repeater szinkron alapértelmezése vagy az ATE-ben megjelenő jelölések.

Tipikus support kérdések

„Nem látom az ACF mezőket az ATE-ben”
→ Ellenőrizd a mezőneveket (ne kezdődjenek aláhúzással), és a fordítási módot.

„A repeater sorok elcsúsznak nyelvek között”
→ Valószínűleg nem megfelelő a szinkron beállítás, vagy rossz mód van kiválasztva.

„A mezőcímkék nem fordulnak”
→ Ellenőrizd, hogy a String Translation aktív-e.

„Más képet szeretnék nyelvenként”
→ Használd a Media Translationt, ne közvetlenül a szerkesztőben cseréld.

Ajánlott beállítási gyakorlatok

• A mezőnevek legyenek egyértelműek és következetesek.
• Előre döntsd el, hogy a struktúra azonos marad-e nyelvek között.
• Nagy repeater vagy flexible content esetén teszteld a teljes folyamatot élesítés előtt.
• JSON vagy PHP alapon regisztrált mezőknél csak szükség esetén szinkronizálj preferenciákat.

Kinek javasolt az ACFML használata?

• Többnyelvű oldalt építő fejlesztőknek és ügynökségeknek.
• ACF-re épülő tartalomstruktúráknál.
• Marketing oldalaknál, magazinoknál, portfólióknál.
• Gutenberg (ACF Blocks) vagy Elementor alapú projekteknél.

Rövid összefoglaló

Az ACFML azért szükséges, mert a WPML önmagában nem kezeli helyesen az ACF mezők logikáját.
Ez a bővítmény biztosítja, hogy a mezők, értékek és struktúrák több nyelven is stabilan, következetesen és supportolható módon működjenek.