Como traduzir uma aplicação privada com Weglot

Neste artigo, aprenderá a utilizar o Weglot numa aplicação Web privada (como um SaaS), permitindo que o idioma preferido de cada utilizador seja armazenado e utilizado, sem depender de URLs específicos do idioma.

Como funciona

Por defeito, o Weglot usa subdirectórios para mostrar as traduções:

• Página original: https://www.example.com/about

• Versão francesa: https://www.example.com/fr/about

  
  

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

Esta abordagem é normalmente utilizada por plataformas como a Notion, Stripe, Facebook e X (antigo Twitter), onde o idioma é guardado no perfil do utilizador.

O Weglot pode suportar esta configuração através de uma configuração personalizada. Veja como.

Pré-requisitos

Para tal, a sua aplicação deve poder armazenar e recuperar a língua preferida de cada utilizador.

Siga estes passos:

1. Armazenar o idioma preferido nos perfis de utilizador

   Crie uma propriedade na sua base de dados de utilizadores (por exemplo, uma coluna como language_code) para armazenar o código de idioma de 2 letras selecionado por cada utilizador.

2. Adicionar um alternador de idiomas

   Permita que os seus utilizadores escolham o seu idioma preferido através de um menu pendente - idealmente na sua conta ou página de perfil.

3. Enviar um cabeçalho de resposta HTTP personalizado

   Sempre que uma página for carregada para um utilizador com sessão iniciada, inclua o seguinte cabeçalho de resposta HTTP:

   Weglot-Language-Preference: fr

   (Substituir fr pelo código de 2 letras correspondente à língua selecionada).

   
   

Pode inspecionar o cabeçalho utilizando o separador DevTools > Rede do Chrome. Eis um exemplo do aspeto que este cabeçalho deve ter:

Instalação

Assim que a sua aplicação web incluir o Weglot-Language-Preference pode prosseguir com a instalação do Weglot.

1. Configurar o Weglot utilizando uma integração de subdirectórios

   Siga os passos de instalação padrão do Weglot utilizando o método "Subdiretório".

   👉 Como utilizar subdirectórios com o Weglot

2. Verificar se os subdirectórios de idiomas estão a funcionar

   Certifique-se de que as suas traduções estão acessíveis através de URLs como /fr/, /de/, etc.

3. Contactar a nossa equipa de apoio

   Quando tudo estiver pronto, envie-nos uma mensagem para support@weglot.com.

   Peça-nos para ativar o modo de Aplicação Privada no seu projeto.

   Uma vez ativado, o Weglot utilizará o Weglot-Language-Preference em vez do caminho do URL para determinar o idioma a apresentar.