Idiomas localizados
Logto admite una amplia gama de idiomas predefinidos y ofrece 113 etiquetas de idioma adicionales. Esta poderosa herramienta te permite personalizar la experiencia de inicio de sesión creando y gestionando tus propias opciones de idioma y traducción.
Pasos de personalización en Logto Console
Personaliza fácilmente la configuración de idioma en Logto Console sin necesidad de programar.
- Navega a: Console > Experiencia de inicio de sesión > Contenido > Idiomas.
- Gestionar idioma: Haz clic en el botón “Gestionar idioma” para acceder a tu biblioteca de idiomas.
- Editar idiomas existentes: Personaliza las traducciones de los idiomas proporcionados por Logto. Estos idiomas no se pueden eliminar, pero tus cambios sobrescribirán los valores predeterminados.
- Agregar un nuevo idioma: Haz clic en el botón “Agregar idioma”, selecciona una etiqueta de idioma, proporciona tus traducciones y guarda los cambios para añadir un nuevo idioma.
- Habilitar detección automática: Cuando está habilitado, muestra automáticamente la página de inicio de sesión en el idioma preferido del usuario según la configuración de su dispositivo.
- Establecer idioma predeterminado: Puedes elegir un idioma predeterminado de tu biblioteca de idiomas. Se usará cuando el idioma detectado del usuario no esté cubierto en la biblioteca de idiomas actual.
Aquí tienes algunos términos clave para comprender al gestionar idiomas:
Definición | Descripción |
---|---|
Etiqueta de idioma | La etiqueta de idioma identifica el idioma del contenido. Una etiqueta de idioma se compone de un código de idioma (por ejemplo, en, fr, zh) y un código de país/región (por ejemplo, US, UK, KR) separados por guiones. Ejemplo: en-US. |
Idioma proporcionado por Logto | El idioma proporcionado por Logto es el idioma oficial de Logto y se almacena en el código fuente original de Logto. |
Idioma añadido | El idioma añadido es el idioma agregado por los usuarios. |
Valores fuente de Logto | Los valores fuente de Logto son los valores suministrados por Logto que no han sido personalizados por los usuarios. |
Valores personalizados | Los valores personalizados son valores que ya han sido personalizados por los usuarios. Los valores fuente de Logto serán sobrescritos. |
Personalización usando Management API
Puedes usar el Management API PUT /api/custom-phrases/{languageTag} para personalizar las traducciones de idioma. El cuerpo de la solicitud API es un objeto de localización parcial como:
{
"input": { "username": "Username", "password": "Password" },
"secondary": {
"social_bind_with": "¿Ya tienes una cuenta? Inicia sesión para vincular {{methods, list(type: disjunction;)}} con tu identidad social."
},
"action": { "sign_in": "Iniciar sesión" },
"error": {
"general_required": "{{types, list(type: disjunction;)}} es obligatorio"
},
"list": { "or": "o" },
"user_scopes": {
"descriptions": { "custom_data": "Tus datos personalizados" }
}
}
Consulta el código fuente para ver todos los contenidos personalizables.
También puedes usar el PATCH /api/sign-in-exp API para controlar las políticas de detección de idioma.
Resolución de idioma en tiempo de ejecución
En tiempo de ejecución, el idioma de la experiencia de inicio de sesión se resuelve con la siguiente prioridad:
- Parámetro OIDC
ui_locales
de la solicitud de autenticación actual (se usa la primera etiqueta compatible). Consulta ui_locales. - De lo contrario, si la "detección automática" está habilitada, el idioma detectado del cliente del usuario (por ejemplo, del encabezado HTTP
Accept-Language
). - De lo contrario, el idioma predeterminado del inquilino en la Experiencia de inicio de sesión.
Esta resolución también afecta la localización de correos electrónicos para los mensajes desencadenados por la interacción. Más información: Localización de plantillas de correo electrónico.
Casos de uso
¿Cómo aparece el idioma añadido para los clientes finales?
Supongamos que tienes un sitio web donde el inglés es el idioma predeterminado y la detección automática está activada. Un usuario de Japón llega a tu sitio y decide crear una cuenta. Si usa japonés como idioma de su aplicación pero Logto aún no admite ese idioma, la pantalla de inicio de sesión aparecerá en inglés.
La experiencia de inicio de sesión i18n de Logto hace posible el idioma personalizado.
Haz clic en la etiqueta de idioma ja
para agregar tu propia traducción al japonés.
De esta manera, el usuario que accede a tu sitio desde Japón podrá leer el contenido en japonés, que acabas de traducir desde el inglés.
Preguntas frecuentes
¿Qué pasa si el idioma que añadí se convierte en un idioma proporcionado por Logto?
Junto a la etiqueta de idioma a la izquierda, aparecerá una etiqueta de idioma proporcionado por Logto, y el idioma que añadiste ya no podrá eliminarse. Los valores modificados seguirán funcionando y reemplazarán los valores originales de Logto. Borra los valores proporcionados por el usuario para usar los valores de la configuración predeterminada de Logto.
¿Qué pasa si solo añadí algunos valores personalizados?
Lo que ven los usuarios finales es el resultado de la fusión de ambas columnas. Supón que solo quieres hacer ajustes en un subconjunto de los textos originales proporcionados por Logto. La única diferencia entre tu pantalla de registro y la proporcionada por Logto serán las claves que editaste. El resto del contenido permanecerá sin cambios.
Recursos relacionados
Soporte para árabe y diseño de idioma RTL (de derecha a izquierda) en tu aplicación