Instalar un módulo en PrestaShop desde un archivo ZIP: paso a paso y qué hacer cuando falla
Instalar un módulo en PrestaShop desde un ZIP son tres clics en Módulos → Gestor de módulos: subir, elegir el archivo y configurar. Si sale un error, la causa suele ser el formato del paquete, un límite de tamaño del servidor o una versión que no corresponde a tu tienda. Antes de instalar, haz una copia de seguridad y comprueba de dónde viene el paquete.
Autor: El equipo de TellMyShop. Una guía para dueños de tiendas PrestaShop: la causa, el arreglo manual y el mismo trabajo en una conversación con el chat.
Última actualización: · 7 min de lectura
Qué revisar antes de instalar un módulo
Un módulo es código que funciona en tu servidor y tiene acceso a la base de datos de la tienda. Cinco minutos de comprobaciones antes de instalar salen más baratos que las reparaciones después.
- Origen. Descarga el módulo de su autor, de Addons o de la publicación del autor en GitHub. Las copias gratis de módulos de pago sacadas de webs cualquiera son una vía habitual para que entre código malicioso en una tienda.
- Compatibilidad con la versión de tu tienda. La descripción del módulo indica las versiones de PrestaShop y PHP con las que funciona. La versión de tu tienda la ves en Parámetros avanzados → Información.
- Si ya tienes un módulo que hace lo mismo. Dos módulos de opiniones o dos módulos de envío son una causa habitual de conflictos.
- Copia de seguridad. Una copia de los archivos y de la base de datos desde tu hosting o con un módulo de copias. Sin ella, cada error sale caro.
- Momento. Instala cuando la tienda esté tranquila. Prueba primero los módulos de pago y de envío en una copia de pruebas.
Cómo instalar un módulo desde un archivo ZIP
El panel de PrestaShop 8 y 9 tiene un formulario para esto en el Gestor de módulos. La guía de PrestaShop sobre módulos describe la pantalla de módulos en general.
- Ve a Módulos → Gestor de módulos.
- Haz clic en el botón de subir un módulo, arriba de la página.
- Arrastra el archivo ZIP a la caja o elígelo desde tu ordenador. No lo descomprimas antes.
- Espera al mensaje de instalación. Con los módulos más grandes tarda unas decenas de segundos.
- Haz clic en Configurar y configura el módulo siguiendo las instrucciones del autor.
- Abre la tienda en una ventana privada. Revisa la página de inicio, una página de producto y el carrito.
- Mira en Parámetros avanzados → Registros si han aparecido errores nuevos después de la instalación.
Actualizar desde un ZIP funciona igual: subes una versión más nueva del mismo módulo. PrestaShop reconoce que el módulo ya está, sustituye los archivos y ejecuta los scripts de actualización.
En qué fijarse al actualizar un módulo
Una actualización es más que cambiar archivos. Una versión nueva puede cambiar tablas de la base de datos, añadir sitios nuevos en la página o cambiar los ajustes por defecto.
- Lee el registro de cambios del autor. Busca frases sobre la versión de PHP necesaria, ajustes nuevos y cambios en las plantillas.
- Comprueba si tu tema tiene una copia de la plantilla del módulo. Si la tiene, la versión nueva del módulo puede verse distinta de lo que describe el autor, o no mostrar los elementos nuevos.
- Actualiza los módulos de pago y de envío fuera de las horas de compra. Haz un pedido de prueba después de la actualización.
- No saltes varias versiones de golpe sin una copia de seguridad. Los scripts de actualización suelen escribirse pensando en la versión anterior.
Los errores más habituales al instalar un módulo
| Mensaje o síntoma | Causa | Qué hacer |
|---|---|---|
| el módulo no es válido, o el archivo no parece un zip de módulo válido | el ZIP no tiene una carpeta de módulo con un archivo del mismo nombre | descomprímelo en tu ordenador; dentro debe haber una carpeta, p. ej. mymodule/mymodule.php |
| el mismo error con un paquete de Addons | el ZIP descargado contiene el módulo, la documentación y la licencia en un mismo archivo | descomprímelo y sube solo el ZIP interior del módulo |
| la subida termina con un error sin descripción | el archivo pesa más que el límite de subida del servidor | sube el límite con tu proveedor de hosting o sube el módulo por FTP |
| el módulo no es compatible con la versión de tu tienda | el autor fijó un rango de versiones de PrestaShop en el módulo | descarga la versión del módulo para tu PrestaShop |
| una página en blanco o un error 500 después de instalar | el módulo necesita otra versión de PHP o choca con otro módulo | desactiva el módulo, lee el registro de errores |
| sin permiso de escritura | el servidor no deja escribir en la carpeta de módulos | pide a tu proveedor de hosting que ponga los permisos correctos a la carpeta |
La documentación de PrestaShop sobre la estructura de un módulo describe cómo es un paquete correcto: la carpeta del módulo tiene el mismo nombre que el módulo, y el módulo dentro del ZIP debe estar en una subcarpeta. Los desarrolladores de PrestaShop describieron el problema de los paquetes demasiado grandes en la especificación de avisos del Gestor de módulos, junto con los ajustes de PHP responsables.
Si la tienda no se muestra después de instalar, empieza por el artículo sobre el error 500 en PrestaShop. Si el módulo funciona pero rompe algo, desactívalo en lugar de desinstalarlo, como contamos en el artículo sobre desactivar un módulo.
Cómo instalar o actualizar un módulo a través del chat
Le das a tu chat (Claude o ChatGPT) un enlace https directo al archivo ZIP, por ejemplo a una publicación en GitHub o a un archivo del autor. El chat primero descarga el paquete para una vista previa y lo revisa antes de que nada llegue a la tienda: el nombre y la versión del módulo, el origen, la suma de comprobación SHA-256 y la estructura del paquete. Por esta vía no puedes subir un archivo desde tu ordenador; hace falta un enlace.
Tú: Actualiza el módulo de pago a la 2.4.1 desde este enlace de la publicación en GitHub. Revisa la tienda antes y después.
Tu chat: Vista previa del paquete: módulo de pago, versión instalada 2.3.0, versión del paquete 2.4.1. Origen: la publicación del autor en GitHub. Estructura correcta, una sola carpeta de módulo. La suma de comprobación SHA-256 está en la vista previa, para que la compares con la que publicó el autor.
Antes de actualizar haré una copia de los archivos del módulo. Los cambios en la base de datos hechos por el script de actualización no puedo deshacerlos desde el historial; para eso está la copia de seguridad de la base de datos de hoy. Ahora mismo el registro no tiene errores de este módulo. ¿Actualizo?
Tú: Sí.
Tu chat: Actualizado a la 2.4.1. El carrito y la página del pedido responden bien, y no hay errores nuevos en el registro.
Estado de la tarjeta: esperando tu «sí»versión anterior: versión 2.3.0
versión nueva: versión 2.4.1
Los números de versión del ejemplo son ilustrativos. Tienes una petición de ejemplo en el caso de uso instalar o actualizar un módulo desde un paquete ZIP y, si algo deja de funcionar después del cambio, en el caso de uso desactivar un módulo que rompe el carrito.
TellMyShop Pro instala y actualiza módulos cuando activas el interruptor Módulos en el panel del módulo. El interruptor dura 24 horas y necesita una copia de seguridad de la base de datos hecha el mismo día. El chat no instala nada sin vista previa y tu conformidad, y te desaconsejará un módulo de origen dudoso. Desinstalar un módulo no se puede deshacer, así que el chat propone primero desactivarlo. En la versión gratuita TellMyShop Free ves la lista de módulos con sus versiones y los sitios donde se muestran. La comparación de versiones está en la página de precios, y cómo deshacerte de los módulos antiguos lo contamos en el artículo sobre módulos que no se usan.
Preguntas y respuestas
¿Dónde instalo en PrestaShop un módulo desde un archivo ZIP?
En el menú Módulos, en el Gestor de módulos. Arriba de la página hay un botón para subir un módulo, donde arrastras el archivo ZIP o lo eliges desde tu ordenador. Una vez subido, PrestaShop instala el módulo y te ofrece configurarlo.
¿Qué significa el aviso de que el módulo no es válido?
Casi siempre PrestaShop no encontró en el paquete una carpeta de módulo con un archivo del mismo nombre. Puede que hayas descargado un paquete con la documentación en lugar del módulo, un archivo con varios módulos dentro o un ZIP metido dentro de otro ZIP. Descomprime el paquete en tu ordenador y mira qué hay dentro.
¿Actualizar un módulo desde un ZIP borra sus ajustes?
Normalmente no. Cuando subes una versión más nueva del mismo módulo, PrestaShop sustituye los archivos y ejecuta los scripts de actualización del módulo. Los ajustes se quedan, pero los scripts pueden cambiar la base de datos. Por eso haz una copia de seguridad de la tienda antes de actualizar y, mejor, pruébalo en una copia de pruebas.
¿Se puede deshacer la instalación de un módulo?
Un módulo nuevo lo puedes desactivar o desinstalar. Desinstalar normalmente borra sus datos y ajustes, así que no se puede deshacer. En una actualización, los archivos se pueden restaurar desde una copia, pero los cambios en la base de datos hechos por el script de actualización no se deshacen sin una copia de seguridad de la base de datos.
¿TellMyShop Free puede instalar un módulo?
No. La versión gratuita TellMyShop Free solo lee informes de la tienda, entre ellos la lista de módulos con sus versiones. TellMyShop Pro instala y actualiza módulos desde un paquete ZIP cuando el interruptor Módulos está activado durante 24 horas.
PrestaShop es una marca registrada de PrestaShop SA. Claude es una marca de Anthropic PBC. ChatGPT y OpenAI son marcas de OpenAI. TellMyShop no está afiliado a estas empresas.