Gestionar módulos en PrestaShop | Tutorial para principiantes

¿Qué son los módulos en PrestaShop y por qué son tan importantes?

Los módulos PrestaShop son, en esencia, las aplicaciones que le dan vida a tu tienda online. Piensa en ellos como los "plugins" de WordPress o las "apps" de tu móvil: cada uno añade una funcionalidad concreta a tu negocio. Sin módulos, tu tienda sería como un coche sin ruedas: podría existir, pero no iría a ningún sitio.

Un módulo puede encargarse de tareas tan sencillas como mostrar un bloque de texto en la barra lateral, o tan complejas como gestionar pagos con tarjeta, conectar tu tienda con un ERP o configurar envíos en tiempo real. La gestión módulos es una de las tareas más habituales para cualquier administrador de una tienda PrestaShop, y dominarla te permitirá escalar tu negocio sin depender de un programador para cada pequeño cambio.

En esta guía extensa, te voy a explicar paso a paso, y de forma muy visual, cómo gestionar, instalar, configurar y solucionar problemas con los módulos desde el panel de administración de PrestaShop. No necesitas ser un experto técnico, solo tener acceso a tu back-office (el panel de administración) y ganas de aprender.

Acceso al panel de administración de PrestaShop

Lo primero es entrar en tu tienda. Normalmente, accedes a través de una URL del tipo www.tutienda.com/admin1234 (aunque el sufijo es personalizable). Al introducir tus credenciales (usuario y contraseña), llegarás al famoso "back-office".

Una vez dentro, verás el menú lateral izquierdo. Busca la sección "Módulos". En versiones modernas de PrestaShop (1.7 y 1.8), el menú se divide en varias subsecciones:

Módulos y servicios: Es el catálogo completo de módulos instalados y/o disponibles.
Módulos instalados: Aquí verás solo los que están activos en tu tienda.
Catálogo de módulos: Un escaparate con miles de módulos para comprar o descargar gratuitamente.

Desde este menú, controlarás absolutamente todo lo relacionado con la funcionalidad de tu tienda.

Cómo instalar módulos PrestaShop: Los 3 métodos oficiales

La instalación de módulos es más sencilla de lo que parece. Existen tres vías principales, y te explico cada una con sus trucos.

Método 1: Instalar desde el Catálogo de PrestaShop (el más fácil)

Este es el método recomendado para principiantes.

Ve a Módulos > Módulos y servicios.
En la parte superior derecha, verás un botón azul que dice "Selecciona un módulo" o directamente un buscador. Escribe el nombre del módulo que necesitas (por ejemplo, "pago PayPal").
Pulsa "Instalar" en el módulo que te interese. PrestaShop descargará e instalará el módulo automáticamente.
Una vez instalado, verás el botón "Configurar". ¡Ya lo tienes listo!

Ventaja: Es 100% seguro, ya que el código ha sido verificado por PrestaShop. No romperás tu tienda.

Método 2: Instalar subiendo un archivo ZIP

Si tienes un módulo comprado a un desarrollador externo o un módulo gratuito descargado de GitHub, este es tu método.

Ve a Módulos > Módulos y servicios.
Haz clic en el botón "Subir un módulo" (normalmente está arriba a la derecha, con un icono de flecha hacia arriba).
Se abrirá una ventana. Arrastra tu archivo .zip del módulo hasta la zona punteada o haz clic para buscar el archivo en tu ordenador.
PrestaShop lo subirá, lo descomprimirá y lo instalará automáticamente.
Después, solo tendrás que pulsar en "Instalar" si no lo ha hecho solo.

Ojo: Asegúrate de que el archivo ZIP no esté corrupto y que sea compatible con tu versión de PrestaShop. Si tu tienda usa PHP 7.4 y el módulo requiere PHP 8.0, dará error.

Método 3: Instalación manual por FTP (para avanzados)

Este método es más técnico. Se usa cuando el módulo es demasiado pesado o el servidor tiene límites de subida de archivos muy bajos.

Descarga el módulo y descomprímelo en tu ordenador. Verás una carpeta con archivos PHP, TPL, etc.
Conecta a tu hosting mediante FTP (FileZilla es el programa más común). Si usas un hosting con Syspanel, recuerda que el acceso principal es a través del puerto 2106 para el panel de control, pero para FTP usarás el puerto estándar 21.
Navega hasta la carpeta /public_html/modules/ (o /www/modules/ dependiendo del hosting).
Sube la carpeta del módulo (la que contiene los archivos) directamente dentro de la carpeta modules.
Ve a tu back-office de PrestaShop. Ahora verás el módulo en la lista de "Módulos instalados" pero en estado "No instalado". Pulsa "Instalar".

[WARNING]: Este método solo es recomendable si sabes lo que haces. Un error al subir archivos puede dar un error 500 en tu tienda. Si no estás seguro, usa el método del ZIP.

Configurar módulos: Paso a paso

Instalar el módulo es solo el principio. La verdadera magia está en la configuración. Cada módulo tiene su propia interfaz, pero todos siguen un patrón común.

La página de configuración

Cuando instalas un módulo, verás un botón azul "Configurar". Al pulsarlo, se abre una nueva página. Aquí es donde defines cómo se comportará el módulo.

Por ejemplo, si instalas un módulo de envío, aquí es donde pones las tarifas. Si instalas un módulo de pago, aquí es donde pones las credenciales de tu banco.

Consejo de oro: Antes de tocar nada, lee la pestaña de "Ayuda" o el documento adjunto. Muchas veces, los errores vienen por no leer las instrucciones del desarrollador.

Campos comunes en la configuración

Aunque cada módulo es un mundo, es habitual encontrar estos campos:

Estado del módulo: Activo/Inactivo. Si lo desactivas, el módulo se queda instalado pero no funciona en la tienda.
Título o nombre visible: Te permite cambiar el nombre que ven los clientes (por ejemplo, en el bloque de pago).
Opciones de visibilidad: Dónde quieres que aparezca (homepage, pie de página, etc.).
Credenciales o API Keys: Para módulos de pago (Stripe, PayPal) o envíos (Correos, GLS), necesitarás pegar aquí las claves que te da el proveedor.

Guardar cambios y probar

Siempre hay un botón "Guardar" al final de la página. Púlsalo y, después, ve a la parte pública de tu tienda (la parte de los clientes) para verificar que todo funciona correctamente.

[TIP]: Si tienes una caché activa en PrestaShop (Prestashop 1.7 la trae por defecto), es posible que los cambios no se vean al instante. Ve a Parámetros avanzados > Rendimiento y pulsa "Vaciar la caché". Esto es un clásico para resolver el "no veo mis cambios".

Gestión de módulos: Activar, desactivar, reiniciar y desinstalar

La gestión módulos no solo es instalar. También necesitas saber cómo controlarlos en el día a día.

Activar y desactivar módulos

En la lista de "Módulos instalados", cada módulo tiene un icono de interruptor (un botón verde/azul).

Verde: Módulo activo y funcionando.
Gris: Módulo desactivado (no se ejecuta, pero sus archivos siguen en el servidor).

¿Cuándo desactivar un módulo? Si un módulo te da problemas de velocidad o conflictos con otro, desactívalo para hacer pruebas sin borrarlo.

Reiniciar o resetear un módulo

A veces, un módulo se queda "colgado" o pierde su configuración. La opción "Reiniciar" es la solución milagrosa.

Ve a la lista de módulos instalados.
Busca el módulo problemático.
En el menú desplegable (las tres flechas o puntos), selecciona "Reiniciar".

Esto restablecerá el módulo a su estado original de fábrica. ¡Cuidado! Perderás toda la configuración que hayas hecho. Por eso, antes de reiniciar, anota los valores de configuración importantes.

Desinstalar un módulo

Si ya no necesitas un módulo, es mejor desinstalarlo para liberar recursos.

En la lista de módulos, despliega el menú del módulo en cuestión.
Haz clic en "Desinstalar".
Te preguntará si quieres borrar también los archivos del servidor. Si estás seguro de que no lo usarás más, marca la casilla para eliminar los archivos. Esto mantiene tu servidor limpio.

[INFO]: Desinstalar no es lo mismo que borrar. Al desinstalar, el módulo queda en el catálogo de "Módulos no instalados" y puedes reinstalarlo sin volver a subir archivos. Si borras los archivos, tendrás que volver a subirlos desde cero.

Solución de problemas comunes con módulos

Aquí te dejo un mini-FAQ para los problemas más habituales. Esto te ahorrará muchos quebraderos de cabeza.

"El módulo no se instala y me da un error de compatibilidad"

Causa: Tu versión de PHP es demasiado antigua o demasiado nueva para el módulo.
Solución: Ve a Parámetros avanzados > Rendimiento y mira la versión de PHP. Si es inferior a 7.1, muchos módulos modernos no funcionarán. Contacta con tu hosting para cambiar la versión de PHP. Si tu hosting usa Syspanel, puedes cambiar la versión de PHP desde el panel (recuerda, acceso por el puerto 2106). En la sección de "Administrador de PHP", selecciona la versión recomendada por PrestaShop (normalmente 7.4 u 8.1).

"El módulo está activo pero no aparece en la tienda"

Causa 1: Caché de PrestaShop.
Solución: Vacía la caché en Parámetros avanzados > Rendimiento.
Causa 2: El módulo necesita ser colocado en un "gancho" (hook).
Solución: Ve a Diseño > Posiciones (o Diseño > Ganchos). Busca el gancho donde quieres que aparezca (por ejemplo, "displayHome" para la página de inicio) y arrastra tu módulo hasta ahí. Es un error muy común en módulos de diseño.

"El módulo da error 500 (Internal Server Error)"

Causa: Conflicto con otro módulo o error de código.
Solución: Desactiva el módulo desde la base de datos (si no puedes acceder al panel) o desde el propio panel si aún puedes entrar. Si no puedes entrar, ve a FTP, renombra la carpeta del módulo dentro de /modules/ (por ejemplo, de micodigo a micodigo_off). Esto lo desactivará forzosamente y podrás acceder al panel para investigar.

"¿Cómo hago una copia de seguridad antes de tocar módulos?"

Solución: Antes de instalar o actualizar un módulo crítico, haz una copia de seguridad de tu base de datos y de los archivos. Puedes hacerlo desde el panel de tu hosting (si usas Syspanel, busca la sección "Copias de seguridad" o "Backup"). También puedes usar módulos de backup automático como "Backup and Restore".

Buenas prácticas para la gestión de módulos

Para terminar, te dejo una lista de hábitos que te harán la vida mucho más fácil:

Mantén los módulos actualizados: Las actualizaciones corrigen errores de seguridad y compatibilidad. Ve a Módulos > Módulos y servicios y mira las notificaciones de actualización.
No instales módulos de más: Cada módulo consume recursos del servidor. Si tu tienda carga lenta, revisa cuántos módulos tienes activos y desinstala los que no uses.
Lee las reseñas y la compatibilidad: En el catálogo de PrestaShop, fíjate en las valoraciones y en la versión de PrestaShop compatible.
Prueba en un entorno de pruebas: Si puedes, monta una copia de tu tienda en un subdominio para probar módulos nuevos antes de ponerlos en producción. Esto es vital si vendes a clientes reales.

Conclusión

Gestionar y configurar los módulos PrestaShop es una habilidad esencial para cualquier propietario de una tienda online. No es complicado una vez que entiendes la lógica: instalar, configurar, activar y mantener. Con esta guía, ya tienes el mapa para hacerlo con confianza.

Recuerda que cada módulo es un engranaje en la maquinaria de tu negocio. Tómate tu tiempo para configurarlos bien, haz pruebas y, ante cualquier duda, consulta la documentación oficial o los foros de la comunidad. La comunidad de PrestaShop es enorme y siempre hay alguien dispuesto a ayudar.

Si sigues estos pasos, tu tienda funcionará como un reloj suizo. Y si te surge un problema muy técnico, no dudes en contactar con tu proveedor de hosting. Ellos pueden ayudarte a solucionar conflictos de servidor o de PHP que estén afectando a tus módulos.

¡Ahora ve y dale a tu tienda la funcionalidad que se merece!