Le module est actif mais rien ne s’affiche sur le site
Le module est installé, il apparaît dans la liste, il est activé et sa page de configuration répond. Pourtant la boutique n’en montre aucune trace. Dans la quasi-totalité des cas, ce n’est pas un bug du module : c’est qu’il n’est accroché nulle part, ou que le thème n’appelle jamais l’endroit où il s’est accroché.
Ce que vous constatez
- Le module figure dans la liste, activé, et sa configuration s’enregistre normalement
- Rien n’apparaît sur la page où il devrait apparaître, sur aucun navigateur
- Le bloc apparaît sur une page mais pas sur une autre du même type
- Il s’affichait avant un changement de thème, et plus après
- Il s’affiche pour vous connecté en administrateur, mais pas pour un visiteur
Sur PrestaShop : le module n’est pas greffé, ou pas au bon endroit
Un module PrestaShop n’apparaît que s’il est associé à un point d’accroche, et cette association est enregistrée en base au moment de son installation. Si son installation a partiellement échoué, ou si le module a été déposé manuellement, il peut être actif sans être greffé nulle part. La page « Positions » de l’administration liste ces associations et permet de greffer un module sur un point d’accroche précis.
Deuxième cause, plus fréquente encore depuis les thèmes de PrestaShop 1.7 : le module est greffé sur un point d’accroche que votre thème n’appelle jamais. Les colonnes latérales ont disparu de beaucoup de thèmes modernes ; un module conçu pour s’afficher dans une colonne gauche reste alors invisible sans qu’aucune erreur ne soit levée. Le module fonctionne, il produit son contenu, mais aucun gabarit ne le demande.
Troisième cause : les exceptions. La page Positions permet d’exclure un module de certains contrôleurs. Une exception posée il y a longtemps, ou héritée d’une configuration reprise, explique un bloc présent partout sauf sur une page.
Sur WooCommerce : le gabarit du thème a mangé le point d’accroche
WooCommerce autorise un thème à remplacer ses gabarits en les recopiant dans un dossier woocommerce à l’intérieur du thème. C’est prévu, documenté, et c’est la cause d’invisibilité la plus courante : le thème a recopié le gabarit il y a deux ans, et la copie ne contient pas l’appel d’action sur lequel votre extension se greffe. L’extension s’exécute, ne trouve pas son point d’ancrage, et n’affiche rien.
Autre cause devenue fréquente : les blocs de panier et de commande. Une boutique qui utilise les blocs plutôt que les anciens raccourcis ne déclenche pas les mêmes points d’accroche, et une extension écrite pour l’ancien parcours ne s’affiche pas dans le nouveau. Le comportement est normal, mais rien ne le signale.
Enfin, un cache de pages génère des pages statiques : si le module a été activé après la mise en cache, la page servie au visiteur date d’avant. C’est aussi ce qui explique un bloc visible pour vous, connecté et donc non mis en cache, et invisible pour tout le monde.
Dans quel ordre je vérifie
-
Vider tous les caches, puis reregarder
Cache de la plateforme, cache de pages, cache du navigateur, cache du serveur. Une part non négligeable de ces cas se règle là, et il est inutile de chercher plus loin avant de l’avoir fait.
-
Vérifier l’association au point d’accroche
Sur PrestaShop, la page Positions ; sur WordPress, la lecture du code de l’extension pour savoir sur quelle action elle se greffe réellement.
-
Vérifier que le thème appelle ce point
Je cherche l’appel dans les gabarits du thème. S’il n’y est pas, le problème est dans le thème, pas dans le module.
-
Tester avec le thème par défaut
Basculer temporairement sur le thème livré avec la plateforme tranche la question en quelques minutes : si le module s’affiche, la cause est dans le thème.
Pages liées
-
Comprendre les hooks PrestaShop
Le fonctionnement des points d’accroche, indispensable pour situer ce genre de problème.
-
Un module refuse de s’installer
Quand le problème est en amont : le module n’est pas correctement installé du tout.
-
Vider le cache PrestaShop
La procédure complète, y compris quand le back-office ne répond plus.
-
Créer un thème enfant WordPress
Pour modifier un gabarit sans que la modification saute à la mise à jour du thème.
Décrivez votre besoin en 1 minute
Quelques questions ciblées pour que je vous réponde avec une estimation, pas avec un questionnaire de plus.