Skip to content

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.

TroubleshootingAdministratorDeveloper

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

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.