WPML GraphQL – WPGraphQL multilingue per WordPress headless

Esegui query sui contenuti per lingua dal tuo front-end

Ogni query WPGraphQL ottiene un argomento language. Filtra articoli, tipi di post personalizzati, termini della tassonomia, menu, voci di menu e commenti per lingua in un singolo campo: nessun filtraggio post-query sul front-end, nessun raddoppio del volume delle richieste, nessuna supposizione sulla lingua.

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

Quando filtri un nodo di primo livello per lingua, gli elementi collegati (categorie, tag, tassonomie personalizzate) seguono automaticamente la stessa lingua. I risultati sono coerenti senza argomenti aggiuntivi per ogni campo nidificato.

Vuoi tutto indipendentemente dalla lingua per una sitemap o un conteggio aggregato? Passa language: "all".

Recupera ogni traduzione di un nodo in una sola query

Il campo translations sugli articoli e sui termini della tassonomia restituisce ogni versione in un’altra lingua di un nodo: slug, URI, codice della lingua e qualsiasi campo nidificato tu richieda. Una query, un solo ciclo di richiesta e risposta, ogni versione linguistica di una pagina.

Questi sono i dati di cui hai bisogno per un selettore di lingua renderizzato accanto al contenuto della pagina stessa, senza costringere il front-end a seguire una catena di query correlate.

Menu multilingue, tassonomie, commenti e dati sulla lingua

Oltre agli articoli, WPML GraphQL estende lo stesso argomento language e la gestione delle traduzioni a:

• Menu e voci di menu. menu(language: "fr") per la navigazione specifica per lingua. Aggiunto in WPML GraphQL 1.1.0.
• Termini della tassonomia. Le categorie, i tag e le tassonomie personalizzate seguono per impostazione predefinita la lingua del loro articolo e possono essere interrogati direttamente per lingua.
• Commenti. Restituisce i commenti associati agli articoli in una lingua specifica.
• Query languages e defaultLanguage. Elenca ogni lingua installata sul sito con codice, locale, nome nativo, URL della bandiera del paese e URL della home. Il formato dati giusto per un selettore di lingua personalizzato.

Esegui query su un articolo specifico per ID o slug, in qualsiasi lingua

Due strutture di query ottengono un singolo articolo tradotto tramite il suo identificatore specifico per la lingua:

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

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

Entrambe le forme restituiscono l’articolo tradotto con il suo titolo, slug e URI tradotti, senza una logica separata del tipo “è una traduzione?” sul front-end.

Mantenuto in linea con la versione attuale di WPGraphQL

WPML GraphQL 1.1.3 è testato fino a WPGraphQL 2.0.0, il percorso della versione principale su cui si trova il progetto WPGraphQL. Il team che mantiene WPGraphQL lavora con noi in modo che il livello multilingue continui a muoversi con lo schema. Quando WPGraphQL pubblica una nuova versione, WPML GraphQL lo segue a ruota.

Funziona con ACF quando aggiungi ACFML e WPGraphQL for ACF

Per i siti che costruiscono i loro modelli di contenuto in Advanced Custom Fields ed espongono quei campi tramite WPGraphQL, WPML GraphQL si integra con ACFML e WPGraphQL for ACF per aggiungere un argomento language alle query della pagina delle opzioni di ACF:

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

I campi ACF sugli articoli e sui CPT seguono automaticamente la lingua dell’articolo ospite.