Actualizar PrestaShop manualmente desde cPanel - Paso a paso

Actualizar PrestaShop es una tarea fundamental para mantener la seguridad, el rendimiento y la compatibilidad de tu tienda online. Si tienes tu tienda alojada en un servidor con cPanel, realizar la actualización manualmente te da control total sobre el proceso. En esta guía extensa y paso a paso, te explicaré cómo actualizar PrestaShop desde cPanel de forma manual, resolviendo las dudas más comunes y asegurándote de que no pierdas datos ni personalizaciones.

Antes de empezar: preparación y copia de seguridad

Antes de tocar cualquier archivo de tu tienda, es imprescindible hacer una copia de seguridad completa. Una actualización manual puede sobrescribir archivos y, si algo sale mal, podrías perder tu tienda. Por eso, sigue estos pasos de preparación.

Haz una copia de seguridad de los archivos

Accede a tu cPanel. Normalmente la URL es algo como tudominio.com/cpanel o tudominio.com:2083. Introduce tu usuario y contraseña.

Dentro de cPanel, busca la sección Archivos y haz clic en Administrador de archivos. Se abrirá una ventana con la estructura de carpetas de tu hosting.

Navega hasta la carpeta donde está instalado PrestaShop. Normalmente es public_html o una subcarpeta como tienda o shop.

Selecciona toda la carpeta de PrestaShop (por ejemplo, public_html) y haz clic en Comprimir. Elige el formato Zip y dale un nombre como backup-prestashop-[fecha].zip. Luego, descarga ese archivo a tu computadora.

Haz una copia de seguridad de la base de datos

La base de datos guarda todos tus productos, pedidos, clientes y configuraciones. Para respaldarla, en cPanel busca la sección Bases de datos y haz clic en phpMyAdmin.

Selecciona la base de datos de tu PrestaShop (el nombre suele aparecer en el archivo app/config/parameters.php de tu instalación). Haz clic en Exportar en la parte superior. Elige el método Rápido y formato SQL. Luego, haz clic en Continuar y descarga el archivo .sql.

[INFO] Guarda estas copias en un lugar seguro fuera de tu servidor, como tu ordenador o un servicio en la nube. Así, si algo falla, podrás restaurar tu tienda fácilmente.

Comprende la actualización manual de PrestaShop

Actualizar PrestaShop manualmente significa reemplazar los archivos antiguos por los nuevos de la versión más reciente, conservando tus datos y configuraciones. Es un proceso más seguro que la actualización automática porque tienes control total, pero requiere seguir los pasos al pie de la letra.

¿Por qué actualizar manualmente?

Control total: Tú decides cuándo y cómo hacerlo.
Evitas errores de compatibilidad: Puedes verificar que todo funcione antes de poner la tienda en línea.
Personalizaciones seguras: Si tienes temas o módulos modificados, puedes adaptarlos sin sobrescribirlos accidentalmente.
Mayor estabilidad: Al hacerlo manual, reduces el riesgo de fallos durante el proceso.

¿Qué necesitas?

Acceso a cPanel (usuario y contraseña).
La última versión de PrestaShop (descárgala desde prestashop.com).
Un cliente FTP (opcional, pero útil si prefieres no usar el Administrador de archivos de cPanel).
Conocimientos básicos de navegación por archivos.

Paso a paso: actualizar PrestaShop desde cPanel

Sigue estos pasos con cuidado. Te recomiendo hacerlo en un horario de poco tráfico y, si es posible, poner tu tienda en modo mantenimiento primero.

Paso 1: Descarga la última versión de PrestaShop

Ve al sitio oficial de PrestaShop y descarga el paquete completo de la última versión estable (por ejemplo, la 8.x). El archivo será un .zip con todos los archivos de la tienda.

Paso 2: Descomprime el archivo en tu computadora

En tu ordenador, descomprime el archivo descargado. Verás una carpeta llamada prestashop (o similar) que contiene subcarpetas como admin, modules, themes, etc.

Paso 3: Elimina archivos innecesarios del paquete de actualización

Para evitar sobrescribir tus datos, elimina del paquete descargado las carpetas que no deben reemplazarse:

/img: Contiene tus imágenes de productos, logotipos, etc. No la reemplaces.
/download: Almacena productos descargables. No la toques.
/upload: Archivos subidos por clientes. No la reemplaces.
/themes: Si tienes un tema personalizado, no copies la carpeta themes del paquete. En su lugar, actualiza solo los archivos del tema oficial si lo usas.
/modules: Si tienes módulos de pago o personalizados, no copies toda la carpeta. Mejor actualiza los módulos oficiales después.

[WARNING] Si tienes un tema o módulos personalizados, haz una copia de seguridad adicional de esas carpetas antes de continuar. La actualización manual puede sobrescribir tus personalizaciones si no tienes cuidado.

Paso 4: Sube los archivos nuevos a tu servidor

Accede al Administrador de archivos de cPanel. Navega a la carpeta raíz de tu PrestaShop (por ejemplo, public_html).

Selecciona todos los archivos y carpetas que tienes en tu computadora (excluyendo los que eliminaste en el paso 3) y súbelos a la carpeta raíz. Puedes hacerlo de dos formas:

Arrastrando y soltando: En el Administrador de archivos, haz clic en Subir y selecciona los archivos.
Usando FTP: Conecta con un cliente FTP (como FileZilla) y sube los archivos desde tu computadora.

Cuando te pregunte si quieres sobrescribir los archivos existentes, elige Sobrescribir todo o Reemplazar.

[TIP] Si usas FTP, asegúrate de que la conexión sea segura (SFTP) para proteger tus datos.

Paso 5: Ejecuta el script de actualización

Una vez subidos los archivos, abre tu navegador y ve a la URL de tu tienda seguida de /install/upgrade/upgrade.php. Por ejemplo: https://tudominio.com/install/upgrade/upgrade.php.

Si no aparece nada, es posible que necesites eliminar la carpeta /install primero (pero no la borres aún, solo renómbrala temporalmente). En realidad, PrestaShop moderno tiene un asistente que te guiará.

El script de actualización comprobará la versión actual y te mostrará los pasos. Sigue las instrucciones en pantalla:

Selecciona tu versión actual: Elige la que tenías antes de actualizar.
Confirma la actualización: Haz clic en Actualizar ahora.
Espera: El proceso puede tardar varios minutos. No cierres la ventana ni interrumpas la conexión.

Paso 6: Verifica que la actualización se haya completado

Cuando termine, verás un mensaje de éxito. Ahora, ve a la URL de tu tienda (sin /install) y comprueba que todo funcione correctamente:

La página principal carga sin errores.
Los productos, categorías y pedidos se ven bien.
El panel de administración (normalmente en /admin) funciona.

Si ves algún error, revisa el archivo config/defines.inc.php y asegúrate de que _PS_MODE_DEV_ esté en true para ver los mensajes de error. Luego, puedes desactivarlo cuando todo esté bien.

Paso 7: Elimina la carpeta /install

Por seguridad, después de la actualización, elimina la carpeta /install del servidor. En el Administrador de archivos, haz clic derecho sobre ella y elige Eliminar. Esto evita que alguien pueda reutilizarla para ataques.

Paso 8: Limpia la caché y regenera los archivos

Ve al panel de administración de PrestaShop (por ejemplo, tudominio.com/admin). Ve a Parámetros avanzados > Rendimiento y haz clic en Limpiar la caché. También puedes regenerar los archivos de clase y las plantillas desde allí.

Si tu versión anterior tenía módulos o temas incompatibles, es posible que veas advertencias. Actualiza los módulos desde el administrador o descarga las versiones compatibles.

Solución de problemas comunes

A veces, la actualización manual puede presentar inconvenientes. Aquí tienes los más frecuentes y cómo solucionarlos.

Error de "página en blanco" después de actualizar

Esto suele deberse a un error de PHP o a un tema incompatible. Para ver el error, activa el modo desarrollo:

Edita el archivo config/defines.inc.php y cambia define('_PS_MODE_DEV_', false); a define('_PS_MODE_DEV_', true);.
Recarga la página y verás el mensaje de error. Luego, busca ayuda en la documentación de PrestaShop o en foros.

Problemas con la base de datos

Si ves errores de base de datos, restaura tu copia de seguridad de la base de datos desde phpMyAdmin y repite el proceso de actualización con más cuidado.

Módulos o temas que no funcionan

Desactiva temporalmente los módulos de terceros desde el administrador. Luego, ve actualizándolos uno por uno. Si un tema personalizado da problemas, cambia temporalmente al tema predeterminado (por ejemplo, "Classic") y luego adapta tu tema.

Preguntas frecuentes (FAQ)

Aquí respondo las dudas más comunes sobre la actualización manual de PrestaShop desde cPanel.

¿Puedo actualizar PrestaShop automáticamente desde el panel de administración?

Sí, PrestaShop tiene un módulo de actualización automática (1-Click Upgrade), pero no siempre es fiable. La actualización manual desde cPanel te da más control y evita errores de compatibilidad.

¿Qué hago si mi versión de PrestaShop es muy antigua?

Si tu versión es anterior a la 1.6, es recomendable hacer una actualización gradual: primero a una versión intermedia (por ejemplo, 1.6), luego a la 1.7 y finalmente a la 8.x. Esto reduce los riesgos de incompatibilidad.

¿Necesito conocimientos de programación?

No, pero sí debes seguir los pasos con cuidado. Si no te sientes seguro, contrata a un profesional o pide ayuda en foros especializados.

¿Cuánto tiempo tarda la actualización manual?

Depende del tamaño de tu tienda y la velocidad del servidor. En general, entre 30 minutos y 2 horas, incluyendo las copias de seguridad.

¿Puedo perder mis productos o pedidos?

Si haces una copia de seguridad correcta y sigues los pasos, no perderás datos. La actualización manual solo reemplaza los archivos del sistema, no la base de datos.

¿Qué hago si después de actualizar mi tienda no carga?

Revisa los errores en el modo desarrollo (como expliqué arriba). También verifica que tu servidor cumpla con los requisitos de la nueva versión (PHP 7.4 o superior, MySQL 5.6+, etc.).

Consejos finales para una actualización exitosa

Prueba en un entorno de staging: Si tienes un subdominio o una copia de tu tienda, actualiza primero allí para verificar que todo funciona.
Actualiza módulos y temas: Después de la actualización, asegúrate de que todos los módulos y el tema sean compatibles con la nueva versión.
Mantén copias de seguridad periódicas: No solo durante la actualización, sino como práctica habitual.
Documenta el proceso: Anota los pasos que seguiste y cualquier problema que encontraste para futuras actualizaciones.

Actualizar PrestaShop manualmente desde cPanel puede parecer intimidante al principio, pero con esta guía paso a paso, tendrás el control total de tu tienda. Recuerda siempre hacer copias de seguridad, seguir los pasos con paciencia y no dudar en pedir ayuda si algo no sale como esperas. ¡Tu tienda estará más segura y rápida con cada actualización!