Como traduzir uma aplicação privada com Weglot

Neste artigo, aprenderá a utilizar o Weglot para uma aplicação Web privada (como um SaaS), permitindo que o idioma seja guardado como uma preferência do utilizador em vez de utilizar um URL específico do idioma.

Como funciona

Na maioria dos casos, Weglot serve páginas traduzidas através de diferentes URLs usando subdirectórios. Por exemplo:

• Página original: https://www.example.com/about
• Versão francesa: https://www.example.com/fr/about

No entanto, para aplicações SaaS e outras ferramentas privadas, pode preferir mudar de idioma com base nas preferências do utilizador - sem alterar o URL.

Aplicações populares como Notion, Stripe, Facebook e X (antigo Twitter) utilizam este método, armazenando as preferências linguísticas nos perfis dos utilizadores.

Este guia irá mostrar-lhe como configurar o Weglot para funcionar de forma semelhante.

Pré-requisitos

Para tal, terá de armazenar as preferências linguísticas de cada utilizador do seu lado.

Siga estes passos:

1. Adicionar uma preferência de idioma aos perfis de utilizador:

   Crie uma nova propriedade (como uma coluna da base de dados) na sua tabela de utilizadores para guardar o idioma selecionado.

2. Implementar um alternador de línguas:

   Adicione um menu pendente de idioma na sua página de utilizador/perfil ou em qualquer outro local adequado para que os utilizadores seleccionem o seu idioma preferido.

3. Definir o cabeçalho de resposta:

   Depois de o utilizador selecionar uma língua, adicione o código da língua (um código de 2 letras) a todos os cabeçalhos de resposta HTTP. O cabeçalho que precisa de adicionar é: Weglot-Língua-Preferência

Eis um exemplo do aspeto que este cabeçalho deve ter nas Ferramentas de desenvolvimento do Chrome (separador Rede):

Instalação

Assim que a sua aplicação web incluir o Weglot-Língua-Preferência pode prosseguir com a instalação do Weglot.

1. Siga a integração padrão de subdirectórios do Weglot:

   Instale o Weglot como faria para qualquer outro sítio, utilizando a integração "Subdiretório"

2. Verificar os subdirectórios de idiomas:

   Após a instalação, verifique se as suas traduções aparecem nos URLs dos subdirectórios (por exemplo, /fr/ para francês).

3. Contactar o apoio:
   • Contacte a nossa equipa de apoio em support@weglot.com para ativar o modo de aplicação privada
   • Uma vez ativado, o Weglot utilizará o Weglot-Língua-Preferência em vez de se basear no URL para a deteção do idioma.