Thème PrestaShop : le hook Home ne s'affiche plus — diagnostic et correction

Introduction

Vous venez de configurer votre thème PrestaShop, vous avez paramétré vos images dans le configurateur de thème et votre slider… et rien ne s'affiche en page d'accueil. Frustrant, surtout quand tout semblait correct dans le back-office.

Dans la grande majorité des cas, ce problème provient d'une confusion entre les hooks — ces fameux « points d'accroche » qui déterminent où chaque module s'affiche dans votre boutique. Voyons ensemble comment identifier et résoudre ce type de dysfonctionnement.

Comprendre les hooks d'affichage PrestaShop

Qu'est-ce qu'un hook ?

Un hook (ou point d'accroche) est un emplacement prédéfini dans le template de votre thème où PrestaShop peut injecter le contenu d'un module. Chaque thème définit ses propres hooks et leur positionnement visuel.

Les hooks les plus courants pour la page d'accueil sont :

HookEmplacement typiqueUsage courant `displayTop` / `Top`En-tête, sous le menuBannières, barres promotionnelles `displayHome` / `Home`Corps de la page d'accueilProduits vedettes, blocs éditoriaux `displayBanner`Zone de bannièreSlider principal `displayTopColumn`Colonne hauteContenu secondaire

Le piège classique : Home vs Top

Beaucoup de thèmes — notamment les thèmes premium ou personnalisés — redéfinissent l'emplacement visuel de ces hooks. Ce qui s'appelait « Home » dans le thème par défaut peut correspondre au hook Top dans votre thème actuel, et inversement.

Concrètement : vous configurez vos images sur le hook Home en pensant qu'elles s'afficheront en page d'accueil, mais votre thème attend ces images sur le hook Top. Résultat : rien ne s'affiche.

Diagnostic : identifier le bon hook

Étape 1 — Vérifier les hooks déclarés par votre thème

Rendez-vous dans Modules > Positions (ou Design > Positions sur PrestaShop 1.7+/8.x). Cette page liste tous les hooks actifs et les modules qui y sont greffés.

Recherchez votre module (configurateur de thème, slider, etc.) et notez sur quel hook il est actuellement positionné.

Étape 2 — Identifier le hook réellement utilisé par votre thème

Pour déterminer quel hook votre thème utilise réellement pour la zone d'accueil, activez le mode debug de PrestaShop :

// config/defines.inc.php
define('_PS_MODE_DEV_', true);

Sur PrestaShop 8.x, vous pouvez aussi activer le mode debug directement depuis le back-office :

Paramètres avancés > Performances > Mode debug : Oui

Une fois le mode debug actif, le Profiler en bas de page liste tous les hooks appelés et les modules exécutés dans chacun d'eux. Vous verrez immédiatement quel hook correspond à quelle zone visuelle.

Étape 3 — Inspecter le template du thème

Pour une identification certaine, ouvrez le fichier template principal de votre thème :

PrestaShop 1.6 :

{* themes/votre-theme/index.tpl *}
{hook h='displayHome'}
{hook h='displayTop'}

PrestaShop 1.7 / 8.x :

{* themes/votre-theme/templates/index.tpl *}
{hook h='displayHome'}

Le nom du hook dans le template est la référence absolue.

Correction : déplacer un module sur le bon hook

Méthode 1 — Via l'interface back-office

1. Allez dans **Modules > Positions** (ou **Design > Positions**)
2. Recherchez votre module dans la liste
3. Cliquez sur l'icône de déplacement (ou le bouton « Greffer ce module »)
4. Changez le hook de destination (par exemple, de `Home` vers `Top`)
5. Enregistrez

Méthode 2 — Greffer un module sur un nouveau hook

1. En haut de la page **Positions**, cliquez sur **Greffer un module**
2. Sélectionnez le module concerné
3. Choisissez le hook de destination
4. Validez

Méthode 3 — Via le code (pour les développeurs)

Si vous développez un module et souhaitez qu'il s'enregistre automatiquement sur le bon hook :

// Dans la méthode install() de votre module
public function install()
{
    return parent::install()
        && $this->registerHook('displayHome')
        && $this->registerHook('displayTop');
}

Sur PrestaShop 8.x, vous pouvez aussi utiliser les attributs PHP pour déclarer les hooks :

#[Hook('displayHome')]
public function hookDisplayHome(array $params): string
{
    return $this->display(__FILE__, 'views/templates/hook/home.tpl');
}

Gérer l'ordre d'affichage des modules dans un hook

Un autre problème courant : votre module s'affiche, mais il est masqué par un autre module positionné au-dessus, ou il apparaît trop bas dans la page.

Dans Modules > Positions, vous pouvez réordonner les modules au sein d'un même hook par glisser-déposer. Le module en première position s'affichera en premier dans la zone du hook.

Par exemple, si votre slider se retrouve sous le configurateur de thème alors que vous souhaitez l'inverse, remontez-le simplement dans la liste du hook concerné.

Bonnes pratiques

1. Documentez les hooks de votre thème

Si vous utilisez un thème premium, créez un mémo des correspondances entre les noms de hooks et leur emplacement visuel. Cela vous évitera de perdre du temps à chaque mise à jour.

2. Videz le cache après chaque modification

Après avoir déplacé un module d'un hook à un autre, videz systématiquement le cache PrestaShop :

Paramètres avancés > Performances > Vider le cache

Ou en ligne de commande (PrestaShop 8.x) :

php bin/console cache:clear

3. Testez sur un thème par défaut

Si le problème persiste, basculez temporairement sur le thème par défaut (classic sur 1.7+/8.x, default-bootstrap sur 1.6). Si le module s'affiche correctement, le problème vient bien de la configuration des hooks dans votre thème.

4. Attention aux mises à jour de thème

Certaines mises à jour de thèmes premium peuvent réinitialiser les positions des modules. Après une mise à jour, vérifiez toujours que vos modules sont bien positionnés sur les bons hooks.

Résumé

Quand un module ne s'affiche plus en page d'accueil, le réflexe est simple :

1. **Vérifier** sur quel hook le module est greffé (Modules > Positions)
2. **Identifier** quel hook votre thème utilise réellement pour cette zone (template ou Profiler)
3. **Déplacer** le module sur le bon hook
4. **Réordonner** les modules si nécessaire
5. **Vider le cache**

Dans la très grande majorité des cas, le problème se résout en moins de deux minutes une fois le bon hook identifié.