Aller au contenu

Résoudre les problèmes de langues

Langue refusée ou impossible à retirer, droit languages.read manquant, textes vides ou pas encore à jour dans l'application.

DépannageAdministrateurDéveloppeur
Voir en Markdown

Cette page couvre les erreurs rencontrées en gérant les langues de l'application et en chargeant ses traductions.

Symptômes

Code langue refusé

Cause : le champ Code ISO attend des lettres minuscules uniquement.

Solution : saisissez le code ISO 639-1 à deux lettres, par exemple pt pour le portugais.

Langue déjà activée

Cause : l'application propose déjà cette langue. Par l'API, le message est « This language is already added to the app ».

Solution : aucune action n'est nécessaire.

Langue obligatoire

Cause : le français et l'anglais font partie de toutes les applications. Le message est, par exemple, « La langue Français (fr) est obligatoire et ne peut pas être supprimée ».

Solution : gardez ces deux langues ; vous pouvez en revanche désigner une autre langue par défaut.

Langue par défaut

Cause : la langue que vous retirez est la langue par défaut de l'application. Le message complet est « Impossible de supprimer la langue par defaut. Definissez d'abord une autre langue comme defaut. »

Solution : cliquez sur Definir comme langue par defaut sur une autre langue, puis retirez la première.

Droit languages.read manquant

Cause : la clé API ou le jeton utilisé pour GET /api/languages/code/{code}/file ne porte pas le droit languages.read. La réponse est un 403.

Solution : utilisez une clé API de l'application dont le profil porte ce droit, depuis votre serveur.

Textes vides

Cause : la clé n'a pas encore de valeur dans cette langue. Elle figure dans le fichier avec une chaîne vide.

Solution : traitez une chaîne vide comme manquante et repliez-vous sur la langue par défaut (returnEmptyString: false avec i18next). Le texte apparaîtra dans le fichier dès que sa traduction sera saisie.

Texte pas à jour

Cause : les fichiers de traduction sont mis en cache pendant une heure, par le stockage comme par votre propre route si elle les relaie.

Solution : attendez l'expiration du cache, ou rechargez sans cache pour vérifier. L'adresse du fichier, elle, ne change pas.

Toujours bloqué ?

Rassemblez le WID de l'application, le code de la langue, le type de fichier et le message exact, puis contactez le support Wakastart.