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çã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:

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 e-mails para mensagens disparadas pela interação. Saiba mais: Localização de templates de e-mail.

Casos de uso

Como o idioma adicionado aparece para os clientes finais?

Suponha 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 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 do Logto i18n torna possível a personalização de idiomas.

Clique na tag de idioma ja para adicionar sua própria tradução para o 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 indicando que é fornecido 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.

Como posso definir um código de país padrão para número de telefone na experiência de login?

O código de país do número de telefone na experiência de login é definido por padrão de acordo com o local do navegador do usuário. Por exemplo, se o idioma do navegador do usuário estiver definido como fr, o código do país será definido como França (+33).

Para controlar programaticamente o código de país padrão para usuários ou regiões específicas, você pode usar o parâmetro de autenticação ui_locales. Por exemplo, definir ui_locales=ja fará com que o código do país padrão seja Japão (+81).

Recursos relacionados

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