Guide

Comment désactiver un plugin WordPress sans accès à wp-admin

Désactiver rapidement une extension qui provoque une erreur fatale lorsque l’administration WordPress n’est plus accessible.

ThématiqueWordPress →
⌚ Environ 3 min de lecture
Voir mes favoris
WordPress Intermédiaire 5 min

Désactiver rapidement une extension qui provoque une erreur fatale lorsque l’administration WordPress n’est plus accessible.

Avant de commencer : adaptez toujours les commandes et manipulations à votre environnement. Sur un système de production, prévoyez une sauvegarde ou un retour arrière lorsque l’action peut modifier la configuration.

Étapes à suivre

  1. 1

    Créer une sauvegarde

    Sauvegardez les fichiers et la base si possible.

  2. 2

    Accéder aux fichiers du site

    Connectez-vous en FTP/SFTP ou via le gestionnaire de fichiers.

  3. 3

    Ouvrir wp-content/plugins

    Repérez le dossier de l’extension suspecte.

  4. 4

    Renommer le dossier du plugin

    Ajoutez par exemple -disabled au nom du dossier.

  5. 5

    Retester WordPress

    Si le site revient, analysez ensuite la compatibilité et les journaux.

À retenir

  • Ne supprimez pas immédiatement l’extension : le renommage facilite le retour arrière.
  • Activez WP_DEBUG uniquement de manière contrôlée et évitez d’exposer publiquement des logs sensibles.
Complément technique

WordPress : enrichir le diagnostic sans masquer la cause

Repères techniques

  • WP_DEBUG_LOG écrit généralement dans wp-content/debug.log seulement si WP_DEBUG est activé et si le processus PHP peut écrire le fichier.
  • Renommer le dossier d’un plugin désactive son chargement sans modifier la base, ce qui est utile quand wp-admin est inaccessible.
  • WP_MEMORY_LIMIT ne peut pas dépasser les limites réellement accordées par PHP/hébergeur ; une erreur mémoire exige de lire memory_limit et le pic.

Récupération contrôlée

Isoler le plugin ou la couche fautive, garder les logs, puis réactiver un composant à la fois.

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Pièges spécifiques

  • Supprimer .maintenance, un plugin ou le cache sans noter l’état initial peut faire disparaître le symptôme sans expliquer la cause.
  • Une boucle de redirection peut venir de WordPress, du proxy/CDN, HTTPS ou d’un plugin : vérifier chaque couche séparément.

Comment valider

  • Le site charge avec les logs propres et le composant fautif est identifié, pas seulement désactivé.
  • Les constantes de debug temporaires sont retirées ou adaptées après l’intervention.

Preuves et vérifications

WP_DEBUG_LOG écrit généralement dans wp-content/debug.log seulement si WP_DEBUG est activé et si le processus PHP peut écrire le fichier. Renommer le dossier d’un plugin désactive son chargement sans modifier la base, ce qui est utile quand wp-admin est inaccessible.

Contrôle de résultat

Le site charge avec les logs propres et le composant fautif est identifié, pas seulement désactivé. Les constantes de debug temporaires sont retirées ou adaptées après l’intervention.

Point d’attention

Supprimer .maintenance, un plugin ou le cache sans noter l’état initial peut faire disparaître le symptôme sans expliquer la cause. WP_MEMORY_LIMIT ne peut pas dépasser les limites réellement accordées par PHP/hébergeur ; une erreur mémoire exige de lire memory_limit et le pic.

Concepts liés

Référence primaire : WordPress Developer Resources — Debugging.

♡ 0