Ajouter un hook à Prestashop

Prestashop est un système de gestion de contenu orienté e-commerce bien utile. Les modules du CMS sont positionnés sur les pages de votre site par l’intermédiaire de Hook. Vous pouvez visualiser quel modules est sur quel Hook en allant dans l’onglet Modules > Positions. Chaque position représente un Hook. Il nous est déjà arrivé d’avoir besoin de Hookd supplémentaires pour afficher nos modules à des endroits vraiment spécifiques. Voila comme faire.

Technologies utilisées : SQL et PHP

Outils nécessaires : Editeur HTML et accès à PhpMyAdmin

Etape 1 : Collez dans votre PhpMyAdmin le code ci-dessous pour ajouter le Hook à la table ps_hook (modifiez la requête avec le nom de votre propre Hook)

INSERT INTO `ps_hook` ( `id_hook` , `name` , `title` , `description` , `position` , `live_edit` ) VALUES ( NULL , 'nomDuHook', 'nomDuHook', NULL , '1', '0' );

Etape 2 : Éditez le fichier /classes/FrontController.php pour y ajouter l’appel à votre Hook, environ à la ligne 477

self::$smarty->assign(array('HOOK_HEADER' => Module::hookExec('header'), 'HOOK_TOP' => Module::hookExec('top'), 'HOOK_LEFT_COLUMN' => Module::hookExec('leftColumn')));

devient

self::$smarty->assign(array('HOOK_HEADER' => Module::hookExec('header'), 'HOOK_TOP' => Module::hookExec('top'), 'HOOK_LEFT_COLUMN' => Module::hookExec('leftColumn'), 'NOM_DU_HOOK' => Module::hookExec('nomDuHook')));

PS : Si vous faites la mise à jours de Prestashop, votre nouveau hook ne fonctionnera plus. Il sera écrasé. Depuis la version 1.4 de Prestashop (pour les versions précédentes, c’est pas de chance), vous pouvez surcharger les fichiers. Pour qu’il fonctionne toujours, vous devez surcharger la classe. Copier le fichier FrontController.php de base dans le dossier /override/classes/. Puis, mettez en place les modifications sur le fichier.
Modifiez ensuite la première ligne du fichier class FrontControllerCore en class FrontController extends FrontControllerCore. Enfin, ne gardez que la fonction displayHeader() dans le fichier :

class FrontController extends FrontControllerCore
{
    public function displayHeader()
    {
        // code
    }
}

Etape 3 : placez dans le template (fichier .tpl) de votre choix l’appel au Hook créé

{$NOM_DU_HOOK}

Etape 4 : modifiez le plugin à afficher dans cette zone en ajoutant une petite fonction dans le fichier php principal du module.

Il y a souvent dans les modules un Hook principal, et d’autres Hooks secondaires mais qui fonctionnent de la même façon. L’appel à ces Hooks secondaires se fait en général de cette façon :

function hookRightColumn($params)
{
    return $this->hookLeftColumn($params);
}

De la même façon, nous allons autoriser l’affichage de ce module dans notre nouveau Hook :

function hookNomDuHook($params)
{
    return $this->hookLeftColumn($params);
}

Etape 5 : Il n’y a plus qu’à aller dans Modules > Positions et à ajouter le module de son choix à notre nouveau Hook.