Un module PrestaShop refuse de s’installer ou disparaît du back-office

Pourquoi une installation échoue silencieusement

Installer un module copie des fichiers dans le dossier /modules du serveur. Sans droit d’écriture suffisant sur ce dossier, la copie échoue, souvent avec un message d’erreur générique qui ne pointe pas clairement vers un problème de droits. C’est la première chose à vérifier quand « l’action installer est impossible ».

Autre cause fréquente : un conflit de nom entre deux modules, quand l’un déclare une classe PHP ou une table en base déjà utilisée par un autre module installé. La méthode install() échoue alors sans toujours indiquer clairement lequel des deux modules est en cause.

Un module écrit pour une autre version de PrestaShop

La méthode install() d’un module tente en général de s’accrocher à un ou plusieurs hooks. Si le module a été écrit pour PrestaShop 1.6 et qu’il est installé sur une 1.7 ou une 8 sans adaptation, l’installation échoue si elle cible un hook qui n’existe plus dans la version installée. C’est une cause fréquente pour les modules anciens ou peu maintenus.

Un module installé manuellement par FTP plutôt que depuis le back-office peut aussi rester invisible tant que le cache de classes du cœur PrestaShop n’a pas été régénéré : le fichier existe sur le serveur, mais PrestaShop ne le voit pas encore.

Configuration ou développement ?

Corriger des droits d’écriture ou régénérer un cache de classes après un dépôt manuel par FTP est un nettoyage rapide. Ça devient un développement quand le module tiers lui-même est cassé : hook obsolète à adapter, conflit de classe à renommer, ou code écrit pour une version de PrestaShop qu’il faut réécrire pour la version actuellement installée.