WPML GraphQL – WPGraphQL multilingue pour un WordPress headless

Interrogez le contenu par langue depuis votre front-end

Chaque requête WPGraphQL gagne un argument language. Filtrez les articles, les types de publication personnalisés, les termes de taxonomie, les menus, les éléments de menu et les commentaires par langue dans un seul champ – aucun filtrage post-requête sur le front-end, aucun doublement du volume de requêtes, aucune supposition de la langue.

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

Lorsque vous filtrez un nœud de niveau supérieur par langue, les éléments connectés (catégories, étiquettes, taxonomies personnalisées) suivent automatiquement la même langue. Les résultats sont cohérents sans arguments supplémentaires par champ imbriqué.

Vous voulez tout obtenir indépendamment de la langue pour un sitemap XML ou un compte global ? Passez language: "all".

Récupérez toutes les traductions d’un nœud en une seule requête

Le champ translations sur les articles et les termes de taxonomie renvoie toutes les versions dans d'autres langues d’un nœud : slug, URI, code de langue et tout champ imbriqué que vous demandez. Une requête, un aller-retour, toutes les versions linguistiques d’une page.

Ce sont les données dont vous avez besoin pour un sélecteur de langue rendu à côté du contenu de la page lui-même, sans obliger le front-end à suivre une chaîne de requêtes associées.

Menus multilingues, taxonomies, commentaires et données de langue

Au-delà des articles, WPML GraphQL étend le même argument language et la même gestion des traductions à :

• Menus et éléments de menu. menu(language: "fr") pour une navigation par langue. Ajouté dans WPML GraphQL 1.1.0.
• Termes de taxonomie. Les catégories, les étiquettes et les taxonomies personnalisées suivent la langue de leur article par défaut et peuvent être interrogées directement par langue.
• Commentaires. Renvoyez les commentaires associés aux articles dans une langue spécifique.
• Requêtes languages et defaultLanguage. Répertoriez chaque langue installée sur le site avec son code, ses paramètres régionaux (locale), son nom natif, l’URL du drapeau du pays et l’URL d’accueil. La structure de données idéale pour un sélecteur de langue personnalisé.

Interrogez un article spécifique par ID ou slug, dans n'importe quelle langue

Deux formats de requête permettent d’obtenir un seul article traduit par son identifiant spécifique à la langue :

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

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

L’une ou l’autre forme renvoie l’article traduit avec son titre, son slug et son URI traduits – sans logique distincte « est-ce une traduction ? » sur le front-end.

Maintenu pour la version actuelle de WPGraphQL

WPML GraphQL 1.1.3 est testé jusqu’à WPGraphQL 2.0.0, la voie de version majeure sur laquelle se trouve le projet WPGraphQL. L’équipe qui maintient WPGraphQL collabore avec nous pour que la couche multilingue continue d’évoluer avec le schéma. Lorsque WPGraphQL publie une nouvelle version, WPML GraphQL suit de près.

Fonctionne avec ACF lorsque vous ajoutez ACFML et WPGraphQL for ACF

Pour les sites qui construisent leurs modèles de contenu dans Advanced Custom Fields et exposent ces champs via WPGraphQL, WPML GraphQL se combine avec ACFML et WPGraphQL for ACF pour ajouter un argument language aux requêtes de la page Options d’ACF :

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

Les champs ACF sur les articles et les CPT suivent automatiquement la langue de l’article hôte.