¿Cómo añadir un módulo en PrestaShop desde cPanel?

¿Alguna vez te has encontrado con la necesidad de ampliar las funciones de tu tienda online en PrestaShop y no sabías por dónde empezar? Añadir un módulo es una de las tareas más comunes y, aunque suene técnico, con las herramientas adecuadas (como cPanel) es más sencillo de lo que piensas. En esta guía te explicaré paso a paso cómo instalar módulo PrestaShop desde el panel de control de tu hosting, resolviendo las dudas más frecuentes y dándote consejos para que no te pierdas en el camino.

¿Qué es cPanel y por qué lo necesitas para añadir un módulo?

cPanel es el panel de control que la mayoría de los proveedores de hosting ofrecen para gestionar tu sitio web. Desde aquí puedes subir archivos, crear bases de datos, administrar correos electrónicos y, por supuesto, añadir plugin PrestaShop manualmente si el módulo no se instala directamente desde el backoffice de tu tienda.

A veces, los módulos no aparecen en el mercado oficial de PrestaShop o necesitas una versión personalizada. En esos casos, la instalación manual desde cPanel es la solución ideal. No te preocupes, no necesitas ser un experto en programación; solo seguir estos pasos con cuidado.

Requisitos previos antes de empezar

Antes de lanzarte a instalar módulo PrestaShop, asegúrate de tener lo siguiente:

• Acceso a cPanel (usuario y contraseña que te proporcionó tu hosting).
• El archivo del módulo en formato .zip o .tar.gz. Normalmente lo descargas desde la web del desarrollador o del marketplace.
• Una copia de seguridad de tu tienda (por si algo sale mal, siempre es mejor prevenir).
• Conexión estable a internet.

[WARNING] Nunca descargues módulos de fuentes no oficiales. Pueden contener malware o vulnerabilidades que comprometan tu tienda.

Paso 1: Acceder a cPanel y localizar el gestor de archivos

El primer paso es entrar a tu cPanel. Normalmente lo haces escribiendo en tu navegador algo como tudominio.com/cpanel o tudominio.com:2083. Si no estás seguro, consulta con tu proveedor de hosting.

Una vez dentro, busca la sección Archivos y haz clic en Administrador de archivos (File Manager). Se abrirá una ventana con la estructura de carpetas de tu sitio.

Paso 2: Navegar hasta la carpeta de módulos de PrestaShop

Dentro del Administrador de archivos, busca la carpeta donde está instalado PrestaShop. Normalmente se llama public_html o www. Si tienes varios sitios, puede estar dentro de una subcarpeta como public_html/mitienda.

Dentro de la raíz de tu PrestaShop, localiza la carpeta modules. Esta carpeta contiene todos los módulos instalados. Es importante que no la confundas con otras carpetas como themes o override.

[TIP] Si no ves la carpeta modules, asegúrate de que estás en la raíz de PrestaShop (donde están archivos como index.php y config/).

Paso 3: Subir el archivo del módulo

Ahora viene la parte clave para añadir plugin PrestaShop. Sigue estos pasos:

1. Haz clic en Subir (Upload) en la barra de herramientas del Administrador de archivos.
2. Se abrirá una ventana. Selecciona el archivo .zip del módulo que descargaste.
3. Espera a que la subida termine (verás una barra de progreso).
4. Una vez subido, cierra la ventana de subida.

Verás el archivo .zip en la carpeta actual. Pero no lo dejes así: hay que extraerlo.

Paso 4: Extraer el contenido del módulo

Selecciona el archivo .zip que acabas de subir (marca la casilla junto a él) y haz clic en Extraer (Extract). Aparecerá una ventana preguntándote dónde extraerlo. Por defecto, se extraerá en la misma carpeta (modules). Confirma y listo.

Después de la extracción, verás una nueva carpeta con el nombre del módulo (por ejemplo, micodigomodulo). Esa carpeta debe contener archivos como index.php, micodigomodulo.php, etc.

[INFO] Si el módulo viene en formato .tar.gz, el proceso es similar: súbelo y luego usa la opción Extraer (algunos paneles permiten extraer ambos formatos).

Paso 5: Verificar la instalación desde el backoffice de PrestaShop

Ahora que el módulo está físicamente en tu servidor, toca activarlo desde el panel de administración de tu tienda.

1. Accede a tu backoffice de PrestaShop (normalmente tudominio.com/admin).
2. Ve al menú Módulos > Gestor de módulos (o Módulos y servicios).
3. En la lista de módulos (a veces tienes que buscar en la pestaña "Módulos instalados" o "Módulos no instalados"), busca el nombre del módulo que acabas de subir.
4. Si aparece, haz clic en Instalar (o Activar). Si no aparece, prueba a refrescar la página o escribir el nombre en el buscador.
5. Sigue las instrucciones de configuración si las hay (algunos módulos piden clave de licencia o ajustes).

¡Y ya está! El módulo debería estar funcionando.

Posibles problemas y cómo solucionarlos

A veces, aunque hayas seguido todos los pasos, algo falla. Aquí tienes los errores más comunes y sus soluciones.

El módulo no aparece en el backoffice

Revisa que la carpeta del módulo esté dentro de modules y que tenga los archivos correctos (especialmente el archivo principal con el nombre de la carpeta y extensión .php). También verifica que los permisos de la carpeta sean 755 y los archivos 644. Puedes cambiarlos desde el Administrador de archivos haciendo clic derecho > Cambiar permisos.

Error de compatibilidad de versión

Algunos módulos no son compatibles con tu versión de PrestaShop. Revisa la documentación del módulo o contacta al desarrollador. Puedes intentar forzar la instalación editando el archivo config.xml del módulo, pero no lo recomiendo si no sabes lo que haces.

El módulo da error 500 o pantalla en blanco

Esto suele ocurrir por conflictos con otros módulos o temas. Prueba a desactivar otros módulos temporalmente o cambia al tema predeterminado (por ejemplo, Classic) para ver si el problema persiste. Si el error sigue, revisa los logs de error de tu servidor (desde cPanel > Registros de errores).

Preguntas frecuentes sobre módulos PrestaShop cPanel

Aquí respondo las dudas que más me llegan como técnico de soporte.

¿Puedo instalar un módulo sin usar cPanel?

Sí, desde el backoffice de PrestaShop puedes subir el archivo .zip directamente en Módulos > Gestor de módulos > Subir un módulo. Pero a veces falla por límites de tamaño de archivo o permisos. cPanel es más fiable.

¿Necesito conocimientos técnicos para usar cPanel?

No, con esta guía es suficiente. Solo debes tener cuidado de no borrar archivos importantes. Si te sientes inseguro, pide ayuda a tu hosting.

¿Qué hago si el módulo no se extrae correctamente?

Prueba a descargar de nuevo el archivo, ya que puede estar corrupto. También verifica que tu cPanel tenga suficiente espacio en disco.

¿Los módulos gratuitos son seguros?

No todos. Descarga solo de fuentes confiables como el marketplace oficial de PrestaShop o desarrolladores reconocidos. Los módulos de sitios de dudosa procedencia pueden infectar tu tienda.

Consejos adicionales para gestionar módulos PrestaShop cPanel

• Mantén una copia de seguridad: Antes de instalar cualquier módulo, respalda tu base de datos y archivos. Puedes hacerlo desde cPanel en la sección Copias de seguridad.
• Actualiza los módulos: Revisa periódicamente si hay nuevas versiones. Los módulos desactualizados pueden ser un agujero de seguridad.
• Elimina módulos no utilizados: Si tienes muchos módulos inactivos, tu tienda puede volverse lenta. Desde cPanel, puedes borrar la carpeta del módulo en modules (siempre que no lo necesites).

[TIP] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el proceso es similar, pero accedes por el puerto 2106. Busca la sección de Archivos y sigue los mismos pasos.

Conclusión

Instalar módulo PrestaShop desde cPanel es un proceso sencillo una vez que conoces los pasos: acceder al Administrador de archivos, subir el módulo, extraerlo en la carpeta modules y activarlo desde el backoffice. No temas equivocarte; con una copia de seguridad previa, cualquier error tiene solución.

Ahora que ya sabes cómo añadir plugin PrestaShop manualmente, puedes ampliar las funcionalidades de tu tienda sin depender de terceros. Recuerda siempre elegir módulos de calidad y mantener tu PrestaShop actualizado.

Si te surge alguna duda, no dudes en consultar la documentación oficial de PrestaShop o contactar con el soporte de tu hosting. ¡Buena suerte con tu tienda online!