Guía para actualizar PrestaShop sin errores en Syspanel

Actualizar PrestaShop es una tarea necesaria para mantener tu tienda segura, rápida y compatible con las últimas extensiones. Sin embargo, si no se hace correctamente, puede provocar errores que dejen tu tienda inaccesible. En esta guía, te explicamos paso a paso cómo realizar una actualización de PrestaShop sin errores utilizando Syspanel (anteriormente conocido como HestiaCP). Sigue estas instrucciones y minimiza los riesgos al máximo.

Preparación: Antes de tocar nada

La clave para una actualización exitosa es la preparación. No te saltes estos pasos, por muy aburridos que parezcan.

1. Haz una copia de seguridad completa

Este es el paso más importante de todos. Si algo sale mal, la copia de seguridad es tu salvavidas. Desde Syspanel puedes hacerlo fácilmente.

1. Accede a Syspanel a través de tu navegador: https://tu-dominio.com:2106 (recuerda que el puerto es el 2106).
2. Inicia sesión con tu usuario y contraseña de administrador.
3. Busca la sección "Backup" o "Copias de seguridad" en el menú lateral.
4. Selecciona tu cuenta de hosting donde está instalado PrestaShop.
5. Marca las opciones para incluir Archivos y Base de Datos.
6. Haz clic en "Generar copia" o "Crear backup". Espera a que finalice el proceso.

[WARNING] No confíes solo en la copia de seguridad automática que haga tu hosting. Realiza una manual antes de la actualización. Descarga la copia a tu ordenador como medida extra.

2. Verifica los requisitos del sistema

Cada versión de PrestaShop tiene requisitos específicos de PHP, MySQL y extensiones de servidor. Si tu Syspanel no los cumple, la actualización fallará.

1. Desde Syspanel, ve a la sección "Ajustes avanzados" o "PHP".
2. Comprueba la versión de PHP que tienes asignada a tu dominio. PrestaShop 8.x, por ejemplo, requiere PHP 7.4 o superior (recomendado PHP 8.0+).
3. Si necesitas cambiar la versión de PHP, selecciona la opción adecuada (por ejemplo, "PHP 8.1") y guarda los cambios.
4. También verifica que tu servidor tenga las extensiones necesarias (como curl, gd, json, mbstring, openssl, pdo_mysql, zip). En Syspanel, estas suelen estar activadas por defecto, pero puedes revisarlo en la configuración de PHP.

[TIP] Si no estás seguro de qué versión de PHP necesitas, consulta la documentación oficial de la versión de PrestaShop a la que quieres actualizar. Es mejor ir paso a paso: actualiza primero a una versión intermedia si estás muy desactualizado.

3. Pon tu tienda en modo mantenimiento

Durante la actualización, tu tienda no debe estar accesible al público. Activa el modo mantenimiento desde el panel de administración de PrestaShop.

1. Ve a "Parámetros de la tienda" > "Mantenimiento".
2. Activa la opción "Activar modo mantenimiento".
3. Opcionalmente, añade una IP de confianza (la tuya) para poder seguir viendo la tienda mientras la actualizas.

El proceso de actualización paso a paso

Una vez que tienes la copia de seguridad y los requisitos listos, es hora de proceder.

1. Descarga la última versión de PrestaShop

No uses el auto-actualizador del módulo "1-Click Upgrade" sin haber hecho los pasos anteriores. Primero, descarga el paquete completo desde el sitio oficial de PrestaShop (addons.prestashop.com) o desde el área de descargas de tu cuenta.

2. Sube los archivos a tu servidor mediante Syspanel

Syspanel incluye un gestor de archivos muy útil para esta tarea.

1. En Syspanel, ve a "Archivos" o "File Manager".
2. Navega hasta la carpeta public_html (o la carpeta raíz de tu dominio).
3. Importante: No borres nada todavía. Simplemente sube el archivo ZIP de la nueva versión a una carpeta temporal, por ejemplo, public_html/actualizacion/.
4. Desde el gestor de archivos, haz clic derecho sobre el ZIP y selecciona "Extraer" o "Unzip". Espera a que se descomprima.
5. Una vez extraído, tendrás una carpeta con el nombre de la versión (ej. prestashop_8.1.0). Dentro de ella, busca la carpeta prestashop y copia TODOS los archivos y carpetas que contiene.
6. Pega esos archivos en la raíz de tu tienda (public_html/). Confirma la sobrescritura de todos los archivos cuando el sistema te lo pregunte.

[WARNING] Sobrescribir archivos es normal en una actualización. No te asustes. El proceso reemplazará los archivos antiguos por los nuevos, manteniendo tus datos intactos (módulos, temas, etc.).

3. Ejecuta el asistente de actualización

Una vez sobrescritos los archivos, accede a tu tienda desde el navegador. Verás que PrestaShop detecta que los archivos han cambiado y te mostrará un asistente de actualización.

1. Abre tu navegador y escribe la URL de tu tienda (ej. https://tutienda.com).
2. Automáticamente, deberías ver una pantalla que dice "Actualización de PrestaShop" o similar. Si no aparece, añade /install/ al final de la URL.
3. Sigue los pasos del asistente:
   • Paso 1: Selecciona tu idioma.
   • Paso 2: Acepta los términos de la licencia.
   • Paso 3: El asistente comprobará los requisitos del servidor. Si todo está bien, continúa.
   • Paso 4: Te pedirá los datos de conexión a la base de datos. Syspanel te proporciona estos datos en la sección "Bases de datos" del panel. Anota el nombre de la base de datos, el usuario y la contraseña.
   • Paso 5: El asistente realizará la actualización de la base de datos. No interrumpas este proceso. Puede tardar varios minutos.
4. Al finalizar, verás un mensaje de éxito. Importante: Borra o renombra la carpeta /install/ desde el gestor de archivos de Syspanel por seguridad. Si no lo haces, tu tienda puede ser vulnerable.

4. Verifica que todo funciona

Una vez borrada la carpeta install, accede a tu tienda y a tu panel de administración (normalmente en /admin o la URL que hayas configurado).

1. Revisa la tienda pública: Navega por algunas categorías, productos y el carrito. Asegúrate de que no hay errores 500 o páginas en blanco.
2. Revisa el panel de administración: Ve a "Parámetros de la tienda" > "Información" para ver que la versión se ha actualizado correctamente.
3. Comprueba los módulos: Ve a "Módulos" > "Catálogo de módulos". Algunos módulos pueden no ser compatibles con la nueva versión. Syspanel no gestiona esto, pero desde el propio panel de PrestaShop puedes ver si hay actualizaciones pendientes para tus módulos.
4. Limpia la caché: En "Parámetros avanzados" > "Rendimiento", haz clic en "Limpiar caché" tanto de la plantilla como de la caché del servidor.

Qué hacer si aparece un error

Incluso siguiendo todos los pasos, pueden surgir problemas. Aquí tienes los más comunes y cómo solucionarlos desde Syspanel.

Error 500 o pantalla en blanco

1. Accede a Syspanel y ve a "Registros de errores" o "Error Logs". Busca errores recientes relacionados con PHP.
2. Si el error es de memoria, aumenta el límite de memoria PHP desde la configuración de PHP en Syspanel (busca memory_limit y cámbialo a 256M o 512M).
3. Si el error es de un módulo específico, desactívalo temporalmente desde la base de datos (si no puedes acceder al panel de administración). En Syspanel, ve a "Bases de datos", entra en phpMyAdmin y en la tabla ps_module (o prestashop_module), busca el módulo problemático y cambia active de 1 a 0.

Error de conexión a la base de datos

1. Verifica que los datos de conexión (usuario, contraseña, nombre de base de datos) en el archivo app/config/parameters.php (o config/settings.inc.php en versiones antiguas) sean correctos. Puedes editar este archivo desde el gestor de archivos de Syspanel.
2. Asegúrate de que la base de datos no esté llena. Desde Syspanel, en la sección de bases de datos, puedes ver el tamaño y optimizarla.

El asistente de actualización no aparece

1. Asegúrate de haber sobrescrito todos los archivos correctamente. Vuelve a subir el ZIP y repite el proceso de extracción y sobrescritura.
2. Borra la carpeta var/cache (o cache) desde el gestor de archivos de Syspanel para forzar a PrestaShop a regenerar los archivos de caché.

Preguntas frecuentes (FAQ)

¿Puedo saltarme versiones al actualizar PrestaShop?

No es recomendable. Lo mejor es actualizar paso a paso: de la versión 1.6 a la 1.7, luego a la 8.0, etc. Si intentas saltar de 1.6 a 8.0 directamente, es muy probable que tengas errores graves en la base de datos.

¿Qué hago si mi tema o módulos no son compatibles?

Antes de actualizar, consulta con el desarrollador del tema o módulo si hay versiones compatibles con la nueva versión de PrestaShop. Si no las hay, tendrás que buscar alternativas o posponer la actualización.

¿Syspanel me notifica cuando hay una nueva versión de PrestaShop?

No directamente. Syspanel es un panel de control de servidor, no un gestor de actualizaciones de aplicaciones. Debes estar atento a las notificaciones dentro del propio panel de administración de PrestaShop o suscribirte a su newsletter.

¿Cuánto tiempo tarda la actualización?

Depende del tamaño de tu tienda (número de productos, imágenes, etc.) y de la velocidad de tu servidor. Generalmente, entre 15 y 45 minutos. Si tarda más, no interrumpas el proceso.

¿Pierdo mis datos (clientes, pedidos, productos) al actualizar?

No, la actualización solo modifica los archivos del sistema y la estructura de la base de datos. Tus datos (clientes, pedidos, productos) se mantienen intactos. Por eso es vital hacer la copia de seguridad, por si algo falla en la estructura.

¿Debo actualizar también los módulos de pago?

Sí, especialmente los módulos de pago y envío. Las versiones antiguas pueden no ser compatibles con las nuevas APIs de PrestaShop y dejar de funcionar. Actualízalos desde el catálogo de módulos de tu panel de administración.

[INFO] Si no te sientes seguro haciendo todo este proceso manual, muchos hosts que usan Syspanel ofrecen servicios de actualización gestionada. Pregunta a tu proveedor de hosting si pueden hacerlo por ti. El coste suele ser bajo y te ahorras posibles dolores de cabeza.

Actualizar PrestaShop puede parecer complejo, pero con una buena preparación y siguiendo estos pasos desde Syspanel, lo harás sin errores. Recuerda: la paciencia y las copias de seguridad son tus mejores aliados. ¡Buena suerte con tu tienda!