Instalar módulos PrestaShop desde cPanel: guía práctica

¿Necesitas ampliar las capacidades de tu tienda online y no sabes cómo añadir nuevas funcionalidades? Instalar módulos en PrestaShop es una de las tareas más comunes para cualquier administrador, pero cuando el proceso se hace desde el panel de control de tu hosting (cPanel), puede parecer un poco técnico. No te preocupes, aquí te guiaré paso a paso, con un lenguaje claro y sencillo, para que puedas instalar módulos PrestaShop cPanel de forma manual y segura, y luego configurarlos para que tu tienda vuele.

¿Qué necesitas antes de empezar?

Antes de lanzarte a la aventura de los módulos, asegúrate de tener todo a mano. No necesitas ser un experto en programación, pero sí es importante que tengas acceso a ciertas herramientas.

Acceso a cPanel

Lo primero es lo primero. Necesitas las credenciales de tu cuenta de hosting. Normalmente, tu proveedor te envía un enlace como https://tudominio.com/cpanel o una IP con puerto específico. Si tu hosting utiliza Syspanel (antes conocido como HestiaCP), recuerda que el acceso es a través del puerto 2106 (ejemplo: https://tudominio.com:2106). Una vez dentro, verás un montón de iconos. No te asustes, solo usaremos unos pocos.

Archivo del módulo (ZIP)

El módulo que quieras instalar debe venir en un archivo comprimido .zip. Normalmente, cuando compras un módulo en un marketplace o en la web del desarrollador, lo descargas directamente. Si es gratuito, también suele ser un zip. Asegúrate de que el archivo no esté dañado y que sea compatible con tu versión de PrestaShop (1.6, 1.7 o 8.x).

Cliente FTP o el Administrador de Archivos de cPanel

Para la instalación manual, necesitarás subir archivos al servidor. Puedes usar un programa FTP como FileZilla, pero si te resulta más cómodo, el Administrador de Archivos de cPanel es perfecto. No necesitas instalar nada extra.

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

Este es el método más directo, pero a veces falla si el módulo es muy pesado o el servidor tiene límites de subida. Si falla, no te preocupes, pasaremos al método manual.

Paso 1: Accede al panel de administración de tu tienda

Entra a tu PrestaShop con tu usuario y contraseña de administrador. La URL suele ser tudominio.com/admin o algo similar.

Paso 2: Ve a la sección de módulos

En el menú lateral izquierdo, busca “Módulos” y luego haz clic en “Módulos y servicios”. Se abrirá una página con todos los módulos instalados.

Paso 3: Sube el módulo

En la parte superior derecha, verás un botón que dice “Subir un módulo”. Haz clic ahí y selecciona el archivo .zip que descargaste. El sistema lo procesará automáticamente.

[TIP] Si el botón no aparece, puede que tu versión de PrestaShop sea muy antigua. En ese caso, actualiza o usa el método manual.

Paso 4: Instalación automática

Una vez subido, PrestaShop lo descomprimirá y te mostrará un mensaje de éxito. Luego, verás el módulo en la lista. Haz clic en “Instalar” (si no se instaló solo) y listo.

Método 2: Instalación manual desde cPanel (el más fiable)

Este método te da control total y funciona siempre, incluso con módulos pesados o servidores restrictivos. Aquí es donde realmente usaremos cPanel.

Paso 1: Descomprime el módulo en tu computadora

Primero, descomprime el archivo .zip que descargaste. Verás una carpeta con el nombre del módulo (por ejemplo, micodigo). Dentro suele haber archivos como index.php, micodigo.php y carpetas como views, controllers, etc.

Paso 2: Accede al Administrador de Archivos de cPanel

Desde tu cPanel, busca el icono “Administrador de Archivos” (File Manager). Ábrelo y te llevará a la raíz de tu hosting. Verás muchas carpetas, pero la que nos interesa es la de tu tienda.

Paso 3: Navega hasta la carpeta de módulos de PrestaShop

Dentro del Administrador de Archivos, busca la carpeta public_html (o www). Ahí estará tu instalación de PrestaShop. Luego, sigue esta ruta:
public_html/modules/

Dentro de modules verás muchas carpetas; cada una es un módulo instalado. Aquí es donde copiaremos el nuestro.

Paso 4: Sube la carpeta del módulo

Arriba a la izquierda, haz clic en “Subir” (Upload). Se abrirá una ventana. Arrastra la carpeta completa que descomprimiste (la que tiene el nombre del módulo) o haz clic para seleccionarla. Espera a que termine la subida.

[WARNING] No subas el archivo .zip directamente. Debes subir la carpeta descomprimida. Si subes el zip, no funcionará.

Paso 5: Verifica que la carpeta esté en la ubicación correcta

Una vez subida, vuelve a la carpeta modules y busca la carpeta con el nombre de tu módulo. Si está ahí, perfecto.

Paso 6: Instala el módulo desde el back office

Ahora ve a tu administración de PrestaShop (como en el método 1). En la lista de módulos, debería aparecer el nuevo (a veces hay que recargar la página). Haz clic en “Instalar” y listo.

Configurar módulos PrestaShop: primeros pasos

Una vez instalado, toca configurarlo. Cada módulo es un mundo, pero hay pautas generales.

Accede a la configuración del módulo

En la misma lista de módulos, verás un botón “Configurar” (o “Configure”) al lado del módulo recién instalado. Haz clic ahí.

Lee las instrucciones del desarrollador

La mayoría de los módulos de pago incluyen una pestaña de “Ayuda” o “Documentación”. No te saltes este paso. Ahí te explicarán campos específicos como API keys, colores, o límites.

Configura los ajustes básicos

Normalmente verás opciones como:

Activar/Desactivar: Asegúrate de que esté en “Sí”.
Posición: Dónde se mostrará (por ejemplo, en el pie de página, en la barra lateral).
Opciones de diseño: Colores, tamaños, etc.

[INFO] Si el módulo no se ve en tu tienda, revisa la posición. A veces hay que asignarlo a un “gancho” (hook) específico, como “displayHome” para la página principal.

Guarda los cambios

Siempre, siempre, haz clic en “Guardar” antes de salir. Si no, perderás todo.

Solución de problemas comunes (FAQ)

El módulo no aparece en la lista después de subirlo manualmente

Esto suele pasar por dos razones:

La carpeta no está en la ruta correcta: Verifica que esté dentro de public_html/modules/ y no en otra carpeta.
El nombre de la carpeta no coincide: Abre el archivo principal del módulo (el que tiene el mismo nombre que la carpeta) y busca la línea name:. A veces el nombre interno es diferente. Renombra la carpeta para que coincida.

Error "El archivo no es un módulo válido" al subir desde el back office

Esto indica que el archivo .zip está corrupto o no es compatible. Prueba a descargarlo de nuevo. Si sigue fallando, usa el método manual desde cPanel, que es más tolerante.

El módulo se instaló pero no funciona

Revisa los logs de error de PrestaShop. Ve a “Parámetros avanzados” > “Información” > “Logs”. Ahí verás errores de PHP. Si el módulo usa funciones obsoletas, puede dar conflicto. Contacta al desarrollador.

¿Cómo desinstalo un módulo?

En la lista de módulos, haz clic en “Desinstalar” y luego confirma. Para borrarlo por completo, ve a cPanel, entra al Administrador de Archivos y elimina la carpeta del módulo dentro de modules.

Consejos finales para mantener tu tienda segura

Siempre haz una copia de seguridad: Antes de instalar cualquier módulo, respalda tu base de datos y archivos desde cPanel (sección “Backup”).
Actualiza los módulos: Los desarrolladores lanzan parches de seguridad. Revisa periódicamente si hay nuevas versiones.
No instales módulos de fuentes desconocidas: Pueden contener malware. Compra solo en marketplaces oficiales o en webs de confianza.
Prueba en un entorno de staging: Si tu hosting lo permite, instala el módulo primero en una copia de tu tienda para ver si no rompe nada.

Conclusión

Instalar y configurar módulos en PrestaShop desde cPanel es más fácil de lo que parece. Con el método manual, tienes el control absoluto y evitas problemas de límites de subida. Recuerda siempre leer la documentación del módulo y, ante cualquier duda, el administrador de archivos de cPanel es tu mejor aliado. Ahora ya puedes ampliar tu tienda con confianza. ¡A vender!