Multilingual Tools: kompatibilitás tesztelése és konfiguráció generálása

A Multilingual Tools ingyenes kiegészítő bővítmény, amellyel a saját témád vagy bővítményed WPML-kompatibilitását tesztelheted. Megmutatja, mely szövegek és elemek vannak jól beállítva a fordításra és melyek nem, és nyelvi konfigurációs fájlt (wpml-config.xml) is tud generálni.

A bővítmény a GitHubon érhető el az OnTheGoSystems tárolójában. Tesztelőbővítmény, ezért éles vagy ügyfél-oldalon ne használd.

Előkészületek

Telepítsd és aktiváld:

• a WPML-t,
• a Multilingual Tools bővítményt,
• azokat a bővítményeket és témákat, amelyeket tesztelni akarsz.

A használat lépései

A bővítmény első oldala a Multilingual Tools → Overview. Itt látod a WPML által betöltött konfigurációs fájlokat, és azt, hogy mindegyik milyen bejegyzéstípusokat, taxonómiákat és egyedi mezőket regisztrál.

Ha elégedett vagy a konfigurációval, a lenti lépésekkel tesztelheted. Ha nem, generálj új konfigurációs fájlt a beállítások frissítéséhez.

1. A beégetett szövegek Gettext-hívásba csomagolása

A téma vagy bővítmény fordításához minden beégetett szöveget Gettext-hívásba kell csomagolni. Ha ezt még nem tetted meg, vagy ellenőrizni akarod, kövesd a WordPress i18n irányelveit (lásd még: Gettext használata).

2. A téma vagy bővítmény beégetett szövegeinek keresése

A WPML-lel átvizsgálhatod a témát vagy bővítményt a beégetett szövegekért:

1. Nyisd meg a WPML → Fordítások oldalt, és kattints a Strings fülre.
2. Nyisd ki a Not seeing an admin text you need? részt, válaszd ki a témát vagy bővítményt, és vizsgáld át a szövegeket.

3. A tesztelendő elemek kiválasztása

1. Nyisd meg a Multilingual Tools → Settings oldalt.
2. Görgess le az Add language information to post duplicate részhez.
3. Jelöld be a tesztelni kívánt elemeket, és mentsd el.

Sztringek teszteléséhez nyisd le a Auto generate strings translations rész sztring-legördülőjét, válaszd ki a sztringforrásokat, és kattints a Generate strings translations gombra.

4. Tartalom elküldése fordításra

Hogy ne töltsd az idődet (vagy a pénzedet) kamutartalom fordításával, a Multilingual Tools nyelvi előtagot fűz a szövegekhez. Ehhez duplikáld a tartalmat a WPML-lel, a többit a bővítmény elvégzi:

1. Nyisd meg a WPML → Fordítások oldalt, és kattints a Dashboard fülre.
2. Jelöld ki a tesztelni kívánt tartalmat.
3. Fordítási módszernek válaszd a Duplicate lehetőséget, és küldd el.

5. A kompatibilitás megerősítése

Nyisd meg a frontenden az imént lefordított tartalmat, és válts nyelvet. Az elemek kompatibilisek, ha a szövegek nyelvi előtagot kaptak. Ha egyes szövegeken nincs előtag, azok nem kompatibilisek, és további konfigurációt igényelnek.

Egyedi Elementor-widgetek és Gutenberg-blokkok

Ha a bővítményed Elementor-widgeteket vagy Gutenberg-blokkokat használ, a Multilingual Tools elkészíti a regisztrálásukhoz szükséges XML-kód első változatát, így nem kell nulláról megírnod. A blokkokról lásd az Egyedi Gutenberg-blokkok fordíthatóvá tétele fejezetet.

Nyelvi konfigurációs fájl generálása

Nyisd meg a Multilingual Tools → Configuration Generator oldalt, és állítsd be a kívánt opciókat.

Egyedi bejegyzéstípusok és taxonómiák

• Do nothing: figyelmen kívül hagyja, nem fordítja.
• Translatable - only show translated items: fordítható, csak a lefordított elemek jelennek meg.
• Translatable - use translation if available or fallback to default language: fordítható, ha van fordítás azt használja, egyébként az alapnyelvet.

Egyedi mezők

• Don’t translate: figyelmen kívül hagyja, nem fordítja.
• Copy: az alapnyelv értékét másolja, és szinkronban tartja (számokhoz jó).
• Copy once: az alapnyelv értékét csak egyszer másolja (akkor jó, ha nyelvenként különböző értékeket akarsz).
• Translate: lefordítja a többi nyelvre.

Admin szövegek

A wp_options táblában tárolt szövegeket regisztrálja fordításra. Például az oldal címe vagy a widgetbeállítások gyakran itt vannak. A konfigurációs fájlban regisztrálva biztosíthatod, hogy a felhasználók le tudják fordítani őket (lásd: A wp_options táblában tárolt szövegek fordítása).

Shortcode-ok

A shortcode-okban lévő szövegeket és attribútumokat regisztrálja fordításra (lásd: Egyedi shortcode-ok fordítása).

Egyedi Elementor-widgetek regisztrálása a Multilingual Tools-szal

Ez a rész fejlesztőknek szól, akik Elementor-témát vagy -bővítményt építenek, és WPML-kompatibilissé akarják tenni. Ha csak egy Elementorral készült oldalt akarsz lefordítani, a Elementor fordítása fejezetet olvasd.

A Multilingual Tools része a WPML - Config Generator for Elementor, amely az egyedi widgetekhez automatikusan elkészíti az XML-kód első változatát. Az innen kapott információkkal regisztrálhatod a widgetet (lásd: Egyedi oldalépítő-widgetek regisztrálása).

Előkészületek

1. Töltsd le a Multilingual Tools bővítményt az OnTheGoSystems GitHub-oldaláról.
2. Legyen telepítve és aktív a WPML Multilingual CMS és a WPML String Translation kiegészítő.
3. Legyen már Elementorral készült tartalom az oldalon.

Miért érdemes a Multilingual Tools-t használni?

A WPML 4.9-től automatikusan felismeri az egyedi Elementor-widgeteket, és fordíthatóvá teszi őket. Előfordulhat azonban, hogy olyan sztringeket is regisztrál, amelyeket nem akarsz fordítani. A Multilingual Tools-szal pontosan szabályozhatod, mely mezők fordíthatók.

Hogyan működik?

Amikor Elementorral készítesz oldalt, az egész tartalom az _elementor_data egyedi mezőbe kerül. Miután az oldalra felteszed a regisztrálni kívánt egyedi widgeteket, a WPML - Config Generator for Elementor beolvassa ezt a mezőt, és az oldalon használt egyedi widgeteknek megfelelő XML-kóddá alakítja.

XML-kód generálása

1. Hozz létre egy új oldalt, és kattints az Edit with Elementor gombra.
2. Add hozzá az oldalhoz a fordításra regisztrálni kívánt egyedi widgeteket.

Fontos: a widgetek hozzáadásakor tölts ki minden mezőt, és kapcsolj be minden elérhető opciót. A bővítmény a beállítatlan mezőkhöz és opciókhoz nem generál XML-kódot.

3. Tedd közzé az oldalt, és térj vissza az oldal WordPress szerkesztőképernyőjére. Nyisd meg a Meta Boxes panelt, és görgess a WPML - Config Generator for Elementor részhez. A WPML 4.9 óta az egyedi Elementor-widgeteket maga regisztrálja, ezért a szakasz tetején lévő doboz azt jelzi, hogy az oldal widgetjei már regisztrálva vannak. A szükséges XML a doboz alatti panelben van: WPML Config XML (generated for all widgets in the page).

A generált XML tesztelése

Mielőtt a kódot elérhetővé teszed a végfelhasználóknak, alaposan nézd át és teszteld. A bővítmény csak kiindulópont.

1. Másold ki az XML-kódot a WPML Config XML (generated for all widgets in the page) panelből.
2. Nyisd meg a WPML → Beállítások oldalt, és kattints a Custom XML Configuration fülre.
3. Illeszd be a kódot a szerkesztőbe, és kattints a Mentés gombra. Ellenőrizd, hogy nincs figyelmeztetés vagy érvényesítési hiba. Távolítsd el azokat a mezőket, amelyeket nem szabad fordítani vagy módosítani, például a konfigurációs mezőket és a logikai értékű mezőket. Ha ezek fordíthatók maradnak, hibákat okozhatnak a felhasználóknak.
4. Menj vissza az egyedi widgeteket tartalmazó oldal szerkesztőképernyőjére. Módosíts rajta egy keveset, például az oldal címét, és kattints a Frissítés gombra.
5. A Nyelv dobozban kattints a plusz ikonra az oldal lefordításához. Megnyílik a Haladó fordítószerkesztő, és ott látnod kell az egyedi widget regisztrált mezőit. Nézd át az automatikus fordításokat, vagy írd be a sajátodat, és kattints a Mentés és befejezés gombra.
6. Nézd meg a lefordított oldalt a frontenden, hogy az egyedi widget mezői helyesen jelennek-e meg.

További vizsgálati lehetőségek

Az XML-t tartalmazó panel egy a négy közül. A többi a bővítmény hibakereső információja. Ezekkel megértheted, milyen adatokból és hogyan készül az XML. Akkor hasznos, ha az XML nem úgy működik, ahogy vártad.

Panel	Mit mutat	Mire jó
WPML Config XML (generated for all widgets in the page)	Az oldal összes widgetjének XML-kódját, a már regisztráltakét is.	A meglévő widgetbeállítások XML-jének átnézése vagy szerkesztése.
RAW value from _elementor_data (JSON)	A bejegyzés _elementor_data mezőjének eredeti értékét.	Látod, milyen adatból generálja a bővítmény az XML-t.
Array generated from _elementor_data	Az _elementor_data mező tömbbé alakított értékét.	Hibakereséshez használható.
Extracted Widgets from _elementor_data	Mely egyedi widgeteket tudta kinyerni és használni a bővítmény.	Ha egy egyedi widget, mező vagy opció nem látszik itt, nem kerül az XML-be. Hibakereséshez hasznos.