Pular para o conteúdo principal

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.

  1. Navegue até: Console > Experiência de login > Conteúdo > Idiomas.
  2. 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.
  3. 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.
  4. 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çãoDescrição
Tag de idiomaA 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 LogtoIdioma fornecido pelo Logto é o idioma oficial do Logto e está armazenado no código-fonte original do Logto.
Idioma adicionadoIdioma adicionado é o idioma incluído pelos usuários.
Valores de origem do LogtoValores de origem do Logto são valores fornecidos pelo Logto que não foram personalizados pelos usuários.
Valores personalizadosValores 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:

  1. Parâmetro ui_locales do OIDC da solicitação de autenticação atual (a primeira tag suportada é usada). Veja ui_locales.
  2. 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).
  3. 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.

Suporte ao árabe e layout de idioma RTL (da direita para a esquerda) em seu aplicativo