Nesta página:
- Plug-ins necessários e configuração
- Explorando o esquema WPML GraphQL
- Consulta de informações sobre idiomas e traduções
- Filtragem de idiomas
- Consulta de dados de idiomas instalados
- Usando o WPML GraphQL com Gatsby e ACF
- Problemas Conhecidos
- Obtendo suporte
Plug-ins necessários e configuração
Para começar, instale e ative os seguintes plug-ins:
- Plug-in central WPML e o add-on String Translation
- Plug-in WPGraphQL
- WPML GraphQL plugin
Se você estiver executando um site com ACF ou ACF Pro e quiser expor campos multilíngues do plug-in ACF ao esquema WPGraphQL, instale e ative:
Explorando o esquema WPML GraphQL
WPML GraphQL se integra ao WPGraphQL e adiciona novos campos e filtros ao esquema do WPGraphQL.
Depois de instalar os plug-ins, você pode ir para GraphQL → GraphQL IDE e usar o Query Composer para consultar e filtrar facilmente o conteúdo em diferentes idiomas. Isso inclui:
- Obter informações sobre o idioma dos objetos consultados
- Obter traduções para objetos como tipos de post, taxonomias e comentários.
- Filtragem dos objetos consultados por idioma
Como exemplo, a imagem abaixo mostra como você pode recuperar uma lista de todas as postagens em um site WordPress, incluindo o código do idioma, o slug e o URI, bem como informações semelhantes para todas as traduções de cada postagem.
Para demonstrar como o WPML GraphQL funciona, configuramos um site com o inglês definido como o idioma padrão e o espanhol e o italiano como os idiomas secundários. Ao longo desta página de documentação, usamos esse site de teste para consultar os posts e as traduções de posts criadas pelo WPML.
Consulta de informações sobre idiomas e traduções
WPML GraphQL permite que você inclua campos de idioma e traduções em sua consulta. Este permite que você trabalhe com nós e elementos no GraphQL para recuperar dados específicos do idioma e traduções associadas.
- Você pode adicionar o campo de idioma às consultas para indicar o idioma dos tipos de post, taxonomias e comentários. Essa consulta fornece informações abrangentes sobre o idioma, como:
- O código do idioma
- URLs de bandeiras de países
- O nome nativo do idioma
- O nome traduzido do idioma
- O URL da página inicial
- Você pode usar o campo languageCode para coletar o código de idioma de posts, termos de taxonomia e comentários, sem solicitar nenhum outro detalhe específico do idioma.
- Você pode usar o campo de traduções para recuperar traduções de tipos de post e termos de taxonomia.
Abaixo, você pode ver um exemplo de uma consulta de posts que inclui esses campos.
query Posts{ posts(where: {language: "en"}) { nodes { slug uri language { code } translations { slug uri language { code } } } } }
A execução dessa consulta retorna informações de idioma e tradução para cada recurso.
{ "data": { "posts": { "nodes": [ { "slug": "bye-world", "uri": "/bye-world/", "language": { "code": "en" }, "translations": [ { "slug": "adios-mundo", "uri": "/es/adios-mundo/", "language": { "code": "es" } }, { "slug": "addio-mondo", "uri": "/it/addio-mondo/", "language": { "code": "it" } } ] }, { "slug": "hello-world", "uri": "/hello-world/", "language": { "code": "en" }, "translations": [ { "slug": "hola-mundo", "uri": "/es/hola-mundo/", "language": { "code": "es" } }, { "slug": "ciao-mondo", "uri": "/it/ciao-mondo/", "language": { "code": "it" } } ] } ] } } }
Filtragem de idiomas
O plugin WPML GraphQL vem equipado com um filtro de idioma, que permite refinar suas consultas para obter os dados exatos do idioma em que você está interessado.
Você pode usar o filtro de idioma para filtrar posts, termos de taxonomia ou comentários com base em um idioma específico. Você pode solicitar nós de um determinado idioma incluindo o filtro de idioma em sua consulta e também pode recuperar todos os itens, independentemente do idioma, usando o filtro de idioma com o valor definido como all.
Aqui está um exemplo de consulta que filtra as postagens por nosso idioma secundário, o espanhol:
query PostsES{ posts(where: {language: "es"}) { nodes { slug uri } } }
Como você pode ver, essa consulta obtém todas as postagens em espanhol.
{ "data": { "posts": { "nodes": [ { "slug": "adois-mundo", "uri": "/es/adios-mundo/" }, { "slug": "hola-mundo", "uri": "/es/hola-mundo/" } ] } } }
Consulta de dados de idiomas instalados
WPML GraphQL define duas consultas que permitem que você consulte dados dos idiomas instalados em seu site:
- Uma consulta de idiomas para obter todos os idiomas registrados, juntamente com os dados relevantes de cada um deles.
- Uma consulta defaultLanguage para obter o idioma definido como o idioma padrão, juntamente com seus dados relevantes.
Isso pode ser útil se você quiser, por exemplo, criar um alternador de idiomas.
Digamos que você queira consultar os dados de todos os idiomas instalados. Para isso, executamos a seguinte consulta:
query Languages { languages { code country_flag_url default_locale native_name translated_name url } }
A consulta acima produz o seguinte resultado:
{ "data": { "languages": [ { "code": "en", "country_flag_url": "http://site.com/wp-content/plugins/sitepress-multilingual-cms-release/res/flags/en.svg", "default_locale": "en_US", "native_name": "English", "translated_name": "English", "url": "http://site.com" }, { "code": "es", "country_flag_url": "http://site.com/wp-content/plugins/sitepress-multilingual-cms-release/res/flags/es.svg", "default_locale": "es_ES", "native_name": "Español", "translated_name": "Spanish", "url": "http://site.com/es/" }, { "code": "it", "country_flag_url": "http://site.com/wp-content/plugins/sitepress-multilingual-cms-release/res/flags/it.svg", "default_locale": "it_IT", "native_name": "Italiano", "translated_name": "Italian", "url": "http://site.com/it/" } ] } }
Usando o WPML GraphQL com Gatsby e ACF
A estrutura do Gatsby permite que você colete dados de diferentes fontes de back-end, incluindo sites WordPress.
Se o seu site WordPress estiver usando o WP GraphQL, você poderá fornecer os dados dele a um site Gatsby. Com o WPML GraphQL instalado, você pode fornecer dados em diferentes idiomas e até mesmo recuperar informações sobre o idioma.
Para oferecer funcionalidade adicional, o WP GraphQL tem um complemento para Advanced Custom Fields (ACF). Ao usar esse complemento junto com o plugin ACF Multilingual do WPML, você pode fornecer dados principais e dados de campos personalizados com base em requisitos específicos de idioma.
Vamos considerar um cenário de exemplo: Você tem uma instalação do Gatsby com o pacote complementargatsby-source-graphql, que recupera dados de um backend WordPress. Nesse back-end WordPress:
- Você tem WPML instalado com o espanhol definido como o idioma secundário.
- Você tem o ACF instalado e adicionou um grupo de campos (slug postfields) que inclui um campo de texto (slug subtitle) para postagens.
- Você preencheu alguns dados.
Com uma simples consulta GraphQL, você pode coletar esses dados.
No exemplo de consulta abaixo, recuperamos posts do backend WordPress em que o idioma está definido como inglês. Para cada publicação, podemos acessar o título, o código do idioma e os dados do campo ACF, como o subtítulo. Além disso, podemos recuperar traduções da postagem, incluindo seus títulos, códigos de idioma e dados de campo do ACF.
export const doQuery = graphql` { wordpress { posts(where: {language: "en"}) { nodes { title language { code } postfields{ subtitle } translations { title language { code } postfields{ subtitle } } } } } } `;
Problemas conhecidos
O WPML funciona bem com este plugin, mas às vezes pode haver problemas menores, os quais estamos trabalhando para resolver. Isso é esperado, já que ambos os plugins oferecem atualizações frequentes.
Problemas atuais não resolvidos:
- WPML GraphQL – No Results for Slug Queries in Secondary Languages
- WPML GraphQL – Cannot Retrieve Translated Author Metadata
Você também pode pesquisar todos os problemas conhecidos deste plugin, inclusive os resolvidos anteriormente.
Obtendo suporte
Se você precisar de ajuda para usar o WPML GraphQL com o WPGraphQL, acesse nosso fórum de suporte.