DISPLAY FO Desde 1.5

displayHome

~3 min de lectura

#Descripcion

Muestra contenido en la pagina de inicio de la tienda. Es uno de los hooks de display mas importantes, utilizado por modulos como sliders, bloques de productos destacados, banners promocionales y cualquier contenido que aparezca en la home. Se ejecuta en el template de la pagina principal, normalmente debajo del header y del banner.

📍
Disparado por
  • IndexControllerCore::initContent()controllers/front/IndexController.php

#Parametros

Este hook no recibe parametros via $params.

#Ejemplo de codigo

mymodule.php
php
public function install()
{
    return parent::install()
        && $this->registerHook('displayHome');
}
mymodule.php
php
/**
 * Hook displayHome — Muestra productos destacados en la home
 */
public function hookDisplayHome($params)
{
    // Obtener productos destacados
    $products = Product::getNewProducts(
        (int)$this->context->language->id,
        0,
        8  // limite de productos
    );

    // Asignar datos al template
    $this->context->smarty->assign([
        'products' => $products,
        'module_name' => $this->name,
    ]);

    return $this->display(__FILE__, 'views/templates/hook/home.tpl');
}
template.tpl
smarty
{hook h='displayHome'}

#Notas y gotchas

  • ⚠️ Este hook se ejecuta solo en la pagina de inicio (IndexController), no en otras paginas.
  • ⚠️ Si tu modulo necesita aparecer en todas las paginas, usa `displayHeader` o `displayFooter` en su lugar.
  • ⚠️ El orden de aparicion depende de la posicion del modulo en Back Office > Diseno > Posiciones.
  • ⚠️ En el tema Classic, este hook se renderiza dentro de `<section id="content">` en `index.tpl`.
  • ⚠️ Multiples modulos pueden engancharse a este hook — cada uno devuelve su HTML y se concatenan.

#Relacionados

#Historial de versiones

Version PSCambio
1.5 Introducido como hook principal de la pagina de inicio
1.7 Permanece sin cambios, sigue siendo el hook principal de la home
Descargar en Markdown Pensado para pegar en ChatGPT, Claude u otra IA. Incluye solo el contenido de esta pagina.