Dudas comunes sobre módulos en PrestaShop: instalación y compatibilidad

¿Te has encontrado con algún problema al instalar un módulo en PrestaShop? No te preocupes, es una de las consultas más frecuentes que recibimos en soporte técnico. Los módulos son el corazón de tu tienda online, permitiéndote añadir funcionalidades como pasarelas de pago, mejoras de SEO, herramientas de marketing o integraciones con redes sociales.

Sin embargo, a veces surgen dudas: ¿por qué no se instala? ¿Es compatible con mi versión? ¿Qué hago si da error? En este artículo, resolveremos las dudas comunes sobre módulos en PrestaShop, centrándonos en la instalación y la compatibilidad. Al final, tendrás un conocimiento sólido para gestionar tus módulos como un experto, sin necesidad de ser técnico.

Empecemos con una de las preguntas más habituales: ¿cómo instalo un módulo en PrestaShop?

¿Cómo instalar un módulo en PrestaShop? (Paso a paso)

Instalar un módulo en PrestaShop es un proceso sencillo, pero es importante seguir los pasos correctos para evitar errores. Aquí te explico dos métodos: desde el back office y mediante FTP (para casos más avanzados).

Método 1: Instalación desde el back office (recomendado para principiantes)

1. Accede a tu panel de administración de PrestaShop. Normalmente la URL termina en /admin o similar.
2. Ve a la sección "Módulos" en el menú lateral izquierdo. Luego haz clic en "Módulos y servicios".
3. Haz clic en "Subir un módulo" (arriba a la derecha). Se abrirá una ventana para seleccionar el archivo .zip de tu módulo.
4. Selecciona el archivo y haz clic en "Subir". PrestaShop lo instalará automáticamente.
5. Configura el módulo una vez instalado. Busca el módulo en la lista y haz clic en "Configurar" para ajustar sus opciones.

[TIP] Asegúrate de que el archivo del módulo esté en formato .zip y no esté dañado. Si el módulo es muy grande, puede dar error de tiempo de espera. En ese caso, prueba con el método FTP.

Método 2: Instalación mediante FTP (para módulos grandes o problemas de subida)

Si el módulo es pesado (por ejemplo, más de 20 MB) o tu servidor tiene límites de subida, puedes instalarlo manualmente:

1. Conéctate a tu servidor mediante un cliente FTP (como FileZilla) o desde el administrador de archivos de tu hosting.
2. Localiza la carpeta /modules dentro del directorio raíz de PrestaShop (normalmente en public_html/ o www/).
3. Sube la carpeta del módulo (descomprimida) a /modules. Asegúrate de que la carpeta tenga el nombre exacto del módulo (ej: ps_googleanalytics).
4. Ve al back office de PrestaShop, a "Módulos" > "Módulos y servicios". El módulo debería aparecer en la lista. Haz clic en "Instalar".

[WARNING] No confundas la carpeta del módulo con el archivo .zip. Debes subir la carpeta descomprimida. Si tienes dudas, consulta la documentación del módulo.

Dudas comunes sobre la instalación de módulos

Aunque el proceso parece simple, a veces surgen problemas. Aquí tienes las preguntas más frecuentes y sus soluciones.

¿Por qué no puedo subir el módulo desde el back office?

Esto suele deberse a limitaciones del servidor. Los más comunes:

• Tamaño máximo de subida: El archivo .zip supera el límite del servidor (normalmente 2 MB, 8 MB o 20 MB).
• Tiempo de ejecución: La subida tarda demasiado y el servidor la corta.
• Permisos de archivos: La carpeta /modules no tiene permisos de escritura.

Soluciones:

• Aumenta los límites en el archivo php.ini (si tienes acceso) o contacta con tu hosting.
• Usa el método FTP para módulos grandes.
• Verifica que la carpeta /modules tenga permisos 755 o 777 (temporalmente).

¿Qué hago si el módulo no aparece después de subirlo por FTP?

Esto puede ocurrir si la carpeta del módulo no está en la ubicación correcta o tiene un nombre incorrecto.

• Revisa la ruta: La carpeta debe estar dentro de /modules, no en una subcarpeta.
• Nombre exacto: El nombre de la carpeta debe coincidir con el del módulo (suele ser el mismo que el del archivo .zip).
• Refresca la página: A veces el back office no actualiza automáticamente. Ve a "Módulos" y haz clic en el icono de recargar (o presiona F5).

[INFO] Si el módulo sigue sin aparecer, verifica los logs de errores de PrestaShop en "Parámetros avanzados" > "Registros". Allí verás mensajes como "El módulo no se pudo instalar porque falta el archivo principal".

¿Cómo sé si un módulo es compatible con mi versión de PrestaShop?

Esta es una de las dudas más críticas. Un módulo incompatible puede causar errores en tu tienda.

Revisa estos puntos antes de instalar:

1. Ficha del módulo: En la tienda de módulos (PrestaShop Addons) o en la documentación del desarrollador, debe indicar las versiones compatibles (ej: "Compatible con PrestaShop 1.7.x").
2. Versión de PHP: Algunos módulos requieren PHP 7.4 o superior. Puedes ver tu versión en "Parámetros avanzados" > "Información del servidor".
3. Dependencias: Algunos módulos necesitan otros módulos o librerías (ej: cURL, JSON). Si faltan, la instalación fallará.

¿Qué hacer si no hay información de compatibilidad?

• Prueba en un entorno de pruebas: Si tienes un clon de tu tienda (staging), instala el módulo allí primero.
• Contacta al desarrollador: La mejor opción es preguntar directamente.
• Revisa las reseñas: Otros usuarios pueden reportar problemas de compatibilidad.

[WARNING] Nunca instales un módulo en producción sin hacer una copia de seguridad. Un módulo incompatible puede romper tu tienda.

Compatibilidad de módulos: factores clave

La compatibilidad no solo depende de la versión de PrestaShop. Hay otros elementos que debes considerar.

Versión de PrestaShop (1.6 vs 1.7 vs 8.x)

PrestaShop ha evolucionado mucho. Los módulos para 1.6 no funcionan en 1.7 o 8.x debido a cambios en el núcleo (Symfony, nuevas APIs). Siempre verifica que el módulo esté diseñado para tu versión.

Ejemplo: Un módulo de SEO para PrestaShop 1.7 puede no ser compatible con 8.0. Busca módulos actualizados.

Versión de PHP

PrestaShop 1.7 requiere PHP 7.1 o superior (recomendado 7.4 u 8.0). Los módulos antiguos pueden usar funciones obsoletas (como mysql_*) que ya no existen en PHP 7+. Esto provoca errores fatales.

Cómo verificarlo:

• Ve a "Parámetros avanzados" > "Información del servidor" en tu back office.
• Compara la versión de PHP con los requisitos del módulo.

Tema y otros módulos instalados

A veces, un módulo entra en conflicto con el tema que usas o con otros módulos. Por ejemplo, un módulo de menú puede no funcionar con un tema personalizado.

Síntomas:

• La tienda deja de cargar correctamente.
• Aparecen errores en la consola del navegador.
• El módulo no muestra sus opciones de configuración.

Solución:

• Desactiva temporalmente otros módulos para identificar el conflicto.
• Prueba con el tema por defecto (por ejemplo, "Classic") para ver si el problema persiste.

Compatibilidad con Syspanel (antes HestiaCP)

Si tu hosting utiliza Syspanel (anteriormente conocido como HestiaCP), ten en cuenta que el panel de control tiene sus propias configuraciones. El acceso a Syspanel se realiza a través del puerto 2106 (ej: https://tudominio.com:2106). Algunos módulos de PrestaShop pueden necesitar ajustes de permisos o de PHP que se gestionan desde Syspanel.

[INFO] Si tienes problemas de instalación con módulos que requieren escritura en archivos, verifica los permisos desde Syspanel. También puedes cambiar la versión de PHP por dominio desde allí.

Preguntas frecuentes (FAQ) sobre módulos PrestaShop

Aquí tienes una lista de las dudas más comunes, con respuestas rápidas.

¿Puedo instalar un módulo gratuito de PrestaShop Addons?

Sí, siempre que sea compatible con tu versión. Los módulos gratuitos suelen tener menos funcionalidades, pero son seguros si los descargas de fuentes oficiales.

¿Qué hago si el módulo da error "500 Internal Server Error"?

Esto suele indicar un problema de PHP. Activa el modo debug de PrestaShop (en /config/defines.inc.php, cambia _PS_MODE_DEV_ a true) para ver el error exacto. Normalmente es por incompatibilidad de PHP o falta de una extensión.

¿Cómo desinstalar un módulo correctamente?

1. Ve a "Módulos" > "Módulos y servicios".
2. Busca el módulo y haz clic en "Desinstalar".
3. Luego puedes hacer clic en "Eliminar" para borrar sus archivos.

[WARNING] Si solo desactivas el módulo, sus archivos siguen en el servidor. Para una eliminación completa, usa "Eliminar" después de desinstalar.

¿Los módulos afectan el rendimiento de mi tienda?

Sí, especialmente si están mal programados o son muchos. Cada módulo añade código y consultas a la base de datos. Recomendación: instala solo los módulos necesarios y mantenlos actualizados.

¿Puedo instalar un módulo de PrestaShop 1.6 en la versión 8?

No, no es posible directamente. Necesitarías una versión adaptada. Algunos desarrolladores ofrecen migraciones, pero es mejor buscar un módulo nativo para tu versión.

Consejos finales para una instalación sin problemas

Para cerrar, aquí tienes un resumen de buenas prácticas:

1. Siempre haz una copia de seguridad de tu tienda (archivos y base de datos) antes de instalar cualquier módulo.
2. Verifica la compatibilidad con tu versión de PrestaShop y PHP.
3. Descarga módulos solo de fuentes confiables: PrestaShop Addons, desarrolladores reconocidos o repositorios oficiales.
4. Prueba en un entorno de staging si es posible.
5. Actualiza los módulos regularmente para evitar vulnerabilidades y problemas de compatibilidad.
6. Si usas Syspanel, recuerda que el puerto de acceso es el 2106 y que puedes gestionar permisos y versiones de PHP desde allí.

Si sigues estos pasos, la instalación de módulos será pan comido. Y si algo sale mal, recuerda que siempre puedes consultar los logs de errores o contactar al soporte de tu hosting.

Espero que este artículo te haya sido útil. ¡Ahora ya puedes instalar módulos en PrestaShop con confianza!