Actualizado en octubre de 2026.
Como si de un reloj suizo se tratase, cualquier tienda PrestaShop se compone de una cantidad sorprendente de mecanismos y piezas que facilitan su funcionamiento día tras día. Entre ellas están los "hooks", los “ganchos” donde se asocia el contenido y la lógica de los módulos que conforman la tienda. Esta guía sirve para PrestaShop 8 y 9.
¿Qué son los "hooks" en PrestaShop?
Un hook es un punto de anclaje de PrestaShop al que un módulo asocia su código para mostrar contenido o reaccionar a un evento de la tienda, como mostrar una oferta en la portada o actuar cuando un cliente crea su cuenta. Cada hook tiene un nombre, como ‘displayHome’, ‘displayFooter’, ‘actionProductAdd’ o ‘actionCustomerAccountAdd’, y el prefijo indica su tipo (lo vemos más abajo).
Para verlos en tu tienda, entra en el back office y abre Diseño > Posiciones. Verás la lista de hooks disponibles y, bajo cada uno, los módulos asociados en el orden en el que se ejecutan. Todos los módulos de esa lista están enganchados al hook que aparece justo encima de su bloque. Si solo te interesa un módulo, puedes filtrarlo en el desplegable superior o buscar un hook concreto. Y si quieres ampliar tu tienda con nuevas funciones, tienes nuestra colección de módulos para PrestaShop.
Qué hooks puedes usar depende también del tema que tengas instalado, porque cada tema decide en qué zonas pinta cada hook.
Muchos hooks son bloques visibles al público, pero otros son invisibles y solo sirven para ejecutar acciones. Por defecto, la página de Posiciones muestra únicamente los hooks en los que se puede posicionar un módulo; si marcas la casilla para mostrar los hooks no posicionables, aparecerán todos, incluso los invisibles.
Si vienes de PrestaShop 1.6, quizá recuerdes el botón “Live Edit” (editar en vivo), que te llevaba a la tienda para mover los módulos sobre la marcha. La captura de la derecha es de esa versión. Hoy el trabajo se hace desde Diseño > Posiciones.
Tipos de hooks en PrestaShop y cómo funcionan
Hay dos grandes grupos de hooks, de acción (action) y de visualización (display), y se distinguen por el prefijo de su nombre.
- Los hooks de acción (action): se disparan cuando ocurre un evento en PrestaShop y no pintan nada en pantalla. Por ejemplo, ‘actionCustomerAccountAdd’ salta cuando un cliente crea su cuenta con éxito, ‘actionValidateOrder’ cuando se valida un pedido y ‘actionProductAdd’ cuando se crea un producto. Un módulo se engancha a ellos para reaccionar, por ejemplo avisando a otro sistema o guardando un dato.
- Los hooks de visualización (display) generan contenido que se muestra en el front office o en el back office: bloques, columnas, listas de productos o imágenes. Son los más utilizados y aparecen en casi todos los rincones de la tienda, como ‘displayHome’ (portada), ‘displayFooter’ (pie), ‘displayShoppingCart’ (carrito) o ‘displayProductAdditionalInfo’ (información adicional en la ficha de producto). Échale un vistazo a la página de Posiciones de tu tienda y verás cuántos hooks visuales has acumulado.
¿Cómo cambiar un módulo de posición sin tocar código?
Desde Diseño > Posiciones puedes subir o bajar un módulo dentro de su hook con las flechas o arrastrando su fila, y asociarlo a otro hook con la opción “Trasplantar un módulo”, sin escribir una línea de código. Ten en cuenta que algunos módulos solo están preparados para ciertos hooks y que, en algunos casos, hay que modificar su código para trasplantarlos. Puedes consultar el detalle en la documentación oficial de PrestaShop sobre posiciones (en inglés).
¿Cómo usa un módulo los hooks? (para desarrolladores)
Un módulo se engancha a un hook llamando a registerHook(), normalmente al instalarse, y define un método público cuyo nombre es “hook” seguido del nombre del hook. Ese método recibe un array con información de contexto. Un ejemplo con ‘displayHeader’:
public function install()
{
return parent::install()
&& $this->registerHook('displayHeader');
}
public function hookDisplayHeader(array $params)
{
// Aquí va el código de tu módulo.
}Tienes la lista completa de hooks disponibles en la documentación para desarrolladores de PrestaShop 9 (en inglés).
¿Dudas que resolver?
Si necesitas ayuda con la estructura de hooks de tu tienda o un módulo a medida, nuestro equipo te echa una mano. En Línea Gráfica somos expertos en desarrollo PrestaShop: cuéntanos qué necesitas a través de nuestro servicio de soporte PrestaShop.
