Je fais des modifications sur mon site WordPress et rien ne se passe

Il peut parfois vous arriver de faire des modifications sur l’administration de votre site WordPress et de ne pas les voir sur la partie publique de votre site.

Il y a toute une liste de facteurs communément rencontrés qui peuvent expliquer cela : cache du navigateur, cache serveur, extension de cache, ou modification n’ayant pas été faite au bon endroit dans le système de fichiers.

Le cache du navigateur Le cache du navigateur

Parfois, lorsque vous visitez une page web pour la première fois, cela peut prendre un moment avant d’afficher entièrement la page. Mais la prochaine page que vous visiterez sur ce site prendra moins longtemps à charger.

C’est dû au fait que votre navigateur stocke les ressources utilisées par la page sur votre ordinateur. Ainsi, lorsque des ressources qui ont déjà été chargées sont réutilisées sur ce site, leur affichage sera bien plus rapide car les ressources appelées sont déjà sur votre ordinateur.

L’endroit où sont stockées ces ressources se nomme le cache de votre navigateur. Le cache est une manière essentielle d’optimiser votre expérience de navigation.

Mais parfois, un problème d’affichage peut se manifester après que vous ayez fait une petite modification sur votre site. Il est possible que la version précédente de la page ait été stockée dans le cache de votre navigateur, ce qui vous empêche de voir la correction de ce problème. Dans ce cas, il va vous falloir vider le cache de votre navigateur.

Vider le cache du navigateur Vider le cache du navigateur

Normalement, pour voir les modifications faites sur une page, vous cliquez tout simplement sur le bouton de rafraîchissement de votre navigateur ou vous appuyez sur la touche F5 (ou CTRL/CMD+R). Généralement, cela recharge simplement la page mais cela ne vide pas le cache du navigateur. Si des ressources ont été modifiées, vous ne verrez donc pas de différence. Voici quelques méthodes pour vider le cache du navigateur lors du rechargement de la page.

La façon de vider le cache dépend du navigateur que vous utilisez. Voici des indications pour quelques uns des navigateurs les plus courants :

En plus de vider le cache, chaque navigateur peut proposer de stopper ou minimiser la mise en cache des pages. Utiliser cela peut ralentir la consultations des sites internet, ce n’est donc pas forcément une solution recommandée.

Haut ↑

Cache serveur Cache serveur

Il est recommandé de s’assurer que votre hébergeur n’utilise pas un cache serveur sans vous en tenir explicitement informé·e. Pour vous en assurer, contactez le support de votre hébergeur et demandez-lui si un outil de cache est utilisé. Si ce cache serveur est trop contraignant pour vous, vous pouvez demander de le désactiver.

L’hébergeur peut également vous proposer une solution vous permettant de vider le cache serveur manuellement. Dans ce cas, vous bénéficierez à la fois d’un site qui s’affiche rapidement grâce au cache, et d’une façon simple (généralement un lien sur l’interface de gestion de votre hébergement) de vider ce cache pour voir vos modifications.

Enfin, si votre hébergeur utilise un proxy inverse pour mettre en cache les requêtes HTTP (par exemple Varnish), dans ce cas vos modifications n’apparaîtront jamais immédiatement. Vous devrez attendre que le serveur mette lui-même à jour son cache. Si vous en avez les compétences techniques, vous pouvez personnaliser ce système pour proposer un délai de mise en cache plus court.

Haut ↑

Extensions WordPress de mise en cache Extensions WordPress de mise en cache

Plusieurs extensions WordPress permettent d’ajouter une fonctionnalité de mise en cache sur votre site. Cela aide votre site à se charger plus vite, car WordPress affiche alors les pages mises en cache au lieu de les générer entièrement à chaque fois.

Toute extension de cache qui se respecte veillera à vider automatiquement le cache d’une publication lorsque celle-ci est modifiée. Mais si vous faites d’autres modifications (par exemple sur le thème utilisé par votre site), il est possible que l’extension ne puisse pas vider le cache directement. Dans ce cas, consultez l’aide de l’extension pour savoir comment vider manuellement le cache. Il y a généralement un bouton bien visible disponible dans la barre d’administration.

Veuillez noter que WordPress ne propose pas de solution de cache par défaut, donc cela ne s’applique que si vous avez vous-même installé une extension de gestion de cache CMS.

Haut ↑

Vérifiez ce que vous êtes en train de modifier Vérifiez ce que vous êtes en train de modifier

Peut-être que vous ne regardez pas au bon endroit ! Même les personnes les plus professionnelles peuvent parfois faire des erreurs bêtes 🙂

Êtes-vous certain·e que vous regardez le résultat de vos modifications au bon endroit ? Et que vous avez effectué ces modifications au bon endroit ?

Voici quelques recommandations pour vous en assurer.

Haut ↑

Vérifiez l’adresse du site Vérifiez l’adresse du site

Est-ce que les adresses de ce que vous avez modifié et de ce que vous consultez correspondent ? Regardez par exemple les deux adresses suivantes :

  • wordpress/wp-content/themes/votretheme/style.css
  • test/wordpress/wp-content/themes/votretheme/style.css

Dans cet exemple, il est facile de voir la différence entre les deux, mais dans la vie réelle, c’est parfois plus compliqué. Et une fois dans la barre d’adresse de votre navigateur, vous auriez pu ne pas apercevoir le mot « test » indiquant un répertoire différent de celui dans lequel vous vouliez faire vos modifications.

Faites également attention aux noms de fichiers ! Si vous avez modifié le fichier « editor-style.css » il est normal que cela n’apparaisse pas dans le fichier « style.css » 😊

Haut ↑

Vérifiez le fichier modèle Vérifiez le fichier modèle

Si vous modifiez un fichier modèle de votre thème, assurez-vous que la page que vous consultez correspond bien au fichier modèle modifié. Rappelez-vous que les fichiers modèles peuvent être très similaires entre eux. Vérifiez donc cela à deux fois et n’oubliez pas de consulter la documentation concernant la hiérarchie des fichiers modèles (en anglais).

Haut ↑

Vérifiez vos téléversements Vérifiez vos téléversements

Lorsque vous faites de modifications sur un fichier, cela se passe souvent sur le disque dur de votre ordinateur. Vous devez donc penser à téléverser ce fichier sur votre serveur pour pouvoir modifier votre site en ligne. Avez-vous bien pensé à téléverser vos fichiers modifiés ? Le téléversement s’est-il bien passé ? Lorsque l’on remplace un fichier existant, il arrive parfois que le téléversement échoue, donc n’hésitez pas à refaire l’opération et vérifiez que le fichier a bien été modifié (par exemple grâce à sa date de dernière modification affichée dans votre logiciel FTP).

Haut ↑

Testez par vous-même Testez par vous-même

Prenons le cas de figure suivant : 
a) Vous travaillez bien sur le bon fichier.
b) Ce fichier est bien à la bonne place et correctement nommé, mais vous ne voyez toujours pas vos modifications.

Vérifiez alors les points suivants :

  1. Faites une sauvegarde de votre fichier et sauvegardez-le en lieu sûr.
  2. Faites une grosse modification, comme changer la couleur d’arrière-plan de la balise <body> s’il s’agit d’une modification sur un fichier CSS ou ajoutez un titre de niveau 1 tel que <?php echo '<h1>Test</h1>'; ?> s’il s’agit d’un fichier PHP.
  3. Consultez la page concernée dans votre navigateur. Videz le cache de votre navigateur et de votre éventuelle extension de cache.
  4. Si rien ne se passe, essayez de supprimer carrément ce fichier (mais ce fichier uniquement) de votre serveur. Si rien ne change, alors il est clair que vous n’êtes pas en train de travailler sur votre site WordPress, ou que vous ne modifiez pas le bon thème. Il va vous falloir investiguer davantage pour vous assurer que vous modifiez bien le bon site/thème.
  5. Vérifiez les réglages de vos URL dans le panneau des options et en base de données. Si vous n’arrivez toujours pas à comprendre ce qui se passe, ouvrez un fil de discussion sur le forum d’entraide en français de l’association WPFR. La communauté essaiera de vous aider.

Traduit par JB Audras
Relu par Didier Demory & Bruno Tritsch
Dernière mise à jour le 17 janvier 2021

Contribuer à la documentation en français de WordPress