Szűrők többnyelvűsítése WPML-lel

A JetSmartFilters kompatibilis a WPML-lel, így a szűrők címkéi, lehetőségei és a hozzájuk kapcsolódó tartalom bármelyik nyelvre lefordítható. A szűrők a háttérben és a nyilvános oldalon egyaránt működnek, ezért a taxonómiákat, a kategóriák slugjait, az egyéni mezőket és a szövegeket is le kell fordítani. Ha ez kimarad, a lefordított szűrő a második nyelvű oldalon nem fog működni.

Követelmények

• A WPML Multilingual CMS (vagy Multilingual Agency) csomagja telepítve és aktiválva
• JetSmartFilters

Alapok

1. Telepítsd és aktiváld a WPML Multilingual CMS és a WPML String Translation alapkomponenseket.
2. A WPML → Setup oldalon futtasd végig a gyorsbeállító varázslót, és regisztráld a WPML-t.
3. A WPML → Translation Dashboard oldalon választod ki a lefordítandó tartalmat.
4. Válaszd ki a fordítás módját: kézi vagy automatikus.

Előkészületek a WPML beállításaiban

A szűrők bejegyzéstípusa

1. Nyisd meg a WPML → Settings oldalt.

2. A Multilingual Content Setup fülön a Post Types Translation szakaszban keresd meg a Smart Filters bejegyzéstípust.

3. Három lehetőség közül választhatsz:

   Lehetőség	Hatása
   Translatable, only show translated items	Az oldalon csak a lefordított elemek jelennek meg.
   Translatable, use translation if available or fallback to default language	A lefordított elemek fordítással jelennek meg, a fordítás nélküliek az alapnyelven.
   Not translatable	A bejegyzéstípus változatlan marad.

4. Tedd fordíthatóvá a Smart Filters típust, és kattints a Save gombra.

Az egyéni mezők

1. A WPML → Settings oldalon keresd meg a Custom Fields Translation szakaszt, és kattints a neve melletti Show system fields hivatkozásra.

2. Keresd meg a JetSmartFilters mezőit: _filter_label és _filter_type.

3. Mezőnként négy beállítás közül választhatsz:

   Lehetőség	Hatása
   Don’t translate	A mező értéke a második nyelvű oldalakon is az alapnyelvi marad.
   Copy	Az alapnyelvi érték mindig átmásolódik a második nyelvre, akkor is, ha később módosítod.
   Copy once	Az érték az első fordításkor másolódik át, utána a második nyelven átírhatod, és nem íródik felül.
   Translate	A mező értéke fordítható.

4. A _filter_label mező legyen Translate, hogy a WPML felismerje a lefordítandó szűrőcímkéket. A _filter_type mező lehet Copy vagy Translate.

5. Ha a szűrő adatforrása egy egyéni mező (a példában a genres), azt is állítsd Translate értékre.

6. A szakasz alatt kattints a Save gombra.

A taxonómiák

A szűrés és az archívumkeresés mindig taxonómiákat használ, ezért a szűrőkhöz tartozó taxonómiákat, címkéket és kifejezéseket is le kell fordítani.

1. A WPML → Settings oldalon a Taxonomies Translation szakaszban keresd meg a szűrők által használt taxonómiákat, és tedd őket fordíthatóvá (a példában a „Book Term” a Translatable (only show translated items) értéket kapja).
2. Kattints a Save gombra.
3. Ellenőrizd, hogy a Slug translations szakasz beállítása be van kapcsolva, és mentsd. Ez szinkronizálja a lefordított kifejezéseket a nyelvek között. Nélküle a második nyelvű tartalom nem kapja meg a helyes címkéket és kategóriákat.

A kifejezések és slugok fordítása

A WPML a taxonómiákat a hozzájuk tartozó tartalom fordításakor magától fordítja. Külön fordításhoz:

1. Nyisd meg a WPML → Taxonomy Translation oldalt.
2. A Select the taxonomy to translate listából válaszd ki a taxonómiát (a példában „Book Term”).
3. Az egyes kifejezések fölé víve az egeret megjelenik a Copy to all languages hivatkozás, amellyel az alapnyelvi érték átmásolható a többi nyelvre.
4. A ceruza vagy a plusz ikonnal szerkesztheted vagy felveheted a fordítást. Add meg az új fordításokat, és kattints a Save gombra.
5. Ismételd meg minden kifejezésnél és minden nyelven, és ne feledd a taxonómia címkéit és slugjait sem lefordítani.

A szűrők fordítása

1. Nyisd meg az Intelligens szűrők → Minden szűrő listát, és kattints a kívánt szűrő melletti Edit gombra.
2. A Language panelen kattints a kívánt nyelv melletti plusz gombra.
3. Ugyanaz a szűrőszerkesztő nyílik meg, de most a célnyelvre fordítod a tartalmat: írd át a Szűrő neve mezőt, Kézi bevitel adatforrásnál pedig a Lehetőségek listája szakasz címkéit.
4. A többi mezőt hagyd változatlanul, töltsd ki a Szűrőcímkék szakaszt, és kattints az Update gombra.
5. Ugyanígy fordítsd le az összes szűrőt.

A szűrő az oldalon

1. Szerkessz egy oldalt (Oldalak → Új oldal) Elementorral, a blokkszerkesztővel vagy Bricksszel.
2. Add hozzá a WPML nyelvváltó widgetet, és állítsd be tetszés szerint.
3. Add hozzá a szűrő widgetet (a példában a Jelölőnégyzetek szűrőt): a Select filter mezőben válaszd ki a szűrőt, a This filter for mezőben pedig a szolgáltatót (a példában JetEngine).
4. Add hozzá a szolgáltatót, például a JetEngine Listing Grid widgetet, amelynek tartalmát előre lefordítottad.
5. Kattints a Publish gombra.

Az oldal lefordításához:

1. Nyisd meg a WPML → Translation Dashboard oldalt, bontsd ki a Pages szakaszt, és keresd meg az oldalt.
2. Jelöld ki, és kattints a Translate your content gombra.
3. A 2. lépésben válaszd ki a fordítás módját (a WPML a saját AI-fordítómotorját, a Private Translation Cloudot ajánlja).

Szövegek fordítása

1. A Translation Dashboard oldalon bontsd ki az Other texts (Strings) szakaszt. A WPML a nyilvános oldal megtekintésekor magától gyűjti ide a szövegeket.
2. Szűrhetsz tartomány szerint (például jet-smart-filters), vagy rákereshetsz egy szövegre.
3. Jelöld ki a fordítandó szövegeket, és a 2. lépésben küldd kézi vagy automatikus fordításra, mint bármely más tartalmat.
4. Ha JetEngine-es szűrőforrást használsz, fordítsd le a Jet Engine Admin Labels tartomány címkéit is.

Az eredmény ellenőrzése

Nyisd meg az oldalt a nyilvános felületen, és a nyelvváltóval válaszd ki a célnyelvet: a fordított tartalom megjelenik. Jelölj ki lehetőségeket a szűrőben, és ellenőrizd, hogy a szűrés megfelelően működik.

Ismert hibák

Ha a lefordított szűrők, szűrőlehetőségek vagy a szűrt tartalom a második nyelvű oldalon is az alapnyelven jelenik meg, bár a fordítások és a WPML is rendben vannak, a hiba a WPML nyelvi sütijével vagy a gyorsítótárral lehet kapcsolatos. A JetSmartFilters az AJAX-kérések közben a WPML nyelvfelismerésére támaszkodik. Ha a kérés nem kapja meg helyesen az aktuális nyelvet, a szűrési eredmények, a kifejezések és a lehetőségek az alapnyelven jelenhetnek meg.

1. Nyisd meg az érintett oldalt, és a böngésző fejlesztői eszközeiben lépj az Application → Cookies részre.
2. Ellenőrizd, hogy létezik-e a wp-wpml_current_language süti, és a kiválasztott nyelv kódját tartalmazza-e.
3. Ha a szűrés inkognitó módban működik, de a megszokott böngészőben nem, a gyorsítótár a hibás. Nézd át a gyorsítótár beállításait, és biztosítsd, hogy a WPML nyelvi sütijei megmaradnak és elérhetők az AJAX-kérések alatt.

A szójegyzék alapú szűrők fordításáról a Szójegyzék alapú szűrő fordítása fejezet szól.