A nyelvváltó testreszabása

A beállítások a WPML → Settings → Language Switchers oldalon vannak, kérdések szerint csoportosítva. Részletesebb leírás: Nyelvváltó.

Mit tud alapból?

• Az összes aktív nyelvet megmutatja, az általad megadott sorrendben.
• A nyelveket a saját nevükön (Deutsch, Français) vagy az oldal aktuális nyelvén (német, francia) is felcímkézheti.
• Opcionálisan zászlókat mutat (a témával együtt méreteződő sprite).
• Kezeli a hiányzó fordítást: vagy kihagyja a nyelvet, vagy a nyelv nyitóoldalára mutat.
• Elhelyezhető bármelyik menüben, bármelyik widgetterületen, a láblécben, vagy a bejegyzések fölött és alatt.
• Van hozzá Gutenberg-blokk.
• Elrejthető ott, ahol útban lenne (404, pénztár, fiók).
• A kirenderelt HTML-t gyorsítótárazza.

Mely nyelvek jelenjenek meg, és milyen sorrendben?

A Language switcher options kártyán egy húzással rendezhető lista mutatja az összes aktív nyelvet. A sorrend minden nyelvváltóra érvényes az oldalon. Húzd a nyelveket fel vagy le, és mentsd. Ugyanitt választhatsz:

• Saját vagy aktuális nyelvű felirat. A saját nyelvű (Deutsch) vonzóbb az adott nyelv beszélőinek, az aktuális nyelvű (német) az először érkező látogatónak érthetőbb.
• Zászlók be vagy ki, és a zászló formátuma.

Mi történjen, ha hiányzik a fordítás?

A How to handle languages without translation beállítás dönti el, mit mutasson a nyelvváltó egy olyan nyelvnél, amelyen nincs az aktuális oldalnak fordítása:

• Skip language (alapértelmezett). A nyelv eltűnik a váltóból az adott oldalon. Ez a legtisztább: a látogató csak olyan nyelvet lát, amelyen el is tudja olvasni az oldalt.
• Link to home of language for missing translations. A váltó a nyelv nyitóoldalára mutat. Így minden nyelv mindig elérhető, de a látogató váratlan tartalomra érkezhet.

Hol jelenik meg?

Öt elhelyezés van, mindegyik külön kapcsolható ugyanazon az oldalon:

• Menu language switcher. Bármelyik WordPress-menübe betehető (fejléc, lábléc, oldalsáv). Több is lehet, menünként más elhelyezéssel, és mindegyiknek saját előnézeti sora van.
• Widget language switcher. Bármely, a témád által regisztrált widgetterületre: oldalsáv, fejléc, lábléc oszlopai.
• Footer language switcher. Egyetlen globális kapcsoló: a váltó minden oldal aljára kikerül.
• Inline links to translations of posts. Egy jelölőnégyzet: a bejegyzések fölött vagy alatt „ez a bejegyzés elérhető X nyelven” hivatkozások jelennek meg.
• Custom switchers. Ha a beépített elhelyezések nem elegek, a témafejlesztők a sablonfájlokból a WPML váltó-API-ját hívhatják. A beállítóoldalon a Customize gomb a megjelenítési lehetőségeket nyitja meg.

A váltó elrejtése egyes oldalakon

Vannak oldalak, ahol nincs szükség váltóra: a 404-es oldal, a fiókképernyők, a pénztár. A WPML feltételes megjelenítési szabályaival oldalanként elrejtheted a váltót anélkül, hogy a témában display:none CSS-t használnál. A szabályokat ugyanezen az oldalon adod meg: válaszd ki azokat az oldalakat, ahol rejtve legyen, a szabály minden elhelyezésre egyszerre érvényes.

URL-argumentumok megőrzése

Amikor a látogató a váltóra kattint, a WPML újraépíti a célnyelvi URL-t. Alapból a lekérdezési paraméterek (?utm_source=newsletter, szűrők stb.) elvesznek, ami elrontja az elemzési kampányokat és a szűrt listákat. A Preserve URL arguments mezőbe soronként írd be azokat a kulcsokat, amelyeknek át kell kerülniük a váltáskor. Részletek: URL-argumentumok megőrzése váltáskor.

Egyedi CSS

Az Additional CSS alatti egyetlen szövegmezőbe írt stílus az oldal összes nyelvváltójára érvényes. Így a témafájlok érintése nélkül hozhatod összhangba a váltót a témával.

A nyelvváltó sablonjának gyorsítótára

A WPML minden nyelvváltó kirenderelt HTML-jét gyorsítótárazza, ami gyorsabb oldalbetöltést ad forgalmas oldalon. A WPML 5.0-tól ehhez nincs beállítás: a gyorsítótár akkor működik, ha a WPML gyorsítótármappája írható. Ha megváltoztatsz egy váltóbeállítást, és nem látod az eredményt az oldalon, először a gyorsítótárat gyanítsd: a WPML → Support oldalon futtasd a Clear cache műveletet, majd töltsd újra az oldalt.

Egyedi váltók a téma kódjában

Ha a beépített elhelyezések nem elegek (egy váltó a fejléc egy meghatározott pontján, a téma által rajzolt egyedi legördülő, bármi, ami nem menü vagy widgetterület), a WPML API-t ad a témafejlesztőknek. A Custom language switchers kártyán van egy Enable kapcsoló és egy Customize gomb. Bekapcsolás után a sablonkód a dokumentált PHP API-val bárhol kirajzolhatja a váltót. Lásd: Nyelvváltó PHP-val és shortcode-dal.