Localize sua experiência de login do Logto com OIDC ui_locales
Faça com que sua experiência de login pareça nativa para cada usuário. Neste tutorial, você vai aprender como usar o parâmetro padrão OIDC ui_locales para definir o idioma em tempo de execução da interface de login do Logto e dos e-mails relacionados.
CharlesDeveloper
Pare de perder semanas com autenticação de usuários
Lance aplicativos seguros mais rapidamente com o Logto. Integre a autenticação de usuários em minutos e concentre-se no seu produto principal.
O Logto já oferece suporte a conteúdo multilíngue e detecção automática, mas há situações em que você quer escolher explicitamente o idioma para uma interação específica:
Produtos multi-organizacionais com preferências de idioma diferentes por organização
Links diretos de campanhas em um idioma específico
Páginas de produto com CTAs localizados que iniciam o login no mesmo idioma
Testes A/B para onboarding localizado
Além disso, ui_locales é um parâmetro padrão suportado por muitos provedores de identidade e SDKs.
Os SDKs do Logto permitem passar parâmetros OIDC extras durante o login. Adicione ui_locales em extraParams:
Observações:
Forneça uma lista separada por espaços de tags BCP 47. O Logto irá escolher o primeiro tag que existe na biblioteca de idiomas do seu tenant (ex.: fr-CA, senão fr, senão en).
Funciona por interação—o idioma padrão do seu tenant não é alterado.
Você pode combinar ui_locales com outros parâmetros padrão/personalizados (ex.: login_hint, organization_id ou instruções para a primeira tela).
Opção 2: Adicione ui_locales à sua URL de autorização#
Se você estiver montando a requisição de autorização OIDC manualmente (ou via cliente OIDC genérico), adicione ui_locales diretamente:
Quando uma interação dispara um e-mail (ex.: código de verificação), o Logto resolve o idioma nessa ordem:
ui_locales (primeiro tag suportado)
Caso contrário, detecta automaticamente pelo header HTTP Accept-Language
Caso contrário, idioma padrão do tenant
Depois, o Logto tenta encontrar um template de e-mail personalizado que corresponda ao idioma resolvido e tipo de template; se não encontrar, faz fallback para o padrão do conector.
Templates gerenciados por provedor (ex.: Postmark, HTTP Email): O Logto envia uiLocales e locale para seu provedor. Se ui_locales estiver presente, locale utiliza o primeiro tag suportado de ui_locales.
