Instalar plugin en PrestaShop desde cPanel – Guía fácil

Instalar un plugin, también conocido como módulo, en tu tienda online con PrestaShop es una de las tareas más comunes para añadir funcionalidades como pasarelas de pago, plantillas, herramientas de SEO o mejoras en el carrito de compras. Aunque el propio PrestaShop tiene un gestor de módulos, a veces es necesario hacerlo manualmente, especialmente si descargas el archivo .zip desde un proveedor externo. Aquí es donde entra cPanel, el panel de control de tu hosting.

Este proceso, aunque suene técnico, es muy sencillo si sigues los pasos adecuados. En este artículo te guiaré paso a paso para que puedas instalar un plugin en PrestaShop desde cPanel, sin complicaciones y sin necesidad de ser un experto en programación.

[INFO] Antes de empezar, asegúrate de tener a mano los datos de acceso a tu cPanel (usuario y contraseña) y el archivo del módulo PrestaShop que quieres instalar, normalmente en formato .zip.

¿Por qué instalar un módulo desde cPanel?

Aunque PrestaShop tiene un instalador automático desde el back office (tu panel de administración), hay casos en los que esta opción falla. Por ejemplo, cuando el archivo del módulo es demasiado grande, el servidor tiene límites de subida muy bajos, o el módulo requiere permisos especiales en carpetas. Usar cPanel te da control total sobre los archivos de tu tienda online y te permite solucionar estos problemas.

Además, si tu hosting usa Syspanel (el panel de control basado en HestiaCP, accesible por el puerto 2106), los pasos serán muy similares, aunque en este artículo nos centraremos en cPanel, el más extendido.

Requisitos previos

Antes de comenzar, verifica que cumples con lo siguiente:

Acceso a cPanel (usuario y contraseña, o acceso a través de tu hosting).
Archivo del módulo en formato .zip (descargado de un desarrollador o del marketplace de PrestaShop).
Conocimientos básicos de navegación en el panel de control.
Conexión a Internet estable.

[WARNING] Asegúrate de que el módulo sea compatible con tu versión de PrestaShop. Si no lo es, podrías romper tu tienda. Consulta la documentación del plugin.

Pasos para instalar un plugin en PrestaShop desde cPanel

1. Accede a tu cPanel

Abre tu navegador y escribe la dirección de tu cPanel. Normalmente es algo como https://tudominio.com/cpanel o https://tudominio.com:2083. Si no lo sabes, consulta el correo de bienvenida de tu hosting.

Introduce tu usuario y contraseña. Una vez dentro, verás un panel con muchos iconos. No te preocupes, solo necesitaremos unos pocos.

2. Localiza el gestor de archivos (File Manager)

Dentro de cPanel, busca el icono de Administrador de archivos (File Manager). Suele aparecer en la sección "Archivos". Haz clic en él.

Se abrirá una ventana que te muestra la estructura de carpetas de tu hosting. Normalmente, la carpeta principal de tu tienda online está en public_html o en una subcarpeta si tienes varios dominios.

3. Navega hasta la carpeta de módulos de PrestaShop

Dentro de la carpeta de tu tienda (por ejemplo, public_html si PrestaShop está en la raíz), busca la carpeta modules. La ruta típica es:

public_html/modules

Esta carpeta contiene todos los módulos instalados en tu PrestaShop. No la confundas con themes u otras carpetas.

4. Sube el archivo del módulo

Ahora viene la parte clave. En la parte superior del File Manager, verás un botón que dice Subir (Upload). Haz clic en él.

Se abrirá una ventana donde puedes seleccionar el archivo .zip de tu módulo PrestaShop. Arrástralo o búscalo en tu computadora. Espera a que termine la subida (verás una barra de progreso).

[TIP] Si el archivo es muy grande, asegúrate de que tu servidor no tenga límite de subida. Si falla, puedes subir el .zip por FTP o usar la opción "Copiar" en el File Manager.

5. Descomprime el archivo .zip

Una vez subido, el archivo aparecerá en la carpeta modules. Ahora debes descomprimirlo. Haz clic derecho sobre el archivo .zip y selecciona Extraer (Extract). En la ventana que aparece, asegúrate de que la ruta de destino sea la misma carpeta modules y haz clic en Extraer archivos.

El sistema creará una nueva carpeta con el nombre del módulo (por ejemplo, micodigo) dentro de modules. No cierres la ventana todavía.

6. Verifica los permisos de la carpeta (opcional pero recomendado)

A veces, los módulos requieren permisos de escritura para funcionar correctamente. Para asegurarte, haz clic derecho sobre la carpeta del módulo recién creada y selecciona Permisos (Permissions). Cambia los valores a 755 (para carpetas) o 644 (para archivos). Esto es seguro y común en la mayoría de los casos.

[INFO] Si tu módulo necesita permisos 777, el desarrollador lo indicará. Normalmente no es necesario y puede ser un riesgo de seguridad.

7. Instala el módulo desde el back office de PrestaShop

Ahora vuelve a tu panel de administración de PrestaShop (por ejemplo, tudominio.com/admin1234). Ve a Módulos > Gestor de módulos (o Módulos y servicios en versiones antiguas).

En la parte superior, verás un botón que dice Subir un módulo (Upload a module). Haz clic en él y selecciona el archivo .zip que subiste (sí, otra vez). Pero espera, en realidad no necesitas subirlo de nuevo porque ya está en la carpeta. En versiones recientes de PrestaShop, el sistema detecta automáticamente los módulos presentes en la carpeta modules.

Si no aparece, puedes buscar el módulo en la lista de módulos instalados (a veces aparece como "no instalado"). Busca el nombre de tu módulo y haz clic en Instalar.

8. Configura el módulo

Una vez instalado, verás el módulo en la lista con un botón de Configurar. Haz clic en él para ajustar sus opciones (como claves de API, imágenes, etc.). Cada módulo es diferente, así que sigue las instrucciones del desarrollador.

Solución de problemas comunes

El módulo no aparece en el back office

Esto puede pasar si el nombre de la carpeta del módulo no coincide con el nombre del archivo principal (normalmente index.php o nombre_modulo.php). Revisa que la carpeta esté bien descomprimida y que contenga un archivo con el mismo nombre de la carpeta.

Error de permisos

Si al instalar ves un mensaje de error sobre permisos, vuelve a cPanel y verifica que la carpeta modules y la subcarpeta del módulo tengan permisos 755. También puedes probar con 777 temporalmente, pero no lo dejes así.

El módulo no funciona después de instalarlo

Prueba a desactivar y volver a activar el módulo desde el back office. Si el problema persiste, revisa los logs de errores de PrestaShop (en Configuración avanzada > Logs) o contacta al desarrollador.

Preguntas frecuentes (FAQ)

¿Puedo instalar un módulo desde el back office sin usar cPanel?

Sí, pero a veces falla por límites de tamaño. Usar cPanel es más fiable para archivos grandes.

¿Qué hago si mi hosting usa Syspanel en lugar de cPanel?

Si tu panel es Syspanel (basado en HestiaCP), el proceso es similar. Accede a través del puerto 2106 (ejemplo: tudominio.com:2106), luego ve a Archivos > Administrador de archivos y sigue los mismos pasos desde la carpeta public_html/modules.

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

Revisa la descripción del módulo o la documentación. Normalmente indican las versiones compatibles (ejemplo: "1.7.x" o "8.x"). Si no estás seguro, consulta al desarrollador.

¿Se puede instalar un módulo desde cPanel sin descomprimir?

No, PrestaShop necesita los archivos sueltos. Pero puedes subir el .zip y descomprimirlo directamente en el File Manager, como hicimos aquí.

Consejos finales

Haz una copia de seguridad de tu tienda antes de instalar cualquier módulo, especialmente si es crítico. Puedes hacerlo desde cPanel (en la sección Copias de seguridad) o con un plugin de backup.
Prueba el módulo en un entorno de desarrollo si es posible, para evitar sorpresas en tu tienda en vivo.
Mantén actualizado tu PrestaShop y los módulos para evitar problemas de seguridad.

Instalar un plugin en PrestaShop desde cPanel es una habilidad muy útil que te da más control sobre tu tienda online. Una vez que lo hagas una o dos veces, verás que es pan comido. Si tienes dudas, recuerda que siempre puedes pedir ayuda a tu hosting o a la comunidad de PrestaShop.

¡Ahora ya puedes ampliar las funcionalidades de tu tienda sin miedo!