# 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.

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

```mermaid
flowchart LR
  U{"Langue préférée<br/>de l'utilisateur ?"} -- oui --> R1(["retenue"])
  U -- non --> C{"Langue par défaut<br/>du client ?"}
  C -- oui --> R2(["retenue"])
  C -- non --> N{"Langue par défaut<br/>du réseau ?"}
  N -- oui --> R3(["retenue"])
  N -- non --> A(["langue par défaut<br/>de l'application"])
```

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

## Ce que reçoit votre application

- Le [jeton enrichi](/v1.0/glossaire#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

- [Choisir la langue par défaut](/v1.0/langues-et-traductions/choisir-la-langue-par-defaut)
- [Charger les traductions](/v1.0/langues-et-traductions/charger-les-traductions)
- [Cascade d'habillage](/v1.0/apparence/cascade-d-habillage), qui suit la même logique pour le thème
