Au moment de l’activation, WordPress teste l’extension avant de l’activer pour de bon. Si son code plante, il annule l’activation et affiche ce message, avec juste en dessous un petit cadre qui contient l’erreur PHP exacte. Votre site n’est pas touché : l’extension reste simplement désactivée tant que la cause n’est pas réglée.
Pourquoi cette erreur apparaît
- Une autre copie de la même extension est déjà installée : ancien dossier renommé, ou version Pro conçue pour remplacer la version gratuite et non pour la compléter.
- L’extension demande une version de PHP plus récente que celle du serveur, ou utilise une fonction retirée de PHP 8.
- Une extension dont elle dépend est absente ou désactivée, comme un module complémentaire de WooCommerce sans WooCommerce.
- L’archive .zip était incomplète : un fichier manque et PHP ne peut pas le charger.
- La mémoire PHP disponible ne suffit pas pour charger l’extension.
Comment corriger le problème
Lire le cadre sous le message
Sous la phrase d’erreur, WordPress affiche ce qui a bloqué l’activation : « Cannot redeclare », « Class not found », « Allowed memory size »… Copiez ce texte : il nomme la cause et le fichier concerné. Si le cadre reste vide, passez à l’étape du journal de débogage.
Chercher un doublon de l’extension
Dans Extensions > Extensions installées, vérifiez qu’une autre copie de la même extension n’est pas déjà présente, active ou non. Pour un couple gratuite et Pro, lisez la documentation de l’éditeur : certaines versions Pro complètent la version gratuite (les deux restent actives), d’autres la remplacent, et il faut alors désactiver la gratuite avant d’activer la Pro.
Comparer avec la version de PHP du serveur
La version de PHP de votre hébergement figure dans Outils > Santé du site, parmi les informations sur le serveur. Comparez-la avec la ligne Requires PHP de la page de l’extension ou de son fichier readme.txt. Si le serveur est en retard, la solution passe par un changement de version de PHP, préparé avec soin.
Réinstaller une archive complète
Quand l’erreur parle d’un fichier introuvable (« Failed opening required »), le paquet était incomplet. Téléchargez une archive neuve depuis wordpress.org ou votre compte client chez l’éditeur, puis téléversez-la depuis Extensions > Ajouter une extension : WordPress propose de remplacer la version déjà installée.
Activer le journal de débogage
Ajoutez ces lignes dans wp-config.php, au-dessus de la mention « C’est tout, ne touchez pas à ce qui suit », retentez l’activation puis ouvrez wp-content/debug.log. La dernière ligne « PHP Fatal error » donne le message complet. Remettez WP_DEBUG à false une fois la cause trouvée.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );Faites une sauvegarde complète avant de remplacer une extension ou de changer de version de PHP : ce dernier changement concerne tout le site, pas seulement l’extension en cause.
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