Tovább a tartalomhoz

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.

https://minta-bolt.hu/wp-admin/admin.php?page=graphiql-ide&query=I4VwpgTgngBACgewM4BckFEByMDeAoGAB2TQAoB3AC0jAC5cYAbAQwDsBzEZ9umAIjCs%2BMAL4BKXAVYIAJmCSSYSRiHYEQEAJYEUENsuYpNCVgvxKVamBu1M2nbmAYBjWU5EEPoz3hFA
A GraphiQL IDE egy angol nyelvű bejegyzés fordításainak lekérdezésével

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.

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.

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ó.

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.

  • 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.

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:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások