Une mise à jour remplace des fichiers de WordPress, du thème ou d’une extension. Si le nouveau code s’entend mal avec le reste du site (autre extension, thème, version de PHP, cache), l’affichage ou certaines fonctions se dérèglent, parfois sans le moindre message. Avantage : le suspect est tout trouvé, c’est la dernière mise à jour, ce qui réduit beaucoup les recherches.
D’où vient le problème
- Un cache (extension, serveur, CDN ou constructeur de pages) sert encore d’anciens fichiers CSS et JavaScript qui ne correspondent plus au nouveau code.
- La nouvelle version d’une extension entre en conflit avec une autre extension ou avec le thème.
- Le thème parent a été mis à jour alors que des modifications avaient été faites directement dans ses fichiers : elles ont été écrasées.
- La nouvelle version exige une version de PHP plus récente que celle du serveur.
- La mise à jour a été interrompue et une partie des fichiers est restée à l’ancienne version.
Comment corriger le problème
Identifier ce qui a été mis à jour
Notez ce qui a changé juste avant la panne : WordPress, le thème, une ou plusieurs extensions. Les e-mails de mises à jour automatiques et les numéros de version dans Extensions > Extensions installées aident à retrouver le suspect. Regardez aussi si WordPress vous a envoyé un e-mail de mode de récupération.
Vider tous les caches
Videz le cache de votre extension de cache, celui de l’hébergeur et celui du CDN s’il y en a un, puis rechargez la page avec Ctrl+F5 (Cmd+Maj+R sur Mac). Avec un constructeur de pages, régénérez aussi ses fichiers CSS depuis ses outils. Bien des mises en page « cassées » se réparent à cette étape.
Neutraliser l’élément mis à jour
Désactivez l’extension mise à jour et observez le site. Si l’administration ne répond plus, renommez son dossier dans wp-content/plugins par FTP. Pour un thème, le test consiste à activer un thème par défaut : faites-le de préférence sur une copie du site, ou à une heure creuse.
Revenir à la version précédente
Restaurez seulement l’extension ou le thème depuis votre dernière sauvegarde, ou réinstallez l’ancienne version : la page d’une extension gratuite sur wordpress.org propose les versions précédentes dans sa vue avancée, les extensions payantes les fournissent dans votre compte client. Avec WP-CLI, une commande suffit. Suspendez ensuite les mises à jour automatiques de cet élément jusqu’au correctif de l’éditeur.
wp plugin install nom-de-l-extension --version=1.2.3 --forceLire le journal de débogage
Si rien ne s’affiche à l’écran, activez le journal dans wp-config.php, rechargez la page fautive puis ouvrez wp-content/debug.log : les lignes « Fatal error » ou « Uncaught » citent le fichier en cause. Remettez WP_DEBUG à false ensuite.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );Contrôler les fichiers de WordPress
Après une mise à jour du cœur interrompue, comparez les fichiers installés aux originaux : la commande liste ceux qui manquent ou diffèrent. Réinstallez alors la même version de WordPress pour remettre l’ensemble d’aplomb.
wp core verify-checksumsAvant de restaurer quoi que ce soit, sauvegardez l’état actuel du site (fichiers et base) : restaurer toute la base effacerait les commandes, messages ou inscriptions reçus depuis la mise à jour.
Un autre message d'erreur ? Collez-le dans le décodeur : il le reconnaît et vous oriente vers la bonne fiche.
Ouvrir le décodeur