Disponible pour missions & renforts d’agence · Réponse rapide, par la personne qui intervient

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é.

Décrire mon problème Discuter sur WhatsApp

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

  1. 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.

  2. 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.

  3. 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.

  4. 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

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.

Que doit faire le module ?
Sur quelle version de PrestaShop ?
Où le module doit-il s’intégrer ? (facultatif)
Avez-vous déjà essayé un module du marché ? (facultatif)

Savoir ce qui a échoué évite de reproduire la même limite.

Pour quand ? (facultatif)
Indiquez au moins un e-mail ou un téléphone pour que je puisse vous répondre.

Indiquez au moins un e-mail ou un téléphone pour que je puisse vous répondre.

Questions fréquentes

Le module s’affiche sur la page d’accueil mais pas sur les fiches produit, pourquoi ?
Soit il est greffé sur un point d’accroche présent uniquement sur l’accueil, soit une exception l’exclut du contrôleur des fiches produit. Les deux se règlent depuis l’administration, sans toucher au code.
J’ai changé de thème et le module a disparu, est-ce normal ?
C’est fréquent et cohérent : chaque thème décide des points d’accroche qu’il appelle et de leur emplacement. Un module greffé sur une zone que le nouveau thème n’a pas devient invisible sans erreur.
Je vois le bloc en étant connecté à l’administration, pas en navigation privée
C’est la signature d’un cache de pages : le contenu servi aux visiteurs est une version enregistrée avant l’activation du module. Vider ce cache suffit généralement.
Faut-il modifier le thème pour afficher un module ?
Pas toujours : greffer le module sur un point d’accroche que le thème appelle déjà est préférable. Si l’emplacement voulu n’existe pas dans le thème, alors oui, l’appel doit y être ajouté, et cette modification doit être faite de façon à survivre aux mises à jour du thème.
Comment savoir sur quel point d’accroche un module se greffe ?
Sur PrestaShop, la page Positions l’indique. Sur WordPress, cela se lit dans le code de l’extension, dans les appels d’enregistrement d’actions et de filtres : il n’y a pas d’écran équivalent.