Skip to content

Résolution de la langue

Langues proposées par l'application, langues obligatoires, langue par défaut à chaque niveau et ordre dans lequel Wakastart choisit la langue d'un utilisateur.

ConceptAdministratorDeveloper

This page has not been translated yet and is shown in French.

Un utilisateur doit être accueilli dans sa langue sans avoir à la choisir à chaque connexion. Wakastart la déduit des réglages de son organisation, puis de sa préférence personnelle.

Définition

  • Une langue est identifiée par son code ISO 639-1 à deux lettres (fr, en, de), éventuellement suivi d'une région (pt-BR). Les langues forment un référentiel commun à toute la plateforme.
  • Les langues de l'application sont celles qu'elle propose. Le français (fr) et l'anglais (en) en font toujours partie : ils ne peuvent pas être retirés.
  • La langue par défaut de l'application est l'une d'elles, unique.
  • Un réseau et un client peuvent chacun désigner une langue par défaut. Un utilisateur peut choisir une langue préférée.

L'ordre de résolution

Loading diagram…

Le premier niveau qui désigne une langue l'emporte.

Ce que reçoit votre application

  • Le jeton enrichi porte la revendication wlng, avec le code de la langue issue de la préférence de l'utilisateur, de son client ou de son réseau. Elle est absente quand aucun de ces niveaux n'en désigne.
  • GET /api/apps/{appWid}/runtime-config renvoie les langues de l'application ; celle dont isDefault vaut true est la langue par défaut.

Votre application retient donc wlng si elle est présente, sinon la langue par défaut de l'application. Vérifiez au passage que la langue retenue fait partie des langues de l'application, et repliez-vous sur la langue par défaut dans le cas contraire.

La langue du jeton est calculée à la connexion. Un changement de langue par défaut prend effet au renouvellement du jeton.

Exemples

  • Un réseau germanophone : le réseau désigne l'allemand. Tous ses clients et leurs utilisateurs reçoivent wlng: "de".
  • Un client bilingue : le client garde l'allemand de son réseau ; une utilisatrice choisit le français dans Mon profil et reçoit wlng: "fr".
  • Aucun réglage : ni l'utilisateur, ni le client, ni le réseau ne désignent de langue ; le jeton n'a pas de wlng et l'application s'affiche dans sa langue par défaut.

Pour aller plus loin