# ACF Multilingual

> A WPML kiegészítője, amellyel az ACF és ACF Pro egyedi mezőinek értékei, címkéi és választási lehetőségei is lefordíthatók.

Az ACF Multilingual (ACFML) az Advanced Custom Fields és a WPML közötti híd. Az ACF mezők értékeit, címkéit, választási lehetőségeit, az Options Page oldalakat és a blokkmezőket is a WPML fordítási munkafolyamatán keresztül kezeli, így a mezők a tartalommal együtt fordíthatók.

A bővítmény az ACF-hez vagy az ACF Prohoz, a WPML-hez és a WPML String Translationhöz készült, azok nélkül nem használható.

## Mire jó

- Ha az ACF-es mezőkkel épített oldalad többnyelvű.
- Ha a mezőcímkéket és a legördülő listák elemeit is le akarod fordítani, nem csak a beírt értékeket.
- Ha az Options Page oldalak (például a lábléc szövege) nyelvenként eltérnek.
- Ha egyes mezőket (például egy képet vagy dátumot) minden nyelven ugyanúgy át akarsz másolni, csak a szövegeket fordítanád.
- Ha kódban vagy Local JSON-ban regisztrált mezőcsoportokat is kezelnél.

## Mit tud

Minden mezőcsoportnál kiválaszthatod a fordítási módot:

| Beállítás | Mire való |
|---|---|
| **Same content in every language, translated** | A szokásos választás: a szövegek fordíthatók, a szerkezet azonos marad |
| **Each language has its own content** | Minden nyelvet külön szerkesztesz, később nincs szinkron és nincs automatikus fordítás |
| **Expert** | Minden mező beállítását kézzel adod meg |

Mezőnként négy fordítási beállítás van: **Translate**, **Copy**, **Copy once** és **Don’t translate**. Az ACFML mezőtípusonként ajánlott alapértéket állít be.

## Mikor nem ez kell

- A mezőcímkék és a választási lehetőségek nem része az oldal fordítási feladatának. Külön kell elküldeni őket a WPML Dashboardról, különben az eredeti nyelven maradnak.
- Az **Each language has its own content** módban a nyelvi változatok létrehozás után nem szinkronizálódnak.
- A tároló mezők (Group, Repeater, Flexible Content, Clone) maguk nem kaphatják a **Translate** beállítást.
- A Tab, Accordion, Message és Separator mezőknek nincs fordítási beállítása.
- A felhasználóknak nincs fordításuk, ezért a felhasználókra mutató kapcsolatmezők az eredeti értéket tartják meg.

## Első lépések

1. Telepítsd és kapcsold be a bővítményt.
2. Nyisd meg az **ACF → Field Groups** listát, és szerkessz egy mezőcsoportot.
3. A **Multilingual Setup** résznél kattints a **Choose** gombra, válaszd ki a fordítási módot, és mentsd.
4. A mezők címkéit és választási lehetőségeit a **WPML → Translations → Dashboard** oldalon, az **ACF Field Group** szakaszban küldheted fordításra. Az Options Page oldalak az **ACF Options** szakaszban vannak.
5. Ha a mezőket kódban vagy Local JSON-ban regisztrálod, add meg mezőnként a `wpml_cf_preferences` értéket, majd futtasd az **ACF → Tools** oldalon a **Sync Translation Preferences for Local Fields** és a **Register Labels for Translation** műveletet.

## Hasznos linkek

- [A bővítmény hivatalos dokumentációja](https://wpml.org/documentation/related-projects/translate-sites-built-with-acf/)
- [Letöltés a WPML oldalán](https://wpml.org/download/acfml/)