Instalar módulos PrestaShop manualmente en cualquier panel

¿Cansado de buscar módulos en el marketplace de PrestaShop y encontrarte con que no puedes instalarlos directamente desde el back office? No te preocupes, es más común de lo que crees. A veces, por restricciones del servidor, límites de tamaño de archivo o simplemente porque el módulo viene en un archivo ZIP descargado de otro sitio, necesitas hacerlo a mano.

En esta guía extensa y paso a paso, te voy a enseñar cómo instalar módulos PrestaShop manual usando los paneles de control más habituales: cPanel, Plesk, DirectAdmin y Syspanel (antes HestiaCP). Además, incluiremos trucos y respuestas a preguntas frecuentes para que no te quede ninguna duda.

Vamos a ello.

¿Por qué instalar módulos manualmente?

Antes de meternos en faena, es bueno que sepas por qué a veces toca ensuciarse las manos. La instalación manual, también conocida como subir módulo PrestaShop por FTP o por el administrador de archivos del panel, es la solución cuando:

El módulo es demasiado pesado para la subida por el back office (límite de upload_max_filesize).
El servidor tiene problemas de permisos o tiempo de ejecución.
Tienes un módulo personalizado o comprado en un sitio externo que no está en el marketplace oficial.
El back office se queda en “cargando” o da error 500 al intentar la instalación automática.

Además, es un proceso seguro si se hace bien. Al fin y al cabo, solo estás copiando archivos a la carpeta correcta.

Requisitos previos antes de empezar

Para hacer una instalación de módulos PrestaShop manual con éxito, necesitas tres cosas básicas:

El archivo ZIP del módulo: Asegúrate de que es un archivo comprimido válido y que contiene una carpeta con el nombre técnico del módulo (ej: ps_googleanalytics, mipersonalizado, etc.).
Acceso al panel de control de tu hosting: Ya sea cPanel, Plesk, DirectAdmin o Syspanel.
Las credenciales de FTP o del administrador de archivos: Las mismas que usas para acceder a tu hosting.

[WARNING] Nunca descomprimas el ZIP en tu ordenador y subas archivos sueltos. Siempre debes subir el ZIP entero o, mejor aún, descomprimir directamente en el servidor.

Método 1: Instalar módulos en PrestaShop con cPanel

cPanel es el panel más popular del mundo. Si tu hosting tiene este panel, el proceso es muy sencillo gracias al Administrador de Archivos.

Paso 1: Accede al Administrador de Archivos

Entra a tu cPanel (normalmente tudominio.com/cpanel). Busca la sección Archivos y haz clic en Administrador de Archivos.

Paso 2: Navega hasta la carpeta de módulos

Dentro del administrador, localiza la carpeta raíz de tu tienda PrestaShop. Normalmente es public_html o www. Dentro de ella, busca la carpeta:

/modules

Esa carpeta contiene todas las carpetas de los módulos instalados. No entres en ninguna carpeta existente, solo quédate en la raíz de /modules.

Paso 3: Sube el archivo ZIP

Arriba a la izquierda, verás un botón Subir. Haz clic y selecciona el archivo ZIP de tu módulo desde tu ordenador. Espera a que termine la subida (verás una barra de progreso).

Paso 4: Descomprime el ZIP

Una vez subido, el archivo aparecerá en la lista de archivos de la carpeta /modules. Haz clic derecho sobre el archivo ZIP y selecciona Extraer (o Extract). Se abrirá una ventana; déjalo todo por defecto y haz clic en Extraer archivos.

Paso 5: Verifica la carpeta

Después de extraer, deberías ver una nueva carpeta con el nombre del módulo (ej: micodigomodulo). Si ves eso, el archivo se ha descomprimido correctamente. Ya puedes borrar el archivo ZIP para mantener el orden.

Paso 6: Instala desde el back office

Ahora ve al back office de tu PrestaShop (normalmente tudominio.com/adminXXXX). Ve a Módulos → Gestor de módulos y busca el nombre del módulo que acabas de subir. Debería aparecer listo para instalar. Haz clic en Instalar.

[TIP] Si no aparece, prueba a recargar la página o limpiar la caché de PrestaShop desde Parámetros de la tienda → Rendimiento → Forzar compilación.

Método 2: Instalar módulos en PrestaShop con Plesk

Plesk es otro panel muy usado, sobre todo en servidores Windows y algunos Linux. El proceso es similar, pero con su propio administrador de archivos.

Paso 1: Abre el Administrador de Archivos de Plesk

Desde el panel de Plesk, busca en el menú de la izquierda la opción Sitios web y dominios. Luego, sobre el dominio de tu tienda, haz clic en Administrador de archivos.

Paso 2: Localiza la carpeta de módulos

Navega hasta la carpeta httpdocs (o public_html) y luego entra en modules. Si no ves la carpeta modules, puede que esté dentro de httpdocs/modules.

Paso 3: Sube el ZIP

En la barra superior del administrador de archivos, haz clic en Subir archivos. Selecciona tu ZIP y súbelo. Una vez subido, aparecerá en la lista.

Paso 4: Descomprime

Selecciona el archivo ZIP (marca la casilla) y en la barra de herramientas elige Extraer archivos. Plesk te preguntará dónde extraerlo; asegúrate de que sea en la carpeta actual (/modules o /httpdocs/modules).

Paso 5: Instalación final

Igual que en cPanel, ahora ve al back office de PrestaShop y activa el módulo desde el gestor de módulos.

Método 3: Instalar módulos en PrestaShop con DirectAdmin

DirectAdmin es un panel más ligero pero igual de funcional. Aquí usaremos el Administrador de Archivos que viene integrado.

Paso 1: Entra al Administrador de Archivos

Desde el panel de DirectAdmin, busca el icono o enlace de Administrador de Archivos. Te pedirá que selecciones un dominio; elige el de tu tienda.

Paso 2: Ve a la carpeta correcta

DirectAdmin te mostrará la estructura de archivos. Busca la carpeta public_html (o domains/tudominio.com/public_html). Dentro, localiza la carpeta modules.

Paso 3: Sube el archivo

Arriba a la derecha, haz clic en Subir archivos. Selecciona tu ZIP. Después de subirlo, aparecerá en la lista.

Paso 4: Descomprime

Selecciona el archivo ZIP y haz clic en Extraer (o Extract). DirectAdmin te preguntará la ruta de destino; déjala como está (la carpeta actual). Haz clic en Extraer.

Paso 5: Activa el módulo

Ya sabes el ritual: ve al back office de PrestaShop, busca el módulo y dale a instalar.

Método 4: Instalar módulos en PrestaShop con Syspanel (HestiaCP)

Syspanel es una versión moderna y sencilla de HestiaCP. Si tu hosting usa Syspanel, el proceso es igual de rápido. Recuerda que el acceso a Syspanel suele ser por el puerto 2106 (ej: tudominio.com:2106).

Paso 1: Accede a Syspanel

Escribe en tu navegador https://tudominio.com:2106 e inicia sesión con tus credenciales de hosting.

Paso 2: Busca el Administrador de Archivos

Una vez dentro, verás un listado de tus sitios web. Haz clic en el nombre de tu tienda PrestaShop. En el menú de la izquierda, busca la opción Administrador de archivos (o File Manager).

Paso 3: Navega a la carpeta de módulos

Dentro del administrador, ve a la carpeta public_html (o web). Luego entra en modules.

Paso 4: Sube el ZIP

Haz clic en el botón Subir (normalmente un icono de flecha hacia arriba). Selecciona tu archivo ZIP. Espera a que termine.

Paso 5: Descomprime

Selecciona el archivo ZIP recién subido y haz clic en Extraer. Syspanel te mostrará una vista previa; confirma la extracción.

Paso 6: Instalación final

Ve al back office de PrestaShop y activa el módulo. ¡Listo!

[INFO] Syspanel (basado en HestiaCP) es muy estable para tiendas PrestaShop. Si tienes problemas de permisos, recuerda que la carpeta modules debe tener permisos 755.

Preguntas frecuentes (FAQ)

¿Qué hago si después de subir el módulo no aparece en el back office?

Esto es muy común. Prueba estas soluciones:

Limpia la caché: Ve a Parámetros de la tienda → Rendimiento → Forzar compilación y limpia la caché.
Verifica la carpeta: Asegúrate de que dentro de /modules hay una carpeta con el nombre exacto del módulo (sin espacios, sin mayúsculas extrañas). A veces el ZIP crea una carpeta doble (ej: modulo/modulo/). Si es así, mueve los archivos a la carpeta correcta.
Permisos: La carpeta del módulo debe tener permisos 755 y los archivos 644. Si no, desde el administrador de archivos puedes cambiarlos.

¿Puedo instalar un módulo directamente desde el ZIP sin descomprimir?

Sí, pero no es recomendable. PrestaShop espera que los archivos estén sueltos en la carpeta. Si subes el ZIP sin descomprimir, el sistema no lo reconocerá. Siempre descomprime.

¿Es seguro este método?

Sí, siempre que el módulo provenga de una fuente fiable (el marketplace oficial, un desarrollador de confianza o un sitio reconocido). Al subir archivos manualmente, evitas errores de tiempo de espera del servidor.

¿Qué hago si el módulo da error 500 después de instalarlo?

Desactívalo desde el back office (si puedes entrar) o, si no, renombra la carpeta del módulo desde el administrador de archivos (por ejemplo, añadiendo _old al final). Esto lo desactivará automáticamente. Luego contacta con el desarrollador del módulo.

¿Puedo usar FTP en lugar del administrador de archivos?

¡Claro! Si te sientes más cómodo con FTP (FileZilla, Cyberduck), el proceso es el mismo: conéctate al servidor, navega a public_html/modules, sube el ZIP y descomprímelo desde el panel o desde el propio FTP (algunos clientes permiten extraer ZIPs). El administrador de archivos es más visual y evita errores.

Conclusión

Como has visto, cómo instalar módulos PrestaShop manual no es nada del otro mundo. Ya sea con cPanel, Plesk, DirectAdmin o Syspanel, el proceso se reduce a:

Subir el ZIP a la carpeta /modules.
Descomprimirlo.
Ir al back office e instalar.

Este método te da control total y soluciona la mayoría de los problemas de instalación automática. Además, es una habilidad básica que todo administrador de tiendas PrestaShop debería dominar.

Ahora ya sabes exactamente cómo hacer una instalación de módulos PrestaShop manual en cualquier panel. Si te ha quedado alguna duda, repasa los pasos o escribe en los comentarios (si los hay). ¡Buena suerte con tu tienda!