WPML GraphQL – WPGraphQL multilíngue para WordPress headless

Consulte o conteúdo por idioma a partir do seu front-end

Toda consulta do WPGraphQL ganha um argumento language. Filtre posts, tipos de post personalizados, termos de taxonomia, menus, itens de menu e comentários por idioma em um único campo – sem filtragem pós-consulta no front-end, sem dobrar o volume de requisições e sem adivinhação de idioma.

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

Quando você filtra um nó de nível superior por idioma, os itens conectados (categorias, tags, taxonomias personalizadas) seguem automaticamente o mesmo idioma. Os resultados são consistentes sem argumentos extras por campo aninhado.

Quer tudo, independentemente do idioma, para um sitemap ou contagem agregada? Passe language: "all".

Busque todas as traduções de um nó em uma única consulta

O campo translations em posts e termos de taxonomia retorna todas as versões em outros idiomas de um nó: slug, URI, código de idioma e quaisquer campos aninhados que você solicitar. Uma consulta, uma ida e volta, todas as versões de idioma de uma página.

Esses são os dados que você precisa para um seletor de idiomas renderizado ao lado do próprio conteúdo da página, sem fazer o front-end seguir uma cadeia de consultas relacionadas.

Menus multilíngues, taxonomias, comentários e dados de idioma

Além dos posts, o WPML GraphQL estende o mesmo argumento language e o tratamento de tradução para:

• Menus e itens de menu. menu(language: "fr") para navegação por idioma. Adicionado no WPML GraphQL 1.1.0.
• Termos de taxonomia. Categorias, tags e taxonomias personalizadas seguem o idioma do post por padrão e podem ser consultadas por idioma diretamente.
• Comentários. Retorne comentários associados a posts em um idioma específico.
• Consultas languages e defaultLanguage. Liste todos os idiomas instalados no site com código, localidade, nome nativo, URL da bandeira do país e URL inicial. O formato de dados certo para um seletor de idiomas personalizado.

Consulte um post específico por ID ou slug, em qualquer idioma

Dois formatos de consulta obtêm um único post traduzido por seu identificador específico do idioma:

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

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

Qualquer um dos formatos retorna o post traduzido com seu título, slug e URI traduzidos – sem uma lógica separada de “isso é uma tradução?” no front-end.

Mantido em conformidade com a versão atual do WPGraphQL

O WPML GraphQL 1.1.3 é testado até o WPGraphQL 2.0.0, o caminho principal de versão em que o projeto WPGraphQL se encontra. A equipe que mantém o WPGraphQL trabalha conosco para que a camada multilíngue continue acompanhando o esquema. Quando o WPGraphQL lança uma nova versão, o WPML GraphQL a acompanha logo em seguida.

Funciona com o ACF quando você adiciona o ACFML e o WPGraphQL for ACF

Para sites que criam seus modelos de conteúdo no Advanced Custom Fields e expõem esses campos através do WPGraphQL, o WPML GraphQL se integra ao ACFML e ao WPGraphQL for ACF para adicionar um argumento language às consultas da página de opções do ACF:

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

Os campos do ACF em posts e CPTs seguem o idioma do post hospedeiro automaticamente.