WPML GraphQL – Mehrsprachiges WPGraphQL für Headless WordPress

Inhalte pro Sprache über Ihr Frontend abfragen

Jede WPGraphQL-Abfrage erhält ein language-Argument. Filtern Sie Beiträge, benutzerdefinierte Beitragstypen, Taxonomie-Begriffe, Menüs, Menüpunkte und Kommentare nach Sprache in einem einzigen Feld – keine Filterung nach der Abfrage im Frontend, keine Verdoppelung des Anfragevolumens, kein Erraten der Sprache.

query PostsES {
  posts(where: { language: "es" }) {
    nodes { slug uri title }
  }
}

Wenn Sie einen Knoten der obersten Ebene nach Sprache filtern, folgen verbundene Elemente (Kategorien, Schlagwörter, benutzerdefinierte Taxonomien) automatisch derselben Sprache. Die Ergebnisse sind konsistent, ohne dass zusätzliche Argumente pro verschachteltem Feld erforderlich sind.

Möchten Sie alles unabhängig von der Sprache für eine Sitemap oder eine Gesamtzahl? Übergeben Sie language: "all".

Jede Übersetzung eines Knotens in einer einzigen Abfrage abrufen

Das Feld translations bei Beiträgen und Taxonomie-Begriffen gibt jede anderssprachige Version eines Knotens zurück: Slug, URI, Sprachcode und alle verschachtelten Felder, die Sie anfordern. Eine Abfrage, ein Roundtrip, jede Sprachversion einer Seite.

Das sind die Daten, die Sie für einen Sprachumschalter benötigen, der neben dem eigentlichen Seiteninhalt gerendert wird, ohne dass das Frontend einer Kette verwandter Abfragen folgen muss.

Mehrsprachige Menüs, Taxonomien, Kommentare und Sprachdaten

Über Beiträge hinaus erweitert WPML GraphQL dasselbe language-Argument und die Übersetzungsbehandlung auf:

• Menüs und Menüpunkte. menu(language: "fr") für die Navigation pro Sprache. Hinzugefügt in WPML GraphQL 1.1.0.
• Taxonomie-Begriffe. Kategorien, Schlagwörter und benutzerdefinierte Taxonomien folgen standardmäßig der Sprache ihres Beitrags und können direkt pro Sprache abgefragt werden.
• Kommentare. Geben Sie Kommentare zurück, die mit Beiträgen in einer bestimmten Sprache verknüpft sind.
• languages- und defaultLanguage-Abfragen. Listen Sie jede installierte Sprache auf der Website mit Code, Gebietsschema (Locale), nativem Namen, URL der Länderflagge und Startseiten-URL auf. Das richtige Datenformat für einen benutzerdefinierten Sprachumschalter.

Einen bestimmten Beitrag anhand von ID oder Slug in jeder beliebigen Sprache abfragen

Zwei Abfrageformen rufen einen einzelnen übersetzten Beitrag anhand seines sprachspezifischen Bezeichners ab:

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

query PostById {
  post(id: "2", idType: DATABASE_ID) {
    title slug uri
  }
}

Beide Formen geben den übersetzten Beitrag mit seinem übersetzten Titel, Slug und URI zurück – ohne separate „Ist das eine Übersetzung?“-Logik im Frontend.

Gepflegt für die aktuelle WPGraphQL-Version

WPML GraphQL 1.1.3 wurde bis WPGraphQL 2.0.0 getestet, dem Hauptversionspfad, auf dem sich das WPGraphQL-Projekt befindet. Das Team, das WPGraphQL pflegt, arbeitet mit uns zusammen, damit sich die mehrsprachige Ebene mit dem Schema weiterentwickelt. Wenn WPGraphQL eine neue Version veröffentlicht, zieht WPML GraphQL direkt nach.

Funktioniert mit ACF, wenn Sie ACFML und WPGraphQL for ACF hinzufügen

Für Websites, die ihre Inhaltsmodelle in Advanced Custom Fields erstellen und diese Felder über WPGraphQL bereitstellen, lässt sich WPML GraphQL mit ACFML und WPGraphQL for ACF kombinieren, um ein language-Argument zu Abfragen der ACF-Optionsseite hinzuzufügen:

query Settings {
  myOptionPage(language: "de") {
    addressFieldGroup {
      addressTitle
      repeaterAddressDetails { addressDetails }
    }
  }
}

ACF-Felder bei Beiträgen und CPTs folgen automatisch der Sprache des Host-Beitrags.