Voir du texte traduit n'est pas une preuve absolue, et ne pas le voir n'est pas un échec absolu. Cette page vous propose quatre vérifications qui échouent chacune différemment, donc un problème vous indique où il se situe au lieu de vous laisser deviner.
Vérification 1 : le tableau de bord vérifie votre site
Ouvrez le projet et choisissez Paramètres de l'API. Pour un projet WordPress, cela vérifie votre site en direct et rapporte l'un des quatre résultats :
- Plugin connecté. Le tableau de bord a atteint le plugin et le lien est valide.
- Plugin Universally non détecté. Votre site a répondu, mais aucun plugin Universally n'a été trouvé dessus.
- Impossible de joindre votre site. Aucune réponse, ce qui pointe vers le DNS, un pare-feu, ou un hébergeur bloquant les requêtes sortantes et entrantes. Corrigez la joignabilité, puis utilisez Vérifier à nouveau.
- Votre plugin Universally est obsolète. Le plugin est présent mais trop ancien pour confirmer la connexion. Utilisez Mettre à jour le plugin, puis vérifiez à nouveau.
C'est la première vérification la plus rapide car elle distingue "trop ancien" et "injoignable" de "non connecté", ce que rien sur le site lui-même ne peut faire.
Vérification 2 : une URL traduite répond
Ouvrez votre site avec un code de langue dans le chemin, par exemple https://votresite.com/es/, en utilisant une langue que vous avez réellement activée.
- La page se charge en espagnol. La traduction fonctionne. Le premier chargement est lent, car c'est à ce moment que la page est traduite ; rechargez et cela devrait être rapide.
- Vous obtenez un 404. Le préfixe n'a pas été résolu en une langue activée. Confirmez que la langue est ajoutée et activée pour le projet, puis ouvrez Universally » Général » Langues dans WordPress et utilisez Actualiser : ce tableau liste l'URL en direct pour chaque langue, et le préfixe que vous tapez doit y correspondre exactement. Une variante régionale peut utiliser un préfixe de pays tel que
/mx/plutôt que/es/. - La page se charge en anglais. La requête a atteint votre site mais n'a pas été traduite. Continuez vers la vérification 3.
La ré-enregistrement des permaliens n'aide pas ici. Universally n'ajoute pas de règles de réécriture WordPress, il n'y a donc rien à capter pour une purge des permaliens.
Vérification 3 : la page indique quelle langue elle est
C'est la vérification la plus utile, car elle sépare "non traduit" de "traduit, et vous regardez une copie mise en cache de la page anglaise".
Affichez la source de l'URL traduite et regardez la balise <html> d'ouverture. Sur une page traduite, elle porte la langue cible et une direction :
<html lang="es-es" dir="ltr" translate="no">
Trois choses à lire ici :
langest la langue réellement servie, avec sa région, en minuscules :es-es,es-mx,fr-fr,pt-br. Si elle commence toujours parensur/es/, rien n'a traduit la réponse.direstrtlpour les neuf langues de droite à gauche etltrpour tout le reste. Voir Langues de droite à gauche.translate="no"indique au navigateur de ne pas proposer sa propre traduction d'une page déjà traduite. Sa présence est un signe fiable que la réponse est venue de Universally.
Si votre page source inclut déjà og:locale ou une balise meta Content-Language, celles-ci sont également mises à jour vers la langue cible. Aucune n'est ajoutée si elle n'était pas présente au départ, donc leur absence ne prouve rien.
Vérification 4 : le sélecteur est là où vous l'avez mis
S'il n'y a pas de sélecteur du tout, la cause probable est que le paramètre Implémentation du plugin est défini sur Personnalisé, ce qui signifie que rien n'est inséré tant que vous ne le placez pas vous-même. Voir Le sélecteur n'est pas visible.
Le sélecteur n'est que de la présentation. Un sélecteur manquant ne signifie pas que la traduction est défaillante, et un sélecteur fonctionnel ne prouve pas que la connexion est saine, c'est pourquoi il s'agit de la dernière vérification plutôt que de la première.
Lorsque les vérifications divergent
Traduit dans une fenêtre privée, anglais dans votre fenêtre normale. Votre navigateur a mis en cache la page anglaise. Rechargez-la à fond.
Traduit pour vous, anglais pour les visiteurs. Un cache de page ou un CDN sert une langue à tout le monde. Voir Mise en cache et CDN.
Certaines pages se traduisent, d'autres non. Ces pages sont probablement exclues, par modèle d'URL ou par sélecteur. Voir Exclure des pages.
Texte qui ne se traduit jamais, nulle part. Le contenu injecté par JavaScript après le chargement n'est pas dans le HTML lorsque la traduction se produit. Voir Traduire le contenu dynamique et JavaScript.
Rien ne se traduit et le plugin semble correct. Vérifiez le Domaine du projet sous Paramètres généraux par rapport à l'adresse que vous consultez. Une discordance échoue silencieusement et sert chaque page dans la langue source ; seules les formes nues et www. comptent comme le même site. Confirmez ensuite la connexion des deux côtés : le panneau API sous Universally » Général dans WordPress, et vérifiez le point 1 ci-dessus. Certains hébergeurs gérés bloquent également les requêtes sortantes vers api.universally.com.