Kompatibilitás és wpml-config.xml

Ez a fejezet a kevésbé népszerű témákra és bővítményekre, a nagyon friss kiadásokra és néhány általános tünetre való. A legtöbb oldalnak nem kell ide jönnie, általában akkor, ha a támogatás egy konkrét kapcsolóra vagy egy beillesztendő wpml-config.xml-re hívja fel a figyelmet. Két oldal tartozik hozzá: WPML → Settings → Compatibility és WPML → Settings → Custom XML Configuration. A leggyakoribb alapértelmezések (tartalomtípusonként, taxonómiánként, mezőnként) külön oldalon vannak, lásd a Mit fordítson a WPML? fejezetet.

Kompatibilitási kapcsolók

A Compatibility oldalon négy kártya van, mindegyik egy-egy problémafajtára.

Localization options: ha a téma vagy bővítmény fordításai nem töltődnek be

Ha a téma vagy bővítmény mellé saját .mo fordításfájlok vannak a /languages/ mappában, de nem jelennek meg, három kapcsoló segít:

• Automatically load the theme’s .mo file using load_textdomain: a WPML meghívja a load_textdomain() függvényt a téma szövegtartományára. Akkor használd, ha a fordítás ott van a lemezen, de nem látszik.
• Enter textdomain: felülírja a magától felismert szövegtartományt, ha a téma szokatlanul regisztrálja.
• Use theme or plugin text domains when gettext calls do not use a string literal: azoknak a témáknak és bővítményeknek, amelyek a __() hívásnak változót adnak szöveg helyett. A WPML ezt nem tudja felismerni, a kapcsoló segít a fordítást mégis alkalmazni.

Make Themes Work Multilingual

Adjust IDs for multilingual functionality: kompatibilitási réteg olyan témákhoz, amelyek egynyelvű feltevésekkel dolgoznak (például a kiemelt kép azonosítóját egyszer tárolják, és minden nyelven azt használják). A modern témáknak ez általában nem kell. Akkor kapcsold be, ha tartalmi hivatkozások (képek, menük, kiemelt elemek) tévesen átszivárognak nyelvek között.

Language Filtering for AJAX Operations

Store a language cookie to support language filtering for AJAX: egyes bővítmények AJAX-szal töltenek be tartalmat (szűrt terméklista, lapozott bejegyzéslista, gépelés közbeni keresés). Nyelvi süti nélkül a végpont nem tudja, milyen nyelven válaszoljon, és rossz nyelvű eredményt ad. Kapcsold be, ha például a francia oldalon az AJAX-szal betöltött részek angolul jelennek meg.

Login and Registration Pages

Allow translating the login and registration pages: a WordPress /wp-login.php és regisztrációs képernyője nem tartozik a WPML által fordított tartalomhoz, mert a téma sablonláncán kívül van. A kapcsoló felveszi őket a fordítható oldalak közé. Nginx esetén a szerverkonfigurációt is módosítani kell hozzá.

Téma- és bővítményszövegek

Két külön feladat, két külön helyen:

• A Compatibility oldal beállításai azokra a fordításokra vonatkoznak, amelyek már benne vannak a témában vagy bővítményben.
• A még nem regisztrált téma- és bővítményszövegek megkeresésére az Admin Texts Translation képernyő való: a Translations Strings fülén a „nem látod a keresett szövegeket?” résznél érhető el.

Saját wpml-config.xml

A WPML-kompatibilis témák és bővítmények wpml-config.xml fájlt szállítanak, amely megmondja, mely mezőik, tartalomtípusaik, taxonómiáik, shortcode-jaik és metakulcsaik fordíthatók. A WPML ezt aktiváláskor beolvassa, ezért a népszerű témáknál és bővítményeknél a fordítás magától működik. Ha a szállított fájl nem elég, megadhatod a sajátodat, amit a WPML a szállított fölé rétegez.

Mikor írj sajátot?

• Egy szükséges mező nincs benne a szállított fájlban: a szerző nem jelölte fordíthatónak.
• Egy mező alapértéke nem jó: a fájl Copy, te Translate szeretnél (vagy fordítva).
• Saját témát vagy bővítményt készítesz, és a fordítási viselkedést a WPML beállítóoldaláról adnád meg, nem fájlban.

Leggyakrabban a támogatás kéri, hogy illessz be egy megadott blokkot.

Miért az adminban és nem a téma fájljában?

A téma vagy bővítmény saját wpml-config.xml-jének szerkesztése elvész a következő frissítéskor. A WPML → Settings → Custom XML Configuration szerkesztő a szállított fölé rétegez, és túléli a frissítést. Webhelyspecifikus módosításra ez a jó hely.

A fájl felépítése

Az oldal egy XML-szerkesztő. Illessz be egy <wpml-config>...</wpml-config> blokkot, mentsd, és a WPML alkalmazza. Példa, amely egy shortcode-ot fordíthatóvá tesz:

<wpml-config>
  <shortcodes>
    <shortcode>
      <tag>add_to_cart_link</tag>
    </shortcode>
  </shortcodes>
</wpml-config>

Tipikus elemek:

Elem	Mit csinál
<custom-fields>	Egy egyedi mezőt translate, copy, copy-once vagy nothing állapotra állít.
<custom-types>	Egyedi tartalomtípust fordíthatóvá tesz.
<taxonomies>	Egyedi taxonómiát fordíthatóvá tesz.
<shortcodes>	Felsorolja azokat a shortcode-okat, amelyek tartalmát a WPML fordítsa.
<custom-term-fields>	Kifejezés-metaadatokhoz.

Minden elemnek vannak attribútumai (például action="translate" egy egyedi mezőn).

Menete

Ha a támogatás XML-blokkot ad:

1. Nyisd meg a WPML → Settings → Custom XML Configuration oldalt.
2. Illeszd be az XML-t a meglévő <wpml-config> blokkba (vagy cseréld le a tartalmat, ha teljes blokkot kaptál).
3. Mentsd.
4. A WPML azonnal alkalmazza. Ha új fordítható tartalomtípust vagy mezőt deklarál, az rögtön megjelenik a Post Types Translation vagy a Custom Fields Translation oldalon.

Ha saját témát vagy bővítményt fejlesztesz, és a beállítást a kóddal együtt akarod szállítani, ugyanezt a blokkot tedd egy wpml-config.xml fájlba a téma vagy bővítmény gyökerébe. A WPML aktiváláskor beolvassa. A szerkesztő az oldalspecifikus módosításra, a mellékelt fájl a téma vagy bővítmény saját alapértékeire való.