Advanced Custom Fields Multilingual

Hivatalos WPML-kiegészítő az ACF-mezők, mezőcsoportok és azok tartalmainak többnyelvű fordításához, mezőcsoport-szintű vezérléssel.

This content is not available in your language yet.

Mi ez és milyen problémát old meg?

Az Advanced Custom Fields Multilingual (ACFML) egy „glue” bővítmény: összekapcsolja az ACF/ACF PRO mezőidet a WPML fordítási folyamataival. Arra való, hogy a mezőcsoportok, a mezők értékei, címkéi és választási lehetőségei (Choices) nyelvek között konzisztensen, hibamentesen fordíthatók legyenek. Megoldja azokat a tipikus gondokat, mint a hiányzó ACF-értékek az ATE-ben, tévesen másolt repeater-struktúrák, nem fordított címkék vagy rossz nyelvi linkek.

Követelmények

Szükséges: ACF (vagy ACF PRO), WPML alapmodul, WPML String Translation és az ACFML.
Fejlesztő: a WPML csapata (OnTheGoSystems).
Elérhetőség: a WPML többnyelvű csomagjaiban.

Hogyan működik röviden?

Az ACFML aktiválása után az ACF → Field Groups képernyőn megjelenik a Multilingual Setup. Itt mezőcsoportonként kiválasztod a fordítási módot:

Same fields across languages: azonos mezőstruktúra minden nyelven, a tartalom az Advanced Translation Editorban (ATE) fordulhat, akár automatikusan.
Different fields across languages: nyelvenként eltérő értékek/struktúra; szerkesztés a WordPress editorban vagy a page builderben.
Expert mód: mezőnként beállítható a Translate, Copy, Copy once vagy Don’t translate.

A tartalmat a WPML felületéről küldöd fordításra, majd az ATE-ben vagy natív szerkesztőben véglegesíted.

Fő funkciók, érthetően

Mezőértékek, címkék, Choices fordítása: nem csak a tartalom, hanem a mezőcímkék és választási listák is többnyelvűek, így a szerkesztők és a frontend feliratok minden nyelven rendben lesznek.
Két előre beállított mód: gyors döntés, hogy egyezzen-e a mezőstruktúra (ATE-alapú fordítás) vagy nyelvenként szabadon eltérhessen (natív szerkesztés).
Expert preferenciák: tűpontos kontroll. Példa: Text = Translate, Number/Image = Copy, URL = Copy once, admin-only technikai mező = Don’t translate.
ACF Blocks támogatás: a blokkok tartalma ugyanígy fordítható mindkét módszerrel.
Page builder integráció: Elementor PRO dinamikus ACF-mezői fordításbarát módon jelennek meg.
Taxonómia-mezők: a fogalmak neve/slugja és az ACF-hez kötött term meta helyesen fordul.
Média nyelvenként: ACF Image/File mezőkhöz nyelvspecifikus fájlokat használhatsz; „Same fields” módban a Media Translation a javasolt út.
Biztonság és kényelem: az ACF belső objektumai nem fordíthatók (hibák megelőzése), WYSIWYG-mezőkben a linkek nyelvi konverziója automatikus, gyorsabb opciós oldalak és jobb UX sok mezőcsoportnál.
Repeater/Flexible vezérlés: a sorok szinkronja kikapcsolható; a Nested Repeater blokkoknál is támogatott.
JSON/PHP-regisztrált csoportok: a fordítási preferenciák szinkronizálása kapcsolható, teljesítmény és forráskezelés szerint hangolható.
Fejlesztői API: konstansok és horgok a finomhangoláshoz.

Példa konstansokra:

/* Alapértelmezett repeater-szinkron kikapcsolása és jelölések elrejtése az ATE-ben */
define('ACFML_REPEATER_SYNC_DEFAULT', false);
define('ACFML_HIDE_FIELD_ANNOTATIONS', true);

Gyakorlati példák

Marketing landing: Hero cím, alcím, CTA (Text, Link). Állítsd a csoportot „Same fields” módba, a szövegek az ATE-ben fordulnak, a linkek automatikusan a célnyelvi oldalakra mutatnak.
Portfólió galéria: Projektenként más képek nyelvenként. Az Image mezőkhöz használd a Media Translationt, így a szerkezet egységes marad, a képek viszont nyelvspecifikusak.
Magazin – GYIK Repeater: Ha azonos sorrendet és sorstruktúrát akarsz, hagyd bekapcsolva a szinkront. Ha piaconként eltérő kérdéssor kell, kapcsold ki a szinkront és használd a „Different fields” módot.
Gutenberg + ACF Blocks: A tartalom „Same fields” módban ATE-vel fordul; összetettebb, nyelvenként eltérő blokkelrendezéshez válts „Different fields”-re.
Elementor lista: Dinamikus ACF-mezőkből épített „Csapat” szekció. A címek és leírások az ATE-ben fordulnak, a képek nyelvenként cserélhetők.

Legjobb gyakorlatok

Mezőnevek legyenek egyediek, és ne kezdődjenek aláhúzással, hogy az ATE minden értéket megjelenítsen.
Repeater/Flexible: előre döntsd el, egyezzen-e a struktúra (Copy/Sync) vagy térjen el nyelvek között (Copy once + kézi szerkesztés).
Média: „Same fields” módban a médiacserét a Media Translationon végezd, ne közvetlenül a szerkesztőben.
JSON/PHP csoportok: csak ott szinkronizálj preferenciát, ahol valóban szükséges – gyorsabb lesz az admin.

Előnyök és értékajánlat

Kevesebb hibakör: nincs eltűnő érték, rosszul klónozott repeater vagy téves címke.
Gyorsabb fordítás: ATE, memóriával és automatizált fordítással.
Skálázhatóság: nagy, adatintenzív ACF-architektúrák is kezelhetők, blokkokkal és builderrel.

Kinek ajánlott?

Ügynökségek és fejlesztők, akik ACF-re építik a struktúrát több nyelven.
Tartalomgazdag portálok, magazinok, marketing oldalak, portfóliók.
Gutenberg (ACF Blocks) és Elementor/Divi felhasználók, akik dinamikus ACF-tartalmat fordítanak.

Rövid technikai jegyzet

A 2.0-s főverzió hozta a mezőcsoport-szintű fordítási módokat és az egyszerűsített beállítást. A 2.1.x kiadások tovább javították a teljesítményt, bővítették a CPT/taxonómia címke-fordítást és bevezették a WYSIWYG link-konverziót.

Gyors induló ellenőrzőlista

Telepítsd: ACF/ACF PRO, WPML, String Translation, ACFML.
Válaszd ki csoportonként a fordítási módot.
Állítsd be az Expert preferenciákat a speciális mezőkhöz.
Teszteld egy bejegyzés fordítását (ATE vagy natív szerkesztő).
Ellenőrizd a média- és repeater-viselkedést.
Fordítsd a taxonómiákat és a hozzájuk kötött ACF-mezőket.
Kapcsold be a WYSIWYG link-konverziót és finomhangold a konstansokat/horgokat.