Documentação Universally

Guias passo a passo, dicas de SEO multilíngue e melhores práticas para ajudar você a traduzir e escalar seu site WordPress.

Verifique sua instalação

Ver texto traduzido não é exatamente uma prova, e não vê-lo não é exatamente uma falha. Esta página oferece quatro verificações que falham de maneiras diferentes, então um problema indica onde ele está em vez de deixar você adivinhando.

Verificação 1: o painel verifica seu site

Abra o projeto e escolha Configurações da API. Para um projeto WordPress, isso verifica seu site ao vivo e relata um dos quatro resultados:

  • Plugin conectado. O painel alcançou o plugin e o link é válido.
  • Plugin Universally não detectado. Seu site respondeu, mas nenhum plugin Universally foi encontrado nele.
  • Não foi possível alcançar seu site. Nenhuma resposta, o que aponta para DNS, um firewall ou um host bloqueando solicitações de saída e entrada. Corrija a alcançabilidade e use Verificar novamente.
  • Seu plugin Universally está desatualizado. O plugin está lá, mas muito antigo para confirmar a conexão. Use Atualizar o plugin e verifique novamente.

Esta é a primeira verificação mais rápida porque ela diferencia "muito antigo" e "inacessível" de "não conectado", o que nada no próprio site pode fazer.

Verificação 2: um URL traduzido responde

Abra seu site com um código de idioma no caminho, por exemplo https://seusite.com/es/, usando um idioma que você realmente habilitou.

  • A página carrega em espanhol. A tradução está funcionando. A primeira carga é a lenta, pois é quando a página é traduzida; recarregue e deve ser rápido.
  • Você recebe um 404. O prefixo não foi resolvido para um idioma habilitado. Confirme se o idioma está adicionado e habilitado para o projeto, então abra Universally » Geral » Idiomas no WordPress e use Atualizar: essa tabela lista o URL ao vivo para cada idioma, e o prefixo que você está digitando deve corresponder exatamente a ele. Uma variante regional pode usar um prefixo de país como /mx/ em vez de /es/.
  • A página carrega em inglês. A solicitação chegou ao seu site, mas não foi traduzida. Continue para a verificação 3.

Re-salvar permalinks não ajuda aqui. O Universally não adiciona regras de reescrita do WordPress, então não há nada para um flush de permalink capturar.

Verificação 3: a página diz qual idioma ela é

Esta é a verificação que vale a pena saber, pois separa "não traduzido" de "traduzido, e você está vendo uma cópia em cache da página em inglês".

Visualize a origem no URL traduzido e procure a tag <html> de abertura. Em uma página traduzida, ela carrega o idioma de destino e uma direção:

<html lang="es-es" dir="ltr" translate="no">

Três coisas para ler lá:

  • lang é o idioma realmente servido, com sua região, em minúsculas: es-es, es-mx, fr-fr, pt-br. Se ainda começar com en em /es/, nada traduziu a resposta.
  • dir é rtl para os nove idiomas da direita para a esquerda e ltr para todo o resto. Veja Idiomas da direita para a esquerda.
  • translate="no" diz ao navegador para não oferecer sua própria tradução de uma página que já está traduzida. Sua presença é um sinal confiável de que a resposta veio via Universally.

Se sua página de origem já inclui og:locale ou uma meta tag Content-Language, elas também são atualizadas para o idioma de destino. Nenhuma é adicionada quando não estava lá para começar, então sua ausência não prova nada.

Verificação 4: o seletor está onde você o colocou

Um rodapé de site com o seletor de idioma no canto inferior direito, mostrando uma bandeira e o rótulo English

Se não houver nenhum seletor, a causa provável é a configuração Implementação do plugin estar como Personalizado, o que significa que nada é inserido até que você o coloque. Veja O seletor não está visível.

O seletor é apenas de apresentação. Um seletor ausente não significa que a tradução está quebrada, e um seletor funcionando não prova que a conexão está saudável, razão pela qual é a última verificação em vez da primeira.

Quando as verificações discordam

Traduzido em uma janela particular, inglês na sua normal. Seu navegador armazenou em cache a página em inglês. Recarregue-a forçadamente.

Traduzido para você, inglês para visitantes. Um cache de página ou CDN está servindo um idioma para todos. Veja Cache e CDNs.

Algumas páginas traduzem, outras não. Essas páginas provavelmente estão excluídas, por padrão de URL ou por seletor. Veja Excluir páginas.

Texto que nunca traduz, em lugar nenhum. O conteúdo injetado por JavaScript após o carregamento não está no HTML quando a tradução acontece. Veja Traduzir conteúdo dinâmico e de JavaScript.

Nada traduz e o plugin parece bom. Verifique o Domínio do projeto em Configurações Gerais em relação ao endereço que você está navegando. Uma incompatibilidade falha silenciosamente e serve todas as páginas no idioma de origem; apenas as formas básicas e www. contam como o mesmo site. Em seguida, confirme a conexão de ambas as extremidades: o painel API em Universally » Geral no WordPress e verifique o item 1 acima. Alguns hosts gerenciados também bloqueiam solicitações de saída para api.universally.com.

Isso foi útil?