Langues localisées
Logto prend en charge un large éventail de langues prédéfinies et offre 113 balises de langue supplémentaires. Cet outil puissant vous permet de personnaliser l'Expérience (Experience) de connexion en créant et en gérant vos propres options linguistiques et traductions.
Étapes de personnalisation dans la Logto Console
Personnalisez facilement les paramètres linguistiques dans la Logto Console sans coder.
- Accédez à : Console > Expérience de connexion > Contenu > Langues.
- Gérer la langue : Cliquez sur le bouton « Gérer la langue » pour accéder à votre bibliothèque de langues.
- Modifier les langues existantes : Personnalisez les traductions des langues fournies par Logto. Ces langues ne peuvent pas être supprimées, mais vos modifications remplaceront les valeurs par défaut.
- Ajouter une nouvelle langue : Cliquez sur le bouton « Ajouter une langue », sélectionnez une balise de langue, fournissez vos traductions, puis enregistrez les modifications pour ajouter une nouvelle langue.
- Activer la détection automatique : Lorsqu'elle est activée, la page de connexion s'affiche automatiquement dans la langue préférée de l'utilisateur en fonction des paramètres de son appareil.
- Définir la langue par défaut : Vous pouvez choisir une langue par défaut dans votre bibliothèque de langues. Elle sera utilisée lorsque la langue détectée de l'utilisateur n'est pas couverte dans la bibliothèque de langues actuelle.
Voici quelques termes clés à comprendre lors de la gestion des langues :
| Définition | Description |
|---|---|
| Balise de langue | La balise de langue identifie la langue du contenu. Une balise de langue est composée d'un code de langue (par exemple, en, fr, zh) et d'un code de pays/région (par exemple, US, UK, KR) séparés par des tirets. Une balise de langue ressemble à ceci : en-US. |
| Langue fournie par Logto | La langue fournie par Logto est la langue officielle de Logto et est stockée dans le code source original de Logto. |
| Langue ajoutée | La langue ajoutée est la langue ajoutée par les utilisateurs. |
| Valeurs sources de Logto | Les valeurs sources de Logto sont des valeurs fournies par Logto qui n'ont pas été personnalisées par les utilisateurs. |
| Valeurs personnalisées | Les valeurs personnalisées sont des valeurs qui ont déjà été personnalisées par les utilisateurs. Les valeurs sources de Logto seront remplacées. |
Personnalisation à l'aide de la Management API
Vous pouvez utiliser la Management API PUT /api/custom-phrases/{languageTag} pour personnaliser les traductions linguistiques. Le corps de la requête API est un objet de locale partiel comme :
{
"input": { "username": "Username", "password": "Password" },
"secondary": {
"social_bind_with": "Already had an account? Sign in to link {{methods, list(type: disjunction;)}} with your social identity."
},
"action": { "sign_in": "Sign in" },
"error": {
"general_required": "{{types, list(type: disjunction;)}} is required"
},
"list": { "or": "or" },
"user_scopes": {
"descriptions": { "custom_data": "Your custom data" }
}
}
Consultez le code source pour voir tous les contenus personnalisables.
Vous pouvez également utiliser l'API PATCH /api/sign-in-exp pour contrôler les politiques de détection de la langue.
Cas d'utilisation
Comment la langue ajoutée apparaît-elle aux clients finaux ?
Supposons que vous ayez un site Web où l'anglais est la langue par défaut et que la détection automatique est activée. Un utilisateur du Japon tombe sur votre site et décide de créer un compte. S'il/elle utilise le japonais comme langue de son application mais que Logto ne prend pas encore en charge cette langue, l'écran de connexion apparaîtra en anglais.
L'Expérience (Experience) de connexion de Logto i18n rend possible la personnalisation de la langue.
Cliquez sur la balise de langue ja pour ajouter votre propre traduction en japonais.
De cette manière, l'utilisateur accédant à votre site depuis le Japon pourra lire le contenu en japonais, que vous venez de traduire de l'anglais.
FAQs
Que se passe-t-il si la langue que j'ai ajoutée devient une langue fournie par Logto ?
À côté de la balise de langue à gauche, une balise fournie par Logto apparaîtra, et la langue que vous avez ajoutée ne sera plus supprimable. Les valeurs modifiées continuent de fonctionner et remplacent les valeurs originales de Logto. Effacez les valeurs fournies par l'utilisateur pour utiliser les valeurs fournies par la configuration par défaut de Logto.
Que se passe-t-il si je n'ai ajouté que quelques valeurs personnalisées ?
Ce que les utilisateurs finaux voient est le résultat de la fusion des deux colonnes. Supposons que vous ne souhaitiez apporter des ajustements qu'à un sous-ensemble des copies de contenu originales fournies par Logto. La seule différence entre votre écran d'inscription et celui fourni par Logto sera les clés que vous avez modifiées. Le reste du contenu restera inchangé.