Cómo actualizar PrestaShop fácilmente usando Syspanel

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí es porque quieres aprender a actualizar PrestaShop desde Syspanel de forma segura y sin complicaciones. Mantener tu tienda actualizada es clave para la seguridad, el rendimiento y el SEO. No te preocupes, te guiaré paso a paso como si lo hiciera contigo al lado.

Esta guía está diseñada para que, incluso si no eres un experto técnico, puedas realizar un upgrade PrestaShop con confianza. Recuerda que Syspanel (antes conocido como HestiaCP) es el panel de control que usamos para gestionar tu hosting, y accedes a él a través del puerto 2106 (por ejemplo, https://tudominio.com:2106).

¿Qué necesitas antes de empezar la actualización?

Antes de lanzarnos a la actualización PrestaShop, es fundamental que prepares el terreno. Saltarse estos pasos puede provocar errores graves o la pérdida de datos.

Requisitos técnicos básicos

Asegúrate de que tu servidor cumple con los requisitos de la nueva versión de PrestaShop. Generalmente necesitas:

PHP 7.4 o superior (recomendado PHP 8.0 o 8.1 para versiones recientes).
MySQL 5.6+ o MariaDB 10.1+.
Módulos de PHP como curl, gd, json, mbstring, openssl, pdo_mysql, zip, etc.
Permisos de escritura en carpetas clave (/config, /cache, /img, /modules, /themes, /translations, /upload, /download).

Puedes verificar la configuración actual de tu hosting desde Syspanel: ve a la sección de "Web" o "Dominios", selecciona tu dominio y busca "Configuración de PHP".

[INFO] Si no cumples con los requisitos, contacta con soporte técnico antes de iniciar. Actualizar sin los requisitos puede romper la tienda.

Copia de seguridad: tu mejor amiga

Este es el paso más importante. Nunca, bajo ninguna circunstancia, actualices sin una copia de seguridad completa. Una actualización PrestaShop puede fallar y necesitarás restaurar todo.

Desde Syspanel, haz lo siguiente:

Copia de seguridad de la base de datos:
- Ve a "Base de datos" en Syspanel.
- Busca la base de datos de tu PrestaShop (suele llamarse como tu dominio).
- Haz clic en "Exportar" o "Respaldo". Descarga el archivo .sql a tu computadora.
- También puedes usar el botón "Crear copia de seguridad" si Syspanel lo ofrece.
Copia de seguridad de los archivos:
- Ve a "Archivos" o "Administrador de archivos" en Syspanel.
- Navega hasta la carpeta de tu tienda (normalmente public_html o una subcarpeta).
- Selecciona todos los archivos y carpetas (puedes usar el checkbox superior).
- Haz clic en "Comprimir" y elige formato .zip o .tar.gz.
- Descarga el archivo comprimido a tu computadora.

[WARNING] Guarda ambas copias en un lugar seguro (tu PC, disco externo o nube). No confíes solo en las copias del servidor.

Paso 1: Prepara el entorno en Syspanel para la actualización

Ahora que tienes tu respaldo, vamos a preparar el servidor para el upgrade PrestaShop.

Desactiva la tienda (modo mantenimiento)

Para evitar que los clientes vean errores durante la actualización, pon tu tienda en modo mantenimiento.

Accede a tu panel de administración de PrestaShop.
Ve a Parámetros de la tienda > Preferencias > Mantenimiento.
Activa "Sí" en "Activar modo de mantenimiento".
Opcional: escribe un mensaje amigable (ej: "Estamos mejorando tu experiencia. Vuelve pronto").
Guarda los cambios.

Verifica y limpia la caché

Una caché sucia puede causar conflictos durante la actualización.

En tu administración de PrestaShop, ve a Parámetros avanzados > Rendimiento.
Haz clic en "Limpiar caché" (tanto la de Smarty como la de Symfony).
También puedes borrar manualmente las carpetas /var/cache y /cache desde el administrador de archivos de Syspanel (pero ten cuidado de no borrar archivos esenciales).

Desactiva módulos y temas no esenciales

Algunos módulos o temas personalizados pueden ser incompatibles con la nueva versión. Es mejor desactivarlos temporalmente.

Ve a Módulos > Gestor de módulos.
Desactiva todos los módulos de terceros (los que no vienen por defecto con PrestaShop).
Ve a Diseño > Tema y logo y cambia a un tema por defecto (como "Classic") si usas uno personalizado.

[TIP] Anota qué módulos desactivaste para volver a activarlos después de la actualización.

Paso 2: Descarga la nueva versión de PrestaShop

Ahora necesitas conseguir los archivos de la versión a la que quieres actualizar. Nunca descargues versiones beta o release candidates en producción.

Opción recomendada: desde el administrador de archivos de Syspanel

Inicia sesión en Syspanel (puerto 2106).
Ve a "Archivos" y navega hasta la carpeta de tu tienda (ej: /home/usuario/web/tudominio/public_html).
Sube el archivo .zip de PrestaShop que descargaste desde prestashop.com (versión completa, no la de "solo actualización").
Una vez subido, haz clic derecho sobre el archivo y selecciona "Extraer" o "Descomprimir aquí". Esto sobrescribirá algunos archivos.

Opción alternativa: mediante FTP

Si prefieres usar un cliente FTP (como FileZilla):

Conéctate a tu servidor usando los datos de FTP que aparecen en Syspanel (sección "Acceso FTP").
Sube el archivo .zip de PrestaShop a la carpeta raíz de tu tienda.
Descomprímelo en el servidor (algunos clientes FTP no lo hacen, tendrías que hacerlo desde Syspanel).

[WARNING] No borres la carpeta admin antigua ni la carpeta install que ya existe. La nueva versión las sustituirá durante el proceso.

Paso 3: Ejecuta el proceso de actualización (upgrade PrestaShop)

Este es el corazón de la guía. Vamos a correr el script de actualización.

Accede al script de actualización

Abre tu navegador y escribe la URL de tu tienda seguida de /install/upgrade/upgrade.php (ej: https://tudominio.com/install/upgrade/upgrade.php).
Si ves un error de "archivo no encontrado", es que debes copiar la carpeta install de la nueva versión (la que descomprimiste) y reemplazar la existente, pero nunca borres la carpeta install original hasta terminar.
El script te pedirá que selecciones la versión desde la que actualizas. Normalmente la detecta automáticamente. Confirma y haz clic en "Siguiente".

Sigue las instrucciones en pantalla

El asistente de actualización te guiará por varias pantallas:

Comprobación de requisitos: Verifica que todo está correcto. Si hay errores (ej: permisos), revísalos desde Syspanel (puedes cambiar permisos de carpetas a 755 o 777 temporalmente).
Copia de seguridad automática: El script puede hacer una copia de seguridad de la base de datos. Acepta, pero recuerda que ya tienes la tuya propia.
Selección de opciones: Elige "Actualizar todos los datos" o "Actualizar solo la base de datos" según tu caso. Para la mayoría, la opción completa es la correcta.
Proceso de actualización: Verás una barra de progreso. No cierres la ventana ni recargues la página. Puede tardar varios minutos dependiendo del tamaño de tu tienda.

[INFO] Si el proceso se queda atascado en un 90% o más, espera al menos 5 minutos. A veces la base de datos tarda en procesar cambios grandes.

Finalización y post-instalación

Al terminar, el script te mostrará un mensaje de éxito. Luego:

Elimina la carpeta install del servidor por seguridad. Puedes hacerlo desde Syspanel (Archivos > selecciona la carpeta install > Eliminar).
Renombra la carpeta admin (si la nueva versión te creó una nueva). La carpeta admin original puede haber cambiado de nombre a adminXXXXXX. Si no, déjala como está.
Borra el archivo /install/upgrade/upgrade.php si aún existe.

Paso 4: Verifica y reactiva tu tienda

La actualización no termina hasta que pruebas que todo funciona.

Pruebas básicas

Accede a tu administración: Ve a https://tudominio.com/adminXXXXXX (con la nueva carpeta admin si cambió). Inicia sesión.
Verifica la versión: En el panel de administración, abajo a la derecha, verás la nueva versión.
Revisa el front-end: Visita tu tienda como cliente. Mira que se vea bien, que los productos se carguen, que el carrito funcione.
Prueba el proceso de compra: Haz un pedido de prueba (usa un producto con precio 0 o modo de prueba).

Reactiva módulos y tema

Vuelve a activar los módulos que desactivaste, uno por uno.
Si algún módulo da error, puede que no sea compatible. Busca actualizaciones del módulo o contacta al desarrollador.
Si usabas un tema personalizado, actívalo y verifica que se vea correctamente. Si no, tendrás que actualizarlo o contactar al diseñador.

Limpieza final

Limpia la caché de nuevo: Ve a Parámetros avanzados > Rendimiento y limpia todo.
Desactiva el modo mantenimiento: Vuelve a Parámetros de la tienda > Preferencias > Mantenimiento y pon "No".
Regenera las miniaturas de imágenes si notas que las imágenes de productos no se ven bien (en Diseño > Imágenes).

Preguntas frecuentes (FAQ) sobre actualizar PrestaShop desde Syspanel

¿Por qué debo usar Syspanel y no otro método?

Syspanel (puerto 2106) es el panel que te da control total sobre tu hosting. Desde él puedes gestionar archivos, bases de datos y permisos de forma segura, sin necesidad de comandos técnicos. Es la herramienta ideal para usuarios no expertos.

¿Qué hago si la actualización falla a mitad del proceso?

No entres en pánico. Lo primero es restaurar tu copia de seguridad:

Desde Syspanel, sube el archivo .zip de tu copia de seguridad a la carpeta de la tienda y descomprímelo (sobrescribe todo).
Ve a "Base de datos" y elimina la base de datos actual (o sus tablas).
Importa tu copia de seguridad .sql usando la opción "Importar" de Syspanel.
Vuelve a intentar la actualización después de revisar los requisitos.

¿Puedo actualizar de PrestaShop 1.6 a 1.7 directamente?

Sí, pero es más complejo y puede dar errores. Recomiendo hacerlo en dos pasos: primero a 1.7.x (la última de 1.7) y luego a 1.8 o superior. Siempre con copias de seguridad intermedias.

¿Pierdo mis módulos y temas al actualizar?

No se pierden, pero pueden dejar de funcionar si no son compatibles. Por eso es importante desactivarlos antes y actualizarlos después. Si un módulo es crítico, verifica su compatibilidad antes de la actualización.

¿Cuánto tiempo tarda el proceso?

Depende del tamaño de tu tienda (número de productos, clientes, pedidos). Una tienda pequeña (menos de 1000 productos) puede tardar 15-30 minutos. Una grande puede llevar 1-2 horas. No lo hagas en horas pico.

¿Qué hago si aparece un error de "500 Internal Server Error" después de actualizar?

Esto suele deberse a un conflicto de PHP o a un archivo .htaccess corrupto. Prueba:

Desde Syspanel, ve a "Configuración de PHP" y cambia temporalmente a una versión de PHP recomendada (ej: 8.0).
Renombra el archivo .htaccess a .htaccess_old y luego genera uno nuevo desde la administración de PrestaShop (Parámetros avanzados > Rendimiento > Generar .htaccess).

Consejos finales para un upgrade PrestaShop exitoso

No actualices en viernes por la tarde. Si algo sale mal, perderás el fin de semana. Hazlo un lunes o martes por la mañana.
Lee las notas de la versión de PrestaShop. A veces hay cambios importantes en la base de datos o en módulos nativos.
Si tienes dudas, pregunta. En el soporte de tu hosting o en foros de PrestaShop siempre hay alguien dispuesto a ayudar.
Mantén un registro de las versiones y fechas de actualización. Te ayudará a futuro.

Recuerda que actualizar PrestaShop desde Syspanel es un proceso que, con paciencia y siguiendo estos pasos, puede hacerlo cualquier persona. No tengas miedo, la recompensa es una tienda más rápida, segura y con mejor SEO.

¡Manos a la obra! Si te surge cualquier problema durante el proceso, no dudes en contactar con nuestro equipo de soporte. Estamos aquí para ayudarte.