FAQ: Instalar módulos en PrestaShop con DirectAdmin

Introducción: ¿Por qué surgen dudas al instalar módulos en PrestaShop con DirectAdmin?

Si tienes una tienda online con PrestaShop y tu hosting usa DirectAdmin, es muy probable que en algún momento te hayas encontrado con algún problema al intentar instalar un módulo. No te preocupes, es una de las consultas más frecuentes que recibimos en soporte. La instalación de módulos en PrestaShop, aunque parezca sencilla, puede complicarse por detalles de permisos de archivos, versiones de PHP o configuraciones del panel de control.

En este artículo, vamos a resolver las dudas comunes sobre la instalación de módulos en PrestaShop con DirectAdmin. Te explicaremos paso a paso cómo hacerlo, qué errores puedes encontrar y cómo solucionarlos. Todo explicado de forma clara y sin tecnicismos innecesarios. Al final, serás capaz de gestionar tus módulos PrestaShop sin necesidad de ser un experto en servidores.

¿Qué necesito saber antes de instalar un módulo en PrestaShop?

Antes de empezar, es importante que tengas claros algunos conceptos básicos. Un módulo en PrestaShop es como una aplicación que añade funcionalidades a tu tienda: desde un carrito de compras más avanzado hasta herramientas de SEO o pasarelas de pago.

Para instalarlos correctamente, necesitas:

Acceso a tu panel de control de hosting: En este caso, DirectAdmin.
Acceso al panel de administración de PrestaShop.
Conocimiento básico de archivos: Saber dónde se alojan los archivos de tu tienda (normalmente en la carpeta public_html).
Permisos de escritura: El servidor debe permitir que se escriban archivos en las carpetas de módulos.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso se realiza a través del puerto 2106. El proceso de instalación es muy similar al de DirectAdmin, pero la interfaz cambia ligeramente.

Dudas comunes sobre la instalación de módulos PrestaShop

A continuación, resolvemos las preguntas más frecuentes que recibimos en soporte técnico.

1. ¿Cómo instalo un módulo desde el panel de administración de PrestaShop?

Esta es la forma más sencilla y recomendada para la mayoría de los usuarios.

Pasos a seguir:

Inicia sesión en el back office de tu PrestaShop (por ejemplo, tutienda.com/admin).
Ve a Módulos > Módulos y servicios.
Haz clic en el botón Subir un módulo (arriba a la derecha).
Selecciona el archivo .zip del módulo que has descargado.
PrestaShop lo subirá e instalará automáticamente.
Una vez instalado, busca el módulo en la lista y haz clic en Configurar para ajustarlo.

Posibles problemas:

Error de subida: Si el archivo es demasiado grande, puede que el servidor lo rechace. En ese caso, deberás subirlo manualmente por FTP.
Módulo no compatible: Asegúrate de que el módulo es compatible con tu versión de PrestaShop.

[TIP] Si el módulo no aparece después de subirlo, verifica que el archivo .zip no esté corrupto. Puedes probar a descomprimirlo en tu ordenador para comprobar que contiene la carpeta del módulo.

2. ¿Qué hago si no puedo subir el módulo desde el back office?

Esto suele ocurrir por límites de tamaño de archivo en PHP o por problemas de permisos en el servidor.

Soluciones:

Aumenta el límite de subida en PHP: Puedes hacerlo desde DirectAdmin. Ve a Configuración de PHP y aumenta los valores de upload_max_filesize y post_max_size. Normalmente, 64 MB es suficiente.
Sube el módulo manualmente por FTP: Si el problema persiste, usa un cliente FTP (como FileZilla) para subir la carpeta del módulo directamente a la ruta /public_html/modules/. Luego, desde el back office, ve a Módulos y busca el módulo en la lista. Deberías verlo como "no instalado". Simplemente haz clic en Instalar.

3. ¿Por qué recibo un error de "permiso denegado" al instalar un módulo?

Este error es muy común y suele deberse a que el usuario del servidor web (por ejemplo, www-data) no tiene permisos de escritura en las carpetas de módulos.

Cómo solucionarlo desde DirectAdmin:

Accede a Administrador de archivos en DirectAdmin.
Navega hasta la carpeta /public_html/modules/.
Haz clic derecho en la carpeta del módulo problemático (o en toda la carpeta modules) y selecciona Cambiar permisos.
Establece los permisos a 755 (o 777 temporalmente si el error persiste).
Aplica los cambios recursivamente (a todas las subcarpetas y archivos).

[WARNING] No dejes los permisos en 777 de forma permanente por seguridad. Una vez instalado el módulo, vuelve a 755.

4. ¿Puedo instalar módulos de pago o gratuitos de la misma forma?

Sí, el proceso es exactamente el mismo. La diferencia está en que los módulos de pago suelen requerir una clave de licencia que debes introducir durante la configuración. Los módulos gratuitos se instalan directamente.

Recomendación: Siempre descarga módulos de fuentes oficiales (Addons de PrestaShop) o de desarrolladores de confianza para evitar problemas de seguridad.

5. ¿Qué hago si el módulo se instala pero no funciona correctamente?

Esto puede deberse a varias causas:

Incompatibilidad de versiones: Revisa que el módulo sea compatible con tu versión de PrestaShop (1.6, 1.7, 8.x, etc.).
Conflictos con otros módulos: Desactiva temporalmente otros módulos para ver si el problema persiste.
Errores de PHP: Activa el modo debug de PrestaShop para ver el error exacto. Puedes hacerlo editando el archivo /config/defines.inc.php y cambiando _PS_MODE_DEV_ a true.

[INFO] Si no te sientes cómodo editando archivos, contacta con el soporte de tu hosting o con el desarrollador del módulo.

6. ¿Cómo actualizar un módulo en PrestaShop con DirectAdmin?

Actualizar un módulo es similar a instalarlo, pero con un paso adicional: primero debes desinstalar la versión anterior.

Pasos:

En el back office, ve a Módulos > Módulos y servicios.
Busca el módulo que quieres actualizar y haz clic en Desinstalar.
Una vez desinstalado, sube la nueva versión del módulo (como en el punto 1).
Configúralo de nuevo (a veces los datos de configuración se pierden).

Alternativa manual: Si el módulo no se actualiza correctamente, puedes borrar la carpeta del módulo en /public_html/modules/ y subir la nueva versión por FTP. Luego, instálalo desde el back office.

7. ¿Qué son los "módulos nativos" y por qué no puedo desinstalarlos?

Los módulos nativos son los que vienen preinstalados con PrestaShop. Algunos son esenciales para el funcionamiento de la tienda (como el módulo de pago o el de envío). No se recomienda desinstalarlos, ya que podrías romper la tienda.

Si necesitas ocultarlos, puedes desactivarlos desde la lista de módulos.

8. ¿Cómo afecta la versión de PHP a los módulos?

PrestaShop y sus módulos requieren una versión específica de PHP. Si tu hosting usa una versión obsoleta (como PHP 5.6), muchos módulos modernos no funcionarán.

Cómo verificar y cambiar la versión de PHP en DirectAdmin:

Accede a Configuración de PHP en DirectAdmin.
Selecciona la versión de PHP recomendada para tu PrestaShop (normalmente PHP 7.4 o 8.0 para PrestaShop 1.7 y 8.x).
Guarda los cambios.

[WARNING] Cambiar la versión de PHP puede afectar a otros sitios web en tu cuenta. Si tienes dudas, consulta con el soporte técnico.

9. ¿Puedo instalar módulos desde la carpeta "modules" por FTP?

Sí, es una opción muy útil cuando el back office no funciona o el módulo es demasiado grande.

Pasos:

Descarga el módulo y descomprímelo en tu ordenador.
Conecta por FTP a tu servidor (usando las credenciales de DirectAdmin).
Navega a la carpeta /public_html/modules/.
Sube la carpeta del módulo (no el archivo .zip).
Ve al back office de PrestaShop y busca el módulo en la lista. Debería aparecer como "no instalado". Haz clic en Instalar.

10. ¿Qué hago si después de instalar un módulo mi tienda deja de funcionar?

No entres en pánico. Esto suele ser temporal y tiene solución.

Pasos a seguir:

Desactiva el módulo desde el back office: Si puedes acceder, ve a la lista de módulos y desactívalo.
Accede por FTP y renombra la carpeta del módulo: Si no puedes acceder al back office, conecta por FTP y cambia el nombre de la carpeta del módulo (por ejemplo, de micromodulo a micromodulo_desactivado). Esto lo desactivará automáticamente.
Contacta al soporte: Si el problema persiste, contacta con el desarrollador del módulo o con el soporte de tu hosting.

[INFO] Siempre es recomendable hacer una copia de seguridad de tu tienda antes de instalar cualquier módulo nuevo.

Preguntas frecuentes adicionales (FAQ)

¿Puedo instalar módulos de PrestaShop en un hosting compartido con DirectAdmin?

Sí, es perfectamente posible. Solo asegúrate de que tu plan de hosting cumpla con los requisitos mínimos de PrestaShop (PHP 7.4+, MySQL 5.6+). Si tienes dudas, consulta con tu proveedor.

¿Qué hago si el módulo requiere acceso SSH?

Algunos módulos avanzados (como los de importación masiva) pueden requerir acceso SSH. Si tu hosting no lo permite, puedes pedir al soporte que ejecuten los comandos por ti. En DirectAdmin, el acceso SSH suele estar disponible en planes superiores.

¿Los módulos gratuitos son seguros?

No todos. Descarga siempre de fuentes oficiales o de desarrolladores con buena reputación. Los módulos gratuitos de dudosa procedencia pueden contener malware o vulnerabilidades.

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

Revisa la descripción del módulo en la tienda de Addons o en la web del desarrollador. Normalmente indican las versiones compatibles. También puedes probar a instalarlo; si da errores, es probable que sea incompatible.

Consejos finales para una instalación exitosa

Haz copias de seguridad: Antes de instalar cualquier módulo, respalda tu base de datos y archivos. Puedes hacerlo desde DirectAdmin con la herramienta de backups.
Mantén PrestaShop actualizado: Las versiones antiguas son más propensas a errores y vulnerabilidades.
Usa módulos de calidad: Invertir en módulos de pago suele ser más seguro y con mejor soporte.
Prueba en un entorno de desarrollo: Si es posible, instala el módulo primero en una copia de tu tienda para evitar sorpresas.

[TIP] Si tienes problemas persistentes, no dudes en contactar con el soporte técnico de tu hosting. Ellos pueden ayudarte a revisar los logs del servidor y ajustar configuraciones que tú no puedes modificar.

Conclusión

La instalación de módulos PrestaShop en un entorno con DirectAdmin no tiene por qué ser un dolor de cabeza. Con esta guía, esperamos haberte ayudado a resolver las dudas comunes y a sentirte más seguro al gestionar tu tienda online. Recuerda que la clave está en la paciencia, en seguir los pasos correctamente y en no tener miedo de pedir ayuda cuando sea necesario.

Si te ha quedado alguna duda, déjanos un comentario o contacta con nuestro equipo de soporte. ¡Estaremos encantados de ayudarte a que tu tienda funcione a la perfección!