Idiomas localizados
O Logto oferece suporte a uma ampla variedade de idiomas predefinidos e disponibiliza 113 tags de idioma adicionais. Essa poderosa ferramenta permite personalizar a experiência de login criando e gerenciando suas próprias opções de idioma e tradução.
Etapas de personalização no Logto Console
Personalize facilmente as configurações de idioma no Logto Console sem necessidade de programação.
- Navegue até: Console > Experiência de login > Conteúdo > Idiomas.
- Gerenciar idioma: Clique no botão “Gerenciar idioma” para acessar sua biblioteca de idiomas.
- Editar idiomas existentes: Personalize as traduções dos idiomas fornecidos pelo Logto. Esses idiomas não podem ser excluídos, mas suas alterações substituirão os valores padrão.
- Adicionar um novo idioma: Clique no botão “Adicionar idioma”, selecione uma tag de idioma, forneça suas traduções e salve as alterações para adicionar um novo idioma.
- Ativar detecção automática: Quando ativada, exibe automaticamente a página de login no idioma preferido do usuário com base nas configurações do dispositivo.
- Definir idioma padrão: Você pode escolher um idioma padrão da sua biblioteca de idiomas. Ele será usado quando o idioma detectado do usuário não estiver coberto na biblioteca de idiomas atual.
Aqui estão alguns termos-chave para entender ao gerenciar idiomas:
Definição | Descrição |
---|---|
Tag de idioma | A tag de idioma identifica o idioma do conteúdo. Uma tag de idioma é composta por um código de idioma (por exemplo, en, fr, zh) e um código de país/região (por exemplo, US, UK, KR) separados por hífens. Uma tag de idioma se parece com isto: en-US. |
Idioma fornecido pelo Logto | Idioma fornecido pelo Logto é o idioma oficial do Logto e está armazenado no código-fonte original do Logto. |
Idioma adicionado | Idioma adicionado é o idioma incluído pelos usuários. |
Valores de origem do Logto | Valores de origem do Logto são valores fornecidos pelo Logto que não foram personalizados pelos usuários. |
Valores personalizados | Valores personalizados são valores que já foram personalizados pelos usuários. Os valores de origem do Logto serão sobrescritos. |
Personalização usando a Management API
Você pode usar a Management API PUT /api/custom-phrases/{languageTag} para personalizar traduções de idiomas. O corpo da requisição da API é um objeto de localidade parcial como:
{
"input": { "username": "Username", "password": "Password" },
"secondary": {
"social_bind_with": "Já possui uma conta? Faça login para vincular {{methods, list(type: disjunction;)}} com sua identidade social."
},
"action": { "sign_in": "Entrar" },
"error": {
"general_required": "{{types, list(type: disjunction;)}} é obrigatório"
},
"list": { "or": "ou" },
"user_scopes": {
"descriptions": { "custom_data": "Seus dados personalizados" }
}
}
Consulte o código-fonte para ver todos os conteúdos personalizáveis.
Você também pode usar a PATCH /api/sign-in-exp API para controlar as políticas de detecção de idioma.
Resolução de idioma em tempo de execução
Em tempo de execução, o idioma da experiência de login é resolvido com a seguinte precedência:
- Parâmetro
ui_locales
do OIDC da solicitação de autenticação atual (a primeira tag suportada é usada). Veja ui_locales. - Caso contrário, se a "detecção automática" estiver ativada, o idioma do cliente do usuário detectado (por exemplo, do cabeçalho HTTP
Accept-Language
). - Caso contrário, o idioma padrão do tenant na Experiência de Login.
Essa resolução também afeta a localização de emails para mensagens disparadas pela interação. Saiba mais: Localização de templates de email.
Casos de uso
Como o idioma adicionado aparece para os clientes finais?
Vamos supor que você tenha um site onde o inglês é o idioma padrão e a detecção automática está ativada. Um usuário do Japão acessa seu site e decide criar uma conta. Se ele/ela usar o japonês como idioma do aplicativo, mas o Logto ainda não oferecer suporte ao idioma, a tela de login aparecerá em inglês.
A experiência de login i18n do Logto torna possível o idioma personalizado.
Clique na tag de idioma ja
para adicionar sua própria tradução em japonês.
Dessa forma, o usuário acessando seu site do Japão poderá ler o conteúdo em japonês, que você acabou de traduzir do inglês.
Perguntas frequentes
E se o idioma que adicionei se tornar um idioma fornecido pelo Logto?
Ao lado da tag de idioma à esquerda, aparecerá uma tag de idioma fornecida pelo Logto, e o idioma que você adicionou não poderá mais ser removido. Os valores modificados continuam funcionando e substituem os valores originais do Logto. Apague os valores fornecidos pelo usuário para usar os valores fornecidos pela configuração padrão do Logto.
E se eu tiver adicionado apenas alguns valores personalizados?
O que os usuários finais veem é o resultado da mesclagem das duas colunas. Suponha que você queira ajustar apenas um subconjunto dos textos originais fornecidos pelo Logto. A única diferença entre sua tela de cadastro e a fornecida pelo Logto serão as chaves que você editou. O restante do conteúdo permanecerá inalterado.
Recursos relacionados
Suporte ao árabe e layout de idioma RTL (da direita para a esquerda) em seu aplicativo