Többnyelvű tartalom lekérdezése WPGraphQL-lel
Nyelv szerinti szűrés, fordítások lekérdezése, többnyelvű menük és a webhely nyelveinek listája GraphQL-ben.
Ez a fejezet azt mutatja be, hogyan kérdezhetsz le többnyelvű tartalmat a WPGraphQL végpontján. A példák a webhely alapnyelvén (magyar), valamint angol és német fordításon futottak.
A GraphQL IDE: itt próbáld ki a lekérdezéseket
Szekció neve “A GraphQL IDE: itt próbáld ki a lekérdezéseket”A WPGraphQL egy GraphQL → GraphiQL IDE képernyőt ad az admin felülethez. A Query Composer felsorolja az összes elérhető mezőt, köztük a WPML language argumentumát és translations mezőjét, és az éles webhelyen futtatja a lekérdezést. Mielőtt a front-end keretrendszerbe építed, itt tesztelj.

A kép bal oldalán a lekérdezés, jobb oldalán az eredmény látszik: az angol bejegyzés két másik nyelvű változata.
Végpont és nyelv
Szekció neve “Végpont és nyelv”A WPGraphQL a /graphql címen válaszol. Ha egy lekérdezésben nincs language argumentum, az alapnyelvű tartalmat kapod. Más nyelvhez add hozzá a where: { language: "es" } szűrőt.
Tartalom lekérdezése nyelv szerint
Szekció neve “Tartalom lekérdezése nyelv szerint”A where: { language: "<kód>" } bármelyik listalekérdezésben használható: bejegyzések, egyéni bejegyzéstípusok, taxonómiakifejezések, menük, menüpontok, hozzászólások. A nyelvkód ugyanaz, amit a WPML mindenhol használ (en, es, fr, pt-pt stb.). A language: "all" az összes nyelv tartalmát egyszerre adja vissza, például webhelytérképhez vagy összesítő számhoz.
query PostsES { posts(where: { language: "es" }) { nodes { slug uri categories { nodes { name } } } }}Ha egy legfelső szintű elemet nyelv szerint szűrsz, a hozzá kapcsolt elemek (kategóriák, címkék, egyéni taxonómiák) automatikusan ugyanazt a nyelvet követik. A fenti lekérdezés spanyol bejegyzéseket ad spanyol kategóriákkal, külön argumentum nélkül.
Egy tartalom összes fordítása egy lekérdezésben
Szekció neve “Egy tartalom összes fordítása egy lekérdezésben”A translations mező bármelyik bejegyzés- vagy taxonómialekérdezéshez hozzáadható. Az elem többi nyelvi változatát adja vissza ugyanabban a válaszban: slug, URI, nyelvkód és bármilyen beágyazott mező, amit kérsz.
query PostsWithTranslations { posts(where: { language: "en" }) { nodes { slug uri language { code } translations { slug uri language { code } } } }}Minden bejegyzés megkapja a saját mezőit és a többi nyelvű változat slug-ját és URI-ját. Pontosan erre van szükség egy, a tartalom mellett megjelenő nyelvváltóhoz: egy kérés, és megvan minden alternatíva, amire a látogató válthat.
Egy bejegyzés lekérdezése azonosító vagy slug alapján
Szekció neve “Egy bejegyzés lekérdezése azonosító vagy slug alapján”Egyetlen fordított bejegyzést az egyes számú post lekérdezéssel és az idType megadásával kapsz meg (fordított slug vagy adatbázis-azonosító alapján):
query PostBySlug { post(id: "hola-mundo", idType: SLUG) { title slug uri language { code } }}query PostById { post(id: "2", idType: DATABASE_ID) { title slug uri language { code } }}Mindkettő a lefordított bejegyzést adja vissza (cím, slug, URI), és a front-enden nem kell külön kiszűrnöd, hogy fordításról van-e szó.
Többnyelvű menük
Szekció neve “Többnyelvű menük”A menük és a menüpontok ugyanazzal a where: { language } argumentummal kérdezhetők le. Egy sablon menüpozíciójának elemeihez add meg a pozíciót is:
query NavES { menuItems(where: { language: "es", location: PRIMARY }) { nodes { label url path } }}Egy nyelv menüinek listájához a menus lekérdezés való:
query MenusES { menus(where: { language: "es" }) { nodes { name locations } }}Minden menüpont label és url értéke a lekérdezett nyelven jön vissza. A lefordított bejegyzésre mutató menüpontok automatikusan a fordítás URI-jára oldódnak fel. Az egyes számú menu lekérdezésnek nincs language argumentuma, ezért a nyelv kiválasztásához a menus vagy a menuItems lekérdezést használd.
Hozzászólások és taxonómiák
Szekció neve “Hozzászólások és taxonómiák”- A hozzászólások lekérdezése is szűrhető nyelv szerint: az adott nyelvű bejegyzésekhez tartozó hozzászólásokat kapod.
- A kategóriák, címkék és egyéni taxonómiák alapból a bejegyzésük nyelvét követik, és közvetlenül is lekérdezhetők nyelv szerint.
A webhely nyelvei egy nyelvváltóhoz
Szekció neve “A webhely nyelvei egy nyelvváltóhoz”Egy, bármelyik bejegyzéstől független nyelvváltóhoz a languages és a defaultLanguage lekérdezés adja a nyelvek listáját:
query SiteLanguages { languages { code country_flag_url default_locale native_name translated_name url } defaultLanguage { code native_name }}Minden aktív nyelvhez egy elemet kapsz: a nyelvkódot, a zászló URL-jét, a hely kódját (default_locale), a nyelv saját nevét (native_name), a felület nyelvén írt nevét (translated_name) és a nyelv kezdőoldalának címét. Ennyi elég egy zászlós, feliratos nyelvváltóhoz, a nyelvek kézi felsorolása nélkül.
Készült: