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.
Cette page couvre les erreurs rencontrées en gérant les langues de l'application et en chargeant ses traductions.
Symptômes
- « Le code langue doit contenir 2 ou 3 lettres »
- « Cette langue est deja activee pour cette application »
- « La langue … est obligatoire et ne peut pas être supprimée »
- « Impossible de supprimer la langue par defaut »
- « Droit applicatif requis : languages.read »
- Des textes s'affichent vides
- Un texte modifié n'apparaît pas
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.