Blog › Problemas y soluciones

He instalado el módulo y no se ve: la lista de comprobación

Subes el ZIP, la instalación sale en verde, pero en la tienda no hay rastro. Esta es la lista ordenada de comprobaciones para encontrar el motivo exacto.

He instalado el módulo y no se ve: la lista de comprobación

Subes el archivo ZIP al panel, PrestaShop te muestra el aviso verde de que se ha instalado correctamente, abres la tienda para ver el resultado y la página sigue exactamente igual. Cuando un módulo no se ve, PrestaShop no suele dar ninguna pista en pantalla ni muestra avisos evidentes, lo que deja a cualquiera con la sensación de haber perdido el tiempo.

En nuestra joyería online nos ha pasado muchas veces a lo largo de los años. Gran parte de las averías aparentes no se deben a que el archivo esté roto, sino a cómo gestiona el sistema la memoria temporal, la colocación visual o los fallos de código. Esta es la lista de comprobaciones que seguimos nosotros en el taller, ordenada de la causa más común a la más compleja.

1. La caché sigue mostrando la versión vieja

Es la causa más frecuente con mucha diferencia. PrestaShop guarda en memoria versiones compiladas de las plantillas, archivos de configuración y traducciones para que la tienda cargue rápido. Cuando añades un módulo nuevo, el sistema muchas veces sigue sirviendo a los visitantes la versión de la página que guardó antes de la instalación.

Para descartar esto, ve a Parámetros avanzados > Rendimiento y pulsa en el botón superior que indica Borrar caché. Al hacerlo, el motor compila de nuevo las pantallas incorporando las llamadas al módulo recién añadido.

Si utilizas algún sistema o módulo específico de caché de página completa (de los que guardan el HTML entero ya renderizado), borrar la caché estándar de PrestaShop puede no ser suficiente: tendrás que vaciar también la memoria de ese sistema en particular. A nosotros nos ocurrió en la tienda con un editor visual de páginas: un cambio no aparecía y parecía un error del componente, pero al purgar la caché de la página el problema desapareció por completo. Conviene recordar que limpiar la memoria no arregla fallos de programación, pero asegura que lo que ves en pantalla es el estado real del servidor.

2. El módulo no está enganchado en el hook correcto

Un módulo de PrestaShop no se pinta donde quiere por arte de magia. Necesita conectarse a un hook (un punto de anclaje de la plantilla o del proceso de compra). Por ejemplo, los elementos de la portada usan displayHome, la cabecera recurre a displayTop o displayNav, y los avisos junto al botón de compra en la ficha de producto se anclan en displayProductAdditionalInfo.

A veces el instalador no registra el anclaje automáticamente, o el orden asignado lo deja escondido al final de la página. Para comprobarlo, entra en el menú y revisa las posiciones dentro de Diseño > Posiciones. En esa pantalla puedes:

Hay otro detalle importante con las plantillas compradas o personalizadas: un tema puede haber eliminado un hook estándar de sus ficheros .tpl. Si tu módulo necesita mostrarse en displayFooterBefore o en displayProductExtraContent, pero el diseñador de tu plantilla decidió no incluir esa llamada en el código del tema, el módulo estará bien instalado pero no se verá nunca.

3. PrestaShop 8 oculta los errores dentro de los hooks

Este es un comportamiento que despista a muchísimas personas y que comprobamos a fondo durante el desarrollo de las herramientas de PluginPilot: en PrestaShop 8, cuando la tienda está en modo producción (el modo normal con el que atiendes a los clientes), el sistema oculta los errores que ocurren dentro de la ejecución de un hook.

Si la plantilla del módulo tiene un fallo de sintaxis, o si el archivo PHP intenta llamar a una función que da error, PrestaShop no muestra una pantalla en blanco ni un error 500. Simplemente interrumpe ese bloque en silencio y continúa cargando el resto de la página. El síntoma visual es idéntico a que el módulo no estuviera: no se ve nada.

Para comprobar si este es tu caso:

  1. Entra en Parámetros avanzados > Rendimiento.
  2. Activa la opción de modo depuración y guarda los cambios.
  3. Vuelve a cargar la página de la tienda donde debería aparecer el módulo.

Si había un error bloqueando la visualización, ahora verás una pantalla detallada con la traza técnica del problema en lugar de una omisión silenciosa. Cuando termines de revisarlo, desactiva siempre el modo depuración para que tus clientes no vean avisos técnicos si ocurre cualquier imprevisto.

4. El módulo está apagado, sin configurar o mal inicializado

Parece una obviedad, pero ocurre con frecuencia: cuando un módulo instalado no funciona tras subirlo, conviene revisar su estado en Módulos > Gestor de módulos. Algunos módulos se suben en estado desactivado por defecto, o incluyen interruptores internos dentro de su propia pantalla de ajustes.

Busca el módulo en la lista y pulsa en su botón Configurar. Muchos componentes requieren que guardes sus ajustes al menos una vez tras la instalación para crear sus variables básicas en la base de datos o para activar la opción general de «Mostrar en la tienda». Si los campos obligatorios están vacíos, el código del módulo suele abortar su ejecución y no muestra nada en la parte pública.

Si sospechas que la instalación se quedó a medias, puedes recurrir a la opción de restablecer desde el menú desplegable del propio módulo. Como explicamos en nuestra guía sobre desactivar, desinstalar o restablecer un módulo en PrestaShop, restablecer vuelve a ejecutar todo el proceso de registro de hooks y ajustes iniciales desde cero, lo que suele solucionar archivos mal vinculados durante la subida inicial.

5. Conflicto de overrides o incompatibilidades de versión

Cuando las comprobaciones anteriores no dan resultado, entramos en las causas técnicas más complejas: los archivos override y la versión de PHP.

Un override es un archivo que reemplaza una clase interna de PrestaShop para cambiar cómo funciona el núcleo del programa. Cuando instalas un módulo que los necesita, PrestaShop copia esos ficheros a la carpeta /override/ del servidor. El problema surge cuando dos módulos intentan sobreescribir el mismo método de la misma clase (por ejemplo, reglas del carrito o del despachador de URLs). Si se produce un choque de overrides, uno de los módulos dejará de responder o la tienda ignorará sus cambios.

Ten en cuenta también que los overrides solo se copian al instalar: si actualizas un módulo subiendo archivos por encima, los cambios en los overrides no se aplican solos. Y cada vez que se toca esa carpeta, es imprescindible volver a borrar la caché para que PrestaShop reconstruya su índice de clases.

Por último, revisa la compatibilidad técnica del módulo con tu versión exacta de PrestaShop y la versión de PHP de tu alojamiento. Un módulo programado para versiones antiguas puede contener funciones obsoletas que hagan fallar la carga en PrestaShop 8 sin dejar aviso en pantalla.

Resumen de comprobaciones

Qué ocurre Dónde mirar Acción recomendada
Página idéntica tras instalar Parámetros avanzados > Rendimiento Borrar la caché del sistema y de módulos de página completa.
No sale en su sección Diseño > Posiciones Comprobar si el módulo está anclado en el hook correspondiente.
Instalado pero invisible Parámetros avanzados > Rendimiento Activar modo depuración para revelar posibles errores PHP ocultos.
Sin opciones activas Módulos > Gestor de módulos Entrar en Configurar, rellenar ajustes mínimos o restablecer.
Fallo tras tocar el núcleo Carpeta /override/ y registros en /var/logs Revisar si otro módulo está pisando las mismas clases.

Por dónde empezaríamos nosotros en la práctica

Si nos ocurriera ahora mismo en joyeriahago.com, no perderíamos tiempo mirando archivos por FTP desde el primer minuto. El orden más rápido para no dar palos de ciego es este:

  1. Pulsa en Borrar caché dentro de Parámetros avanzados > Rendimiento y recarga la tienda con el navegador en modo incógnito.
  2. Entra en Diseño > Posiciones, filtra por el nombre del módulo y confirma en qué hook está metido.
  3. Si está en su hook y la caché está limpia pero sigue sin aparecer, activa el modo depuración unos segundos para ver si PrestaShop 8 se estaba tragando un error de código.

Siguiendo estos tres pasos resuelves casi la totalidad de los casos dejando los overrides y las revisiones de plantilla únicamente para cuando hay un problema técnico real de fondo.