# 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

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 GraphiQL IDE egy angol nyelvű bejegyzés fordításainak lekérdezésével](./kepek/graphql-ide-forditasok.webp)

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

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

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

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.

```graphql
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

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.

```graphql
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

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):

```graphql
query PostBySlug {
  post(id: "hola-mundo", idType: SLUG) {
    title
    slug
    uri
    language { code }
  }
}
```

```graphql
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

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:

```graphql
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ó:

```graphql
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

- 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

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:

```graphql
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.
