Un plugin WordPress a cassé mon site : que faire ?

Si votre site a cessé de fonctionner juste après l’installation, l’activation ou la mise à jour d’un plugin, il est naturel de soupçonner ce plugin. Vous avez très souvent raison, mais pas toujours pour la raison que vous croyez.

Un problème de plugin peut toucher :

• l’ensemble du site
• uniquement le tableau de bord WordPress
• une page ou une mise en page précise
• le checkout, les formulaires ou la connexion
• quelque chose de moins visible, comme les e-mails, la recherche ou les tâches en arrière-plan

La bonne nouvelle, c’est qu’un problème de plugin signifie rarement que vos contenus ou vos données ont été perdus. Dans la plupart des cas, les informations sont toujours dans la base de données : le site ne peut simplement pas les afficher tant que le code défectueux s’exécute.

L’important est d’identifier le plugin calmement, de modifier une seule chose à la fois et de vérifier ce qui en dépend avant de le désactiver.

Ce guide explique comment surviennent généralement les problèmes de plugins, comment savoir quel plugin est en cause, ce que vous pouvez essayer sans risque et quand il vaut mieux demander une assistance technique.

Que signifie « un plugin a cassé le site » ?

Un plugin ajoute du code à votre site. À chaque chargement de page, WordPress exécute le code de tous les plugins actifs, en même temps que celui du thème et de WordPress lui-même.

Si un élément de ce code échoue, ou si deux éléments tentent de faire des choses incompatibles, le résultat peut être :

• un message comme « There has been a critical error on this website » (« Il y a eu une erreur critique sur ce site »)
• une page blanche
• une page qui se charge sans sa mise en page ni ses styles
• des boutons, des menus ou des formulaires qui ne répondent plus
• un tableau de bord qui devient lent ou inaccessible
• des erreurs uniquement pour les utilisateurs connectés, ou uniquement pour les visiteurs

Le plugin que vous soupçonnez n’est pas forcément mal conçu. Il peut fonctionner parfaitement sur des milliers d’autres sites et échouer sur le vôtre à cause de la combinaison particulière d’outils, de réglages et de serveur que vous utilisez.

Pourquoi les plugins cassent-ils des sites ?

La plupart des problèmes de plugins entrent dans l’une de trois catégories. Savoir laquelle s’applique vous aide à choisir la bonne étape suivante.

Un conflit avec un autre plugin ou avec le thème

Deux plugins peuvent essayer de modifier la même chose, charger des versions différentes d’une même bibliothèque ou dépendre l’un de l’autre d’une manière que leurs développeurs n’avaient pas prévue.

Un conflit apparaît souvent lorsque :

• un nouveau plugin est installé sur un site qui en compte déjà beaucoup
• deux plugins offrent des fonctions similaires, comme le cache, la sécurité ou le SEO
• le thème comprend des fonctionnalités qui recoupent celles d’un plugin

Dans ce cas, aucun des deux plugins n’est défectueux en lui-même. Le problème n’existe que lorsque les deux sont actifs.

Une mise à jour défectueuse ou incomplète

Une nouvelle version d’un plugin peut contenir un bug, supprimer une fonctionnalité sur laquelle vous comptiez ou modifier la façon dont elle enregistre les réglages.

Une mise à jour peut aussi être interrompue en cours de route, par exemple à cause d’un délai d’attente dépassé ou d’un manque d’espace disque. Le plugin se retrouve alors avec des fichiers manquants ou incohérents.

Si le problème a commencé juste après une mise à jour, c’est la mise à jour qu’il faut examiner en premier. Notre guide sur que faire lorsque WordPress ne fonctionne plus après une mise à jour traite cette situation plus en détail.

Une incompatibilité avec PHP ou WordPress

Les plugins sont écrits pour des versions précises de PHP, le langage de programmation utilisé par votre serveur, et de WordPress.

Un problème peut apparaître lorsque :

• l’hébergeur passe à une version plus récente de PHP
• une mise à jour de plugin exige une version de PHP plus récente que celle proposée par votre serveur
• un ancien plugin n’a pas été mis à jour pour les versions récentes de WordPress ou de PHP
• du code sur mesure construit autour d’un plugin dépend de fonctions qui n’existent plus

Ce type de problème peut apparaître soudainement, même si personne n’a touché au plugin, parce que quelque chose autour de lui a changé.

Comment savoir quel plugin est en cause ?

Vous n’avez pas besoin de lire du code pour recueillir des indices utiles. Commencez par les plus simples.

Le moment

Pensez à ce qui s’est passé juste avant l’apparition du problème :

• Un plugin a-t-il été installé, activé ou mis à jour ?
• Les mises à jour automatiques étaient-elles activées ?
• Quelqu’un a-t-il modifié un réglage de plugin ?
• L’hébergeur a-t-il apporté des modifications au serveur ?
• Le problème a-t-il commencé pendant que vous utilisiez une fonctionnalité précise ?

Si le site a cessé de fonctionner quelques minutes après une modification précise, cette modification est votre piste la plus sérieuse. Notez l’heure et le nom du plugin.

L’e-mail de récupération de WordPress

Lorsque WordPress détecte certaines erreurs fatales, il peut envoyer un e-mail à l’adresse de l’administrateur du site. L’objet indique généralement que votre site rencontre un problème technique.

Cet e-mail nomme souvent le plugin ou le thème à l’origine de l’erreur. Il peut aussi contenir un lien vers le mode de récupération (Recovery Mode), qui permet à un administrateur de se connecter au tableau de bord pendant que WordPress met en pause le plugin problématique.

Vérifiez :

• la boîte de réception de l’administrateur
• les dossiers spam et courrier indésirable
• toute adresse partagée utilisée pour gérer le site

Depuis le mode de récupération, vous pouvez désactiver proprement le plugin mis en pause. Ce mode vous aide à entrer, mais il ne corrige pas le problème de fond.

Traitez le lien du mode de récupération comme une information sensible. Ne le transférez pas à des personnes qui n’en ont pas besoin et ne le publiez pas.

Le message d’erreur lui-même

Parfois, l’erreur affichée à l’écran, dans l’e-mail de récupération ou dans un log contient un chemin de fichier. Si ce chemin contient quelque chose comme :

wp-content/plugins/plugin-folder-name/

le nom du dossier vous indique généralement quel plugin s’exécutait au moment de l’erreur.

Gardez à l’esprit que le plugin cité dans l’erreur est celui où le problème est devenu visible. Ce n’est pas toujours celui qui l’a provoqué. En cas de conflit, un second plugin a pu modifier quelque chose auquel le premier ne s’attendait pas.

L’endroit où le problème apparaît

Si seul le checkout est cassé, regardez d’abord les plugins liés aux paiements, à l’expédition ou à la boutique. Si seul le formulaire de contact échoue, regardez les plugins de formulaires, de protection contre le spam et d’e-mail. La zone touchée est souvent un bon indice.

Les premières vérifications que tout le monde peut faire sans risque

Avant de désactiver quoi que ce soit, prenez quelques minutes pour comprendre la situation :

1. Ouvrez le site dans une fenêtre de navigation privée.
2. Vérifiez la page d’accueil, une page interne et la page de connexion.
3. Essayez d’accéder au tableau de bord WordPress.
4. Testez toutes les fonctions importantes pour votre activité : checkout, formulaires, réservations, espaces membres.
5. Faites des captures d’écran de tout message d’erreur.
6. Notez l’heure à laquelle vous avez remarqué le problème pour la première fois.

Ces étapes ne modifient rien sur le site, mais elles vous donnent, à vous ou à la personne qui vous aide, une vision claire de ce qui fonctionne et de ce qui ne fonctionne pas.

Faut-il désactiver les plugins un par un ou tous en même temps ?

C’est la décision la plus importante du dépannage de plugins, et les deux approches comportent des risques.

Désactiver un plugin à la fois

C’est généralement l’approche la plus sûre lorsque vous avez un suspect clair. Vous désactivez un plugin, testez le site et décidez de la suite.

Cela prend plus de temps si vous n’avez aucune idée du plugin responsable, mais vous obtenez une réponse claire et vous limitez les effets secondaires.

Désactiver tous les plugins en même temps

C’est une suggestion courante sur les forums, et elle permet de confirmer rapidement si un plugin est en cause. Sur un site professionnel en ligne, cependant, elle peut provoquer de nouveaux problèmes.

Les plugins peuvent gérer :

• les formulaires : des demandes peuvent être perdues ou ne pas être livrées pendant que le plugin est désactivé
• les paiements et les abonnements : le checkout peut cesser de fonctionner ou des renouvellements peuvent échouer
• la sécurité : les règles de pare-feu, la protection de la connexion et l’authentification à deux facteurs peuvent cesser de fonctionner
• les contenus multilingues : des pages traduites peuvent disparaître ou s’afficher dans la mauvaise langue
• le cache : les visiteurs peuvent voir des pages obsolètes, ou le site peut devenir beaucoup plus lent
• les redirections et le SEO : des URL importantes peuvent ne plus être redirigées correctement

Certains plugins exécutent aussi des tâches lorsqu’ils sont désactivés ou réactivés, comme effacer des réglages ou reconstruire des données. Réactiver vingt plugins dans le bon ordre n’est pas toujours aussi simple que de les désactiver.

Si vous devez tester tous les plugins en même temps, privilégiez une méthode qui n’affecte pas les visiteurs, comme le mode de dépannage décrit ci-dessous, ou une copie de staging du site.

Que pouvez-vous essayer sans risque ?

La bonne option dépend de votre accès au tableau de bord et de l’importance du site pour votre activité.

Option 1 : utilisez le mode de dépannage de Health Check

Le plugin gratuit Health Check & Troubleshooting, maintenu par des contributeurs de WordPress, comprend un mode de dépannage.

Une fois activé, il désactive tous les plugins et bascule sur un thème par défaut uniquement pour votre session d’administrateur connecté. Les visiteurs continuent de voir le site normalement.

Vous pouvez ensuite réactiver les plugins un par un dans votre session et voir à quel moment le problème revient. C’est l’un des moyens les plus sûrs de tester les conflits sur un site en ligne.

Quelques points à garder à l’esprit :

• vous devez avoir accès au tableau de bord pour l’utiliser
• installer un nouveau plugin est en soi une modification : faites-le lorsque le site est par ailleurs suffisamment stable
• certains problèmes n’apparaissent que pour les visiteurs ou pendant des tâches en arrière-plan, et peuvent ne pas se manifester dans votre session
• pensez à désactiver le mode de dépannage une fois terminé

Option 2 : désactivez le plugin suspect depuis le tableau de bord

Si vous pouvez accéder à WordPress et avez un suspect sérieux, allez dans :

Plugins → Installed Plugins (Extensions → Extensions installées)

Désactivez uniquement ce plugin, puis testez la page touchée et les fonctions importantes du site.

Si le problème disparaît, vous tenez une piste sérieuse. Laissez le plugin désactivé pour le moment plutôt que de le supprimer : supprimer un plugin peut aussi effacer ses réglages et ses données.

Option 3 : revenez à la version précédente

Si le problème a commencé après une mise à jour du plugin, revenir à la version précédente peut rétablir le site le temps que le développeur corrige le problème.

Cela doit se faire avec prudence :

• la nouvelle version a peut-être modifié la base de données, et l’ancienne version risque de ne pas fonctionner correctement avec elle
• la mise à jour comprenait peut-être un correctif de sécurité, et revenir en arrière pourrait réintroduire une vulnérabilité
• n’utilisez que des versions téléchargées depuis la source officielle ou auprès du développeur du plugin

En cas de doute, il vaut mieux demander de l’aide avant de revenir en arrière sur un plugin qui gère les paiements, les utilisateurs ou la sécurité.

Option 4 : restaurez une sauvegarde

Une sauvegarde peut ramener l’ensemble du site à un état fonctionnel connu. Sur un site e-commerce, à espace membres ou de réservation, elle peut cependant aussi écraser les commandes, les inscriptions et les messages reçus après la réalisation de la sauvegarde.

Vérifiez la date de la sauvegarde et réfléchissez à ce qui s’est passé depuis avant de restaurer.

Que faut-il éviter ?

Quand un site est cassé, il est tentant de tout essayer rapidement. À éviter :

• mettre à jour tous les plugins d’un coup en espérant qu’une mise à jour règle le problème
• supprimer des plugins au lieu de les désactiver
• désactiver des plugins de sécurité, de paiement ou de formulaires sans vérifier les conséquences
• installer plusieurs plugins de remplacement pour voir lequel fonctionne
• télécharger des versions de plugins depuis des sites non officiels
• modifier directement les fichiers d’un plugin, car les modifications sont perdues à la mise à jour suivante
• publier sur des forums publics des logs d’erreurs, des captures d’écran contenant des données personnelles ou des informations d’accès
• faire plusieurs modifications avant de tester le résultat

Modifiez une seule chose à la fois et gardez une courte trace de ce que vous avez fait et de ce qui s’est passé.

Faut-il signaler le problème au développeur du plugin ?

Oui, si vous pouvez identifier le plugin et que le problème semble venir de lui. Beaucoup de développeurs comptent sur les signalements pour découvrir les bugs des nouvelles versions.

Un signalement utile comprend :

• la version du plugin et celle qui fonctionnait auparavant, si vous la connaissez
• vos versions de WordPress et de PHP
• une description claire de ce qui se passe et de la façon de le reproduire
• le message d’erreur concerné, débarrassé de toute information personnelle ou sensible

Utilisez le canal de support officiel, comme le forum de support du plugin sur WordPress.org ou le système de support du développeur pour les plugins premium.

Ne partagez pas d’identifiants de connexion, de logs complets ni de données clients sur un forum public. Si le développeur a besoin d’accéder à votre site, convenez d’une méthode sécurisée et supprimez cet accès une fois l’enquête terminée.

Garder le plugin désactivé ou trouver une alternative ?

Une fois le site de nouveau fonctionnel, vous devez décider quoi faire du plugin.

Le laisser désactivé pendant une courte période peut être raisonnable lorsque :

• le développeur a reconnu le problème et un correctif est attendu
• la fonction qu’il fournit n’est pas indispensable pendant quelques jours
• vous pouvez contourner l’absence de la fonctionnalité

Chercher une alternative peut être préférable lorsque :

• le plugin n’a pas été mis à jour depuis longtemps
• le développeur ne répond pas aux demandes de support
• ce même plugin a déjà causé des problèmes plus d’une fois
• il fait double emploi avec des fonctionnalités déjà fournies par un autre plugin ou par le thème

Remplacer un plugin n’est pas toujours simple. Les réglages, les contenus, les shortcodes et les données peuvent devoir être migrés, et le nouveau plugin doit être testé avant sa mise en ligne. Planifiez le remplacement au lieu de le faire sous pression.

Si le problème est un conflit entre deux plugins, la solution peut être un changement de configuration plutôt que la suppression de l’un d’eux.

Quand demander une assistance technique ?

Une assistance technique est recommandée lorsque :

• l’ensemble du site ou le tableau de bord est inaccessible
• le problème touche le checkout, les paiements ou les abonnements
• vous ne parvenez pas à identifier le plugin en cause
• le problème revient après une solution temporaire
• le plugin en cause gère la sécurité, les utilisateurs ou les paiements
• du code sur mesure dépend du plugin
• vous soupçonnez un problème de compatibilité avec PHP
• vous n’avez pas de sauvegarde récente et vérifiée
• vous n’êtes pas à l’aise pour travailler sur les fichiers ou le panneau d’hébergement

Vous n’avez pas besoin de diagnostiquer le problème avant de demander de l’aide. Expliquer ce qui a changé et ce qui ne fonctionne plus suffit pour commencer.

Quelles informations rassembler ?

Les informations utiles comprennent :

• l’URL du site
• le nom du plugin suspect et, si vous la connaissez, sa version
• ce qui a changé juste avant le début du problème
• l’heure approximative à laquelle le problème a commencé
• des captures d’écran de tout message d’erreur
• tout e-mail reçu de WordPress
• les pages ou fonctions touchées
• si le tableau de bord est accessible
• ce que vous avez déjà essayé, dans l’ordre
• si une sauvegarde récente est disponible

Ne vous inquiétez pas si vous ne pouvez pas tout rassembler. D4Hub peut vous aider à comprendre quelles informations ou quels accès supplémentaires sont nécessaires. N’envoyez pas de mots de passe par simple e-mail.

Comment D4Hub peut vous aider

L’objectif n’est pas seulement de faire de nouveau charger le site, mais de comprendre pourquoi le plugin a échoué et de s’assurer que la correction ne casse rien d’autre.

Selon la situation, D4Hub peut vous aider à :

• identifier le plugin, le thème ou le code sur mesure en cause
• distinguer un conflit de plugins d’une mise à jour défectueuse ou d’une incompatibilité avec PHP
• examiner les logs d’erreurs et les e-mails de récupération
• désactiver le plugin ou revenir à une version antérieure en toute sécurité
• tester les conflits sur une copie de staging plutôt que sur le site en ligne
• vérifier les formulaires, le checkout, la connexion et les autres fonctions clés après la correction
• signaler le problème au développeur du plugin avec les bons détails techniques
• évaluer et configurer un plugin alternatif
• réduire les plugins redondants pour limiter le risque de conflits futurs

Vous pouvez demander de l’aide à n’importe quelle étape. D4Hub peut vous guider dans une vérification simple, confirmer qu’une action est sans risque, prendre le relais lorsque le tableau de bord est inaccessible ou examiner le site après une solution temporaire.

wp plugin list --status=active

wp --info

wp plugin list --skip-plugins

wp plugin list --skip-plugins=plugin-slug

wp plugin deactivate plugin-slug

wp plugin activate plugin-slug

Questions fréquentes

Désactiver un plugin supprime-t-il ses données ?

En général, non. Désactiver un plugin arrête l’exécution de son code, tandis que ses réglages restent normalement dans la base de données.

Supprimer un plugin, c’est différent : certains plugins effacent leurs données lorsqu’ils sont supprimés. C’est pourquoi la désactivation est la première étape la plus sûre.

Le site fonctionne de nouveau après la désactivation d’un plugin. Le problème est-il réglé ?

Pas forcément. La fonction fournie par ce plugin n’est plus disponible, et la cause de fond est peut-être toujours là.

Testez les formulaires, le checkout, la connexion et les autres fonctions clés, puis décidez s’il faut attendre un correctif, revenir à une version antérieure ou trouver une alternative.

Pourquoi le plugin a-t-il fonctionné pendant des mois avant de casser soudainement ?

Quelque chose autour de lui a probablement changé : une mise à jour de WordPress, d’un autre plugin, du thème ou de la version de PHP du serveur. Le plugin lui-même n’a peut-être pas changé du tout.

Est-ce la faute du plugin cité dans le message d’erreur ?

Pas toujours. L’erreur montre où le problème est devenu visible. En cas de conflit, un autre plugin ou le thème peut en être la vraie cause.

Puis-je utiliser le mode de dépannage de Health Check sur un site en ligne ?

En général oui, car il n’affecte que l’administrateur connecté qui l’active. Les visiteurs continuent de voir le site normal. Faites tout de même une sauvegarde au préalable et désactivez le mode de dépannage une fois terminé.

Dois-je éviter de mettre à jour les plugins à l’avenir ?

Non. Les mises à jour contiennent souvent des correctifs de sécurité, et les ignorer crée d’autres risques. Il est plus sûr de mettre à jour avec une sauvegarde récente, de tester idéalement les mises à jour importantes sur une copie de staging au préalable et de vérifier le site après chaque mise à jour.

D4Hub peut-il m’aider si j’ai déjà essayé de corriger le problème ?

Oui. Expliquez quels plugins vous avez désactivés, mis à jour ou supprimés, et dans quel ordre. Cela aide à reconstituer ce qui s’est passé et à identifier la prochaine étape sûre.