Instalar módulo PrestaShop manualmente en DirectAdmin

¿Por qué subir un módulo de PrestaShop manualmente desde DirectAdmin?

Si alguna vez has intentado instalar módulo PrestaShop desde el panel de administración y te has encontrado con errores, límites de tamaño o problemas de permisos, la subida manual es tu mejor aliada. Este método te da control total sobre el proceso y es especialmente útil cuando el módulo pesa más de lo permitido por tu configuración de PHP o cuando el propio módulo da problemas de instalación.

En este artículo te voy a guiar paso a paso para que aprendas a subir módulo PrestaShop desde DirectAdmin, el panel de control que usamos en nuestros servidores. No necesitas ser un experto técnico: solo sigue las instrucciones y en menos de 15 minutos tendrás tu módulo funcionando.

Requisitos previos antes de empezar

Antes de lanzarnos a la acción, asegúrate de tener lo siguiente:

Acceso a DirectAdmin con credenciales de tu cuenta de hosting.
El archivo del módulo en formato .zip o .tar.gz descargado en tu ordenador.
Un cliente FTP o el propio administrador de archivos de DirectAdmin (usaremos este último, es más sencillo).
Tu tienda PrestaShop funcionando y con acceso al panel de administración.

[!TIP]
Si tu módulo viene en formato .zip, no lo descomprimas en tu ordenador. Lo subiremos tal cual y lo descomprimiremos en el servidor. Esto evita problemas de permisos y estructura de carpetas.

Paso 1: Accede a DirectAdmin y localiza tu tienda

Lo primero es entrar en DirectAdmin. Normalmente accedes a través de una URL como https://tu-dominio.com:2222 o la dirección que te hayan proporcionado. Introduce tu usuario y contraseña.

Una vez dentro, busca la sección Administrador de archivos (File Manager). En la mayoría de instalaciones de DirectAdmin, la encontrarás en el menú principal o en la sección de "Herramientas".

Navega hasta la carpeta donde está instalada tu tienda PrestaShop. Normalmente será public_html o una subcarpeta como public_html/tienda o public_html/prestashop. Si no estás seguro, busca el archivo config/settings.inc.php (en PrestaShop 1.6) o app/config/parameters.php (en PrestaShop 1.7 y 8).

Paso 2: Localiza la carpeta de módulos

Dentro de la raíz de tu PrestaShop, busca la carpeta llamada modules. Es una de las carpetas principales de la instalación. Ábrela.

[!INFO]
En PrestaShop, todos los módulos se instalan en la carpeta /modules. Cada módulo debe tener su propia subcarpeta con el nombre técnico del módulo (por ejemplo, ps_googleanalytics, blockcart, etc.). No los mezcles nunca.

Paso 3: Sube el archivo comprimido del módulo

Ahora vamos a subir módulo PrestaShop desde DirectAdmin. Dentro de la carpeta modules, busca el botón Subir (Upload) en la barra de herramientas del administrador de archivos.

Selecciona el archivo .zip o .tar.gz de tu módulo desde tu ordenador y súbelo. Espera a que la barra de progreso llegue al 100%. Dependiendo del tamaño del archivo, puede tardar unos segundos o unos minutos.

[!WARNING]
No subas el archivo a la raíz de PrestaShop ni a ninguna otra carpeta. Tiene que estar dentro de modules. Si lo subes a otro sitio, el módulo no se reconocerá.

Paso 4: Descomprime el archivo en el servidor

Una vez subido, verás el archivo comprimido dentro de la carpeta modules. Ahora debes descomprimirlo. Haz clic derecho sobre el archivo y selecciona la opción Extraer (Extract) o Descomprimir.

DirectAdmin te preguntará dónde quieres extraer los archivos. Asegúrate de que la ruta sea la carpeta modules actual. Haz clic en "Extraer" o "Extract" y espera a que termine.

[!TIP]
Si tu módulo viene en formato .tar.gz y DirectAdmin no lo reconoce, primero cámbiale el nombre a .tgz o inténtalo con un archivo .zip. La mayoría de módulos comerciales se distribuyen en ambos formatos.

Paso 5: Verifica la estructura de carpetas

Después de descomprimir, deberías ver una nueva carpeta dentro de modules con el nombre del módulo. Por ejemplo, si tu módulo se llama "MiMódulo", la ruta sería modules/mimodulo.

Entra en esa carpeta y verifica que contiene al menos los siguientes elementos:

Un archivo principal de PHP con el mismo nombre de la carpeta (ejemplo: mimodulo.php).
Una carpeta config.xml o config (en módulos más modernos).
Carpetas como views, controllers, classes o translations dependiendo de la complejidad del módulo.

Si ves que el módulo creó una estructura anidada (por ejemplo, modules/mimodulo/mimodulo), significa que el zip contenía una carpeta padre. En ese caso, mueve el contenido al nivel correcto.

[!WARNING]
Una estructura incorrecta es la causa más común de errores al instalar módulo PrestaShop. Si la ruta no es exactamente modules/nombre_modulo/nombre_modulo.php, el sistema no lo detectará. Corrige esto antes de continuar.

Paso 6: Ajusta los permisos de la carpeta del módulo

Este es uno de los pasos más críticos y donde más errores se cometen. PrestaShop necesita permisos de lectura y escritura en la carpeta del módulo para poder instalarlo y configurarlo correctamente.

En DirectAdmin, selecciona la carpeta del módulo recién creada y haz clic en Permisos (Permissions) o Cambiar permisos. Verás una ventana con casillas para asignar permisos.

Establece los siguientes valores:

Propietario (Owner): Lectura, Escritura y Ejecución (7)
Grupo (Group): Lectura y Ejecución (5)
Público (Public): Lectura y Ejecución (5)

Esto se traduce en el valor numérico 755 para carpetas. Para los archivos dentro de la carpeta, usa 644 (lectura y escritura para el propietario, lectura para grupo y público).

[!INFO]
Los permisos carpeta PrestaShop correctos son fundamentales. Si pones 777 (todos los permisos), podrías tener problemas de seguridad. Si pones 555, PrestaShop no podrá escribir archivos de configuración. El 755 es el estándar recomendado.

Paso 7: Instala el módulo desde el panel de administración

Ahora viene la parte fácil. Ve al panel de administración de tu PrestaShop (normalmente en tu-dominio.com/admin).

Navega hasta Módulos → Módulos y Servicios. En la lista de módulos, busca el que acabas de subir. Si todo ha ido bien, debería aparecer en la lista con su nombre y versión.

Haz clic en el botón Instalar (o "Instalar" en la versión de tu PrestaShop). PrestaShop te pedirá confirmación y luego instalará el módulo.

Si el módulo requiere configuración adicional, te aparecerá un enlace "Configurar" después de la instalación. Haz clic en él y completa los ajustes necesarios.

[!TIP]
Si el módulo no aparece en la lista, revisa los pasos anteriores. Los errores más comunes son: permisos incorrectos, estructura de carpetas mal creada o conflicto de nombres. También puedes probar a limpiar la caché de PrestaShop desde Parámetros avanzados → Rendimiento → Vaciar caché.

Paso 8: Verifica que el módulo funciona correctamente

Una vez instalado, es hora de probarlo. Ve a la página de configuración del módulo y ajusta las opciones según tus necesidades.

Después, realiza una prueba en tu tienda para asegurarte de que todo funciona. Por ejemplo, si es un módulo de envío, haz un pedido de prueba; si es de pago, prueba el proceso de checkout.

[!WARNING]
No olvides vaciar la caché de PrestaShop después de instalar cualquier módulo. A veces los archivos cacheados pueden dar errores visuales o de funcionamiento. Ve a Parámetros avanzados → Rendimiento y haz clic en "Vaciar caché".

Solución de problemas comunes

El módulo no aparece en la lista

Si después de subir el módulo no aparece en el panel de administración, revisa:

Que la carpeta del módulo esté en modules/ con el nombre correcto.
Que el archivo principal tenga el mismo nombre que la carpeta.
Que los permisos carpeta PrestaShop sean 755.
Que el archivo .zip no estuviera corrupto. Descárgalo de nuevo e inténtalo.

Error de "No se puede instalar el módulo"

Este error suele estar relacionado con:

La versión de PrestaShop no es compatible con el módulo.
Faltan dependencias (otros módulos o librerías).
El módulo requiere una versión específica de PHP.

Revisa la documentación del módulo y los requisitos del servidor.

Error de escritura en la carpeta

Si PrestaShop te dice que no puede escribir en la carpeta del módulo, es un problema de permisos. Vuelve a verificar que la carpeta tenga 755 y los archivos 644.

[!INFO]
En algunos casos, el propietario de los archivos debe ser el mismo que el usuario del servidor. Si usas FTP, asegúrate de que los archivos pertenecen al usuario correcto. En DirectAdmin, esto suele estar bien por defecto.

Preguntas frecuentes (FAQ)

¿Puedo instalar módulos desde el panel de administración en lugar de DirectAdmin?

Sí, pero a veces falla por límites de tamaño de archivo o por problemas de conexión. La subida manual desde DirectAdmin es mucho más fiable y te permite controlar cada paso.

¿Qué hago si el módulo viene en formato .tar.gz?

DirectAdmin puede descomprimir tanto .zip como .tar.gz. Si tienes problemas, conviértelo a .zip en tu ordenador con cualquier programa de compresión.

¿Los permisos 777 son seguros?

No. Aunque algunos tutoriales lo recomiendan, los permisos carpeta PrestaShop 777 permiten que cualquier usuario del servidor escriba en esa carpeta, lo cual es un riesgo de seguridad. Usa siempre 755.

¿Puedo borrar el archivo comprimido después de descomprimirlo?

Sí, una vez descomprimido y verificado que el módulo funciona, puedes eliminar el archivo .zip para mantener tu servidor limpio.

¿Cómo actualizo un módulo que ya tengo instalado?

El proceso es el mismo: sube la nueva versión a la carpeta modules/nombre_modulo reemplazando los archivos antiguos. Luego, desde el panel de administración, busca el módulo y haz clic en "Actualizar" o "Reinstalar".

Conclusión

Aprender a instalar módulo PrestaShop desde DirectAdmin es una habilidad esencial para cualquier propietario de tienda online. Aunque al principio pueda parecer complicado, con la práctica se convierte en un proceso rápido y sencillo.

Recuerda los puntos clave:

Siempre sube el archivo comprimido a la carpeta modules.
Descomprime y verifica la estructura de carpetas.
Ajusta los permisos carpeta PrestaShop a 755.
Instala desde el panel de administración y vacía la caché.

Con este método, podrás instalar cualquier módulo sin depender de los límites del servidor ni de los errores del panel de administración. Y si te encuentras con problemas, ya sabes que la mayoría tienen solución revisando los permisos y la estructura de carpetas.

¿Te ha resultado útil esta guía? Si tienes alguna duda o sugerencia, no dudes en dejar un comentario. ¡Buena suerte con tu tienda!