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

> Mire való a wpml-config.xml, hová kell tenni, hogyan adhatsz meg harmadik féltől származó témákhoz és bővítményekhez beállítást, és hogyan írod felül.

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](https://hub.hellowp.io/hu/plugins/sitepress-multilingual-cms/fejleszto-oldalepito-widgetek/);
- [egyedi mezők fordítási beállításai](https://hub.hellowp.io/hu/plugins/sitepress-multilingual-cms/fejleszto-egyedi-mezok/);
- egyedi kifejezések, típusok és taxonómiák fordíthatóvá tétele;
- [egyedi Gutenberg-blokkok fordíthatóvá tétele](https://hub.hellowp.io/hu/plugins/sitepress-multilingual-cms/fejleszto-gutenberg-blokkok/);
- a `wp_options` táblában tárolt szövegek fordítása;
- [a WPML nyelvváltó testreszabása](https://hub.hellowp.io/hu/plugins/sitepress-multilingual-cms/fejleszto-nyelvvalto-konfiguracio/);
- 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.