Instalar módulos PrestaShop en cPanel: Tutorial fácil

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

Si alguna vez has intentado instalar un módulo de PrestaShop desde el panel de administración y te ha aparecido un error de permisos, de tamaño de archivo o simplemente el proceso se queda congelado, no estás solo. Es una de las consultas más frecuentes en soporte técnico. La solución pasa por hacerlo manualmente, y para eso necesitas acceder a tu cPanel. Este método es más fiable, no depende de los límites de subida de PHP y te da control total sobre los archivos de tu tienda.

Aunque pueda sonar técnico, te prometo que con esta guía de pasos lo harás sin problemas, incluso si nunca has tocado un administrador de archivos. Vamos a ello.

Antes de empezar: qué necesitas y qué debes saber

Para subir un módulo a PrestaShop desde cPanel, necesitas tres cosas básicas:

Acceso a tu cPanel (te lo proporciona tu proveedor de hosting).
El archivo comprimido del módulo en formato .zip o .tar.gz.
Las credenciales de administrador de tu PrestaShop.

Es importante que sepas que cPanel es la herramienta de gestión de tu hosting, no la de tu tienda. Desde ahí podrás acceder a los archivos de tu sitio web, que es donde viven los módulos. Piensa en cPanel como el almacén de tu tienda, y en el panel de PrestaShop como el escaparate.

[WARNING]
Antes de tocar nada, te recomiendo hacer una copia de seguridad completa de tu tienda. Si algo sale mal, podrás restaurar todo sin perder ventas ni configuraciones. En cPanel, busca la herramienta "Backup" o "Copias de seguridad" dentro de la sección "Archivos".

Paso 1: Descarga el módulo y verifica su formato

Lo primero es tener el módulo en tu ordenador. Si lo has comprado en PrestaShop Addons, inicia sesión en tu cuenta y descarga el archivo. Si es un módulo gratuito de un desarrollador, asegúrate de que el archivo descargado sea un .zip o .tar.gz.

No descomprimas el archivo todavía. PrestaShop necesita el paquete comprimido para poder instalarlo correctamente. Además, revisa que el nombre del archivo no tenga caracteres raros como ñ, tildes o espacios. Si los tiene, renómbralo a algo simple, por ejemplo modulo-pago.zip.

[TIP]
Algunos módulos de PrestaShop Addons vienen en formato .tar.gz. No pasa nada, el proceso de instalación es idéntico al del .zip.

Paso 2: Accede a tu cPanel

Abre tu navegador y escribe la URL de acceso a cPanel. Normalmente suele ser www.tudominio.com/cpanel o https://tu-servidor:2083. Si no estás seguro de cómo acceder, consulta el correo de bienvenida de tu hosting o contacta con tu proveedor.

Introduce tu usuario y contraseña. Una vez dentro, verás un panel con muchos iconos. No te agobies, solo necesitaremos dos: el Administrador de archivos y, en algunos casos, el Administrador de bases de datos (aunque esto último no será necesario para instalar el módulo).

Paso 3: Localiza la carpeta de tu tienda en el Administrador de archivos

Haz clic en el icono de Administrador de archivos. Se abrirá una ventana que te pedirá que selecciones la carpeta raíz. Normalmente, si tienes varios dominios, te dará a elegir entre public_html, www o la carpeta de tu dominio específico. Selecciona la que corresponda a tu tienda.

Dentro, busca la carpeta llamada modules. Es una de las carpetas principales de PrestaShop, junto a config, img, themes, etc. Haz clic derecho sobre la carpeta modules y selecciona "Cargar" (o "Upload" si tu cPanel está en inglés).

Paso 4: Sube el archivo comprimido del módulo

Se abrirá una interfaz de carga de archivos. Arrastra el archivo .zip o .tar.gz que descargaste antes y suéltalo en esa ventana. También puedes usar el botón de seleccionar archivo. Espera a que la subida llegue al 100%. Dependiendo del tamaño del módulo, puede tardar unos segundos o un par de minutos.

[INFO]
Si el módulo es muy grande (más de 100MB), puede que la subida falle. En ese caso, deberías aumentar el límite de subida en la configuración de PHP de cPanel, pero eso es una solución más avanzada que veremos al final del artículo.

Una vez subido, vuelve al Administrador de archivos y verifica que el archivo está dentro de la carpeta modules. Deberías verlo listado junto a otras carpetas y archivos.

Paso 5: Descomprime el archivo dentro de la carpeta modules

Ahora viene el paso clave. Haz clic derecho sobre el archivo que acabas de subir y selecciona "Extraer" (o "Extract"). Se abrirá una ventana preguntándote dónde quieres extraer los archivos. Asegúrate de que la ruta sea exactamente la carpeta modules de tu PrestaShop.

Haz clic en "Extraer archivos" y espera a que termine. Verás que aparece una nueva carpeta con el nombre del módulo. Algunos módulos crean una carpeta con un nombre técnico (ej: ps_googleanalytics), otros con el nombre del desarrollador. Esa carpeta es la que contiene el código del módulo.

[WARNING]
No extraigas el archivo en public_html ni en la raíz de tu dominio. Debe ser obligatoriamente dentro de modules, o PrestaShop no lo reconocerá.

Paso 6: Elimina el archivo comprimido (opcional pero recomendado)

Una vez que hayas extraído el contenido, ya puedes borrar el archivo .zip o .tar.gz de la carpeta modules. No es estrictamente necesario, pero mantener la carpeta limpia evita confusiones y problemas de seguridad. Haz clic derecho sobre el archivo y selecciona "Eliminar".

Paso 7: Ve al panel de administración de PrestaShop e instala el módulo

Ahora abre tu navegador y ve a la URL de administración de tu tienda, normalmente www.tudominio.com/admin o la ruta que configuraste al instalar PrestaShop. Inicia sesión con tu usuario y contraseña.

En el menú lateral izquierdo, busca la sección "Módulos" y haz clic en "Módulos y servicios". Verás una lista de todos los módulos instalados y disponibles. En la parte superior derecha, hay un botón que dice "Subir un módulo" o "Instalar un módulo". Haz clic ahí.

Se abrirá una ventana donde puedes arrastrar el archivo comprimido o seleccionarlo desde tu ordenador. Importante: aquí debes subir el archivo .zip o .tar.gz que tienes en tu ordenador, no el que subiste a cPanel. Sí, es un poco redundante, pero así funciona PrestaShop.

Selecciona el archivo y haz clic en "Subir". PrestaShop lo procesará y te preguntará si deseas instalar el módulo. Haz clic en "Instalar" y espera unos segundos.

Paso 8: Configura el módulo

Una vez instalado, verás el módulo en la lista de módulos instalados. Haz clic en el botón "Configurar" para ajustar las opciones del módulo (API keys, textos, estilos, etc.). Cada módulo es diferente, pero todos tienen una página de configuración accesible desde ahí.

Solución de problemas comunes al instalar módulos desde cPanel

A veces, aunque sigas todos los pasos, algo falla. Aquí tienes las soluciones a los problemas más habituales:

Error: "El módulo no se encontró" o "No se puede instalar"

Esto suele deberse a que la carpeta del módulo no está en el lugar correcto. Revisa que dentro de modules exista la carpeta del módulo y que no esté anidada en otra carpeta (ej: modules/modulo/modulo). Si es así, mueve los archivos a la carpeta correcta.

Error: "Permiso denegado" al subir o extraer archivos

Los permisos de los archivos en cPanel deben ser 755 para carpetas y 644 para archivos. Si al extraer ves que los permisos no son correctos, selecciona la carpeta del módulo, haz clic derecho y elige "Permisos". Cambia los valores a 755.

Error: "El archivo es demasiado grande" al subir desde PrestaShop

Si el módulo supera el límite de subida de PHP (normalmente 8MB o 16MB), verás este error. La solución es hacer la instalación mediante el método de cPanel que ya hemos visto, pero en lugar de subir el archivo desde el panel de PrestaShop, ya lo has extraído en la carpeta modules. En este caso, salta del paso 6 al paso 8 directamente, pero en el panel de administración, en lugar de subir el archivo, busca el módulo en la lista de "Módulos no instalados" y haz clic en "Instalar".

[TIP]
Si el módulo no aparece en la lista de no instalados, ve a "Parámetros avanzados" > "Rendimiento" y haz clic en "Vaciar el caché". A veces PrestaShop no detecta los nuevos archivos hasta que se limpia la caché.

Preguntas frecuentes (FAQ) sobre la instalación de módulos en PrestaShop

¿Puedo instalar un módulo desde cPanel en cualquier plan de hosting?

Sí, siempre que tu hosting te dé acceso a cPanel. Si tu proveedor usa un panel diferente como Plesk o Syspanel, el proceso es similar pero las rutas pueden cambiar. En el caso de Syspanel (antes conocido como HestiaCP), el acceso se realiza por el puerto 2106 y la estructura de archivos es la misma, solo cambia la interfaz.

¿Qué hago si el módulo no es compatible con mi versión de PrestaShop?

PrestaShop te mostrará un mensaje de error indicando la incompatibilidad. En ese caso, contacta con el desarrollador del módulo para pedir una versión compatible o busca una alternativa en PrestaShop Addons.

¿Pierdo los datos del módulo si lo desinstalo?

Depende del módulo. Algunos guardan la configuración en la base de datos, otros no. Si desinstalas el módulo, normalmente se elimina su configuración. Si lo que quieres es actualizarlo, no lo desinstales, simplemente sube la nueva versión encima.

¿Es seguro instalar módulos desde cPanel?

Sí, siempre que el módulo provenga de una fuente confiable como PrestaShop Addons o de un desarrollador de confianza. Al subir archivos manualmente, estás asumiendo la responsabilidad de que el código sea seguro. Por eso, evita módulos piratas o de dudosa procedencia.

Conclusión final

Instalar un módulo de PrestaShop desde cPanel no es complicado, solo requiere un poco de paciencia y seguir los pasos en orden. La clave está en subir el archivo comprimido a la carpeta modules, extraerlo ahí y luego completar la instalación desde el panel de administración.

Recuerda que este método es especialmente útil cuando el módulo es grande o cuando tienes problemas con los permisos de subida de tu servidor. Una vez que lo hagas un par de veces, verás que es un proceso muy mecánico.

Si en algún paso te pierdes, vuelve a leer la sección correspondiente o haz una copia de seguridad y prueba de nuevo. Y si todo lo demás falla, tu proveedor de hosting siempre puede echarte una mano, aunque con esta guía estoy seguro de que no lo necesitarás.

[INFO]
Si tu hosting utiliza Syspanel (puerto 2106), el proceso es el mismo que con cPanel, solo que la interfaz es diferente. Busca la sección "Administrador de archivos" y sigue los mismos pasos. La carpeta donde se aloja tu tienda suele llamarse public_html o web.