A nyelvi konfigurációs fájl (wpml-config.xml)

A WPML be tud olvasni egy konfigurációs fájlt, amely megmondja neki, mit kell lefordítani a témákban és bővítményekben. A fájl neve wpml-config.xml, és a bővítmény vagy téma gyökérmappájába kerül.

A must-use bővítmény gyakran egyetlen PHP-fájl a wp-content/mu-plugins mappában. Ilyenkor a wpml-config.xml olyan mappába kerül, amelynek neve megegyezik a bővítményfájl nevével .php nélkül. A wp-content/mu-plugins/my-plugin.php esetén a WPML a wp-content/mu-plugins/my-plugin/wpml-config.xml fájlt olvassa.

A fájl célja

A WPML bármit le tud fordítani a WordPress-oldaladon, de meg kell mondani neki, mit. Ezt teszi a fájl. A WPML → Settings oldalon ugyanezeket az információkat kézzel is megadhatod: melyik egyedi mezőt kell fordítani vagy szinkronizálni, mely egyedi bejegyzéstípusok és taxonómiák legyenek többnyelvűek, és mely admin szövegeket kell fordítani. A konfigurációs fájl ezeket tartalmazza, így a felhasználóknak nem kell az admin oldalon külön beírniuk.

Néhány témához és bővítményhez a WPML a konfigurációs fájlt saját szervereiről tölti le (ezek egy nyilvános tárolóban listázva vannak). Ez felülírja a téma vagy bővítmény gyökérmappájában lévő helyi fájlt.

A témák és bővítmények fájljai által betöltött beállításokat kézzel is felülírhatod, a helyi és a szerverről letöltött fájlokra egyaránt.

Beállítás harmadik féltől származó témákhoz és bővítményekhez

A WPML sok népszerű témával és bővítménnyel kompatibilis, ezekhez nem kell konfigurációs fájlt írnod. Ha viszont egy téma vagy bővítmény tartalma nem jelenik meg helyesen az Advanced Translation Editorban, előfordulhat, hogy kézzel kell megadnod a fordítási beállításait.

1. Nyisd meg a WPML → Settings oldalt.
2. Kattints a Custom XML Configuration fülre.
3. A szövegszerkesztőbe írd be a kódot, ugyanúgy, mintha a wpml-config.xml fájlt írnád.

A wpml-config.xml automatikus előállítása

Ha nem szoktál XML-fájlokat írni, a Multilingual Tools bővítmény megkönnyíti a feladatot. Eredetileg téma- és bővítményfejlesztőknek készült, de a saját wpml-config.xml fájlod előállítására is jó. Ha elkészült a fájl, tedd a témád gyökérmappájába. Ha már van, ne írd felül: szerkeszd az eredeti XML-t, és add hozzá a generált kódot. Ez a bővítmény nem éles oldalra való.

A szakaszok és a szerkezet megismeréséhez kiindulásnak használhatsz egy példafájlt is, amelyet át kell szerkesztened.

Felépítés és szintaxis

A wpml-config.xml fájlban a következőket állíthatod be, mindegyikhez külön fejezet tartozik:

• egyedi shortcode-ok fordítása;
• oldalépítő tartalmának regisztrálása;
• egyedi oldalépítő-widgetek regisztrálása;
• egyedi mezők fordítási beállításai;
• egyedi kifejezések, típusok és taxonómiák fordíthatóvá tétele;
• egyedi Gutenberg-blokkok fordíthatóvá tétele;
• a wp_options táblában tárolt szövegek fordítása;
• a WPML nyelvváltó testreszabása;
• számértékek fordíthatóvá tétele.

Gyermektéma használata

Ha gyermektémát használsz, a szülőtéma konfigurációs fájlja felülírja a gyermektémában találhatót. A WPML-nek van egy beállítóoldala, amellyel ezt könnyen felülírhatod saját beállításokkal.

Tegyük fel, hogy a szülőtéma konfigurációs fájlja az egyedi „Property” bejegyzéstípust fordíthatóra állítja. Ha gyermektémát használsz, és nem akarod, hogy fordítható legyen:

1. Nyisd meg a WPML → Settings oldalt.
2. Kattints a Custom XML Configuration fülre.
3. A szerkesztőben állítsd a „Property” egyedi bejegyzéstípust nem fordíthatóra: a translate attribútum értéke 1 helyett legyen 0.

A Custom XML Configuration fül beállításai elsőbbséget élveznek a szülőtéma konfigurációs fájljának beállításaival szemben.