Actualizar PrestaShop en DirectAdmin - Guía paso a paso

Introducción: ¿Por qué actualizar PrestaShop manualmente?

Mantener tu tienda online actualizada es una de las tareas más importantes para garantizar su seguridad, rendimiento y compatibilidad. Aunque PrestaShop ofrece actualizaciones automáticas a través del módulo 1-Click Upgrade, en muchos entornos de hosting compartido o con DirectAdmin, este proceso puede fallar por límites de tiempo de ejecución, memoria o permisos. Por eso, aprender a actualizar PrestaShop DirectAdmin de forma manual te da control total y evita dolores de cabeza.

En esta guía, te explicaré paso a paso cómo realizar una actualización manual de PrestaShop en un servidor con panel DirectAdmin. No necesitas ser un experto en Linux, solo seguir las instrucciones con cuidado. Al final, tendrás tu tienda funcionando con la última versión estable.

Requisitos previos antes de empezar

Antes de lanzarte a la actualización, asegúrate de tener lo siguiente:

Acceso a DirectAdmin con permisos de administrador o de usuario para gestionar archivos y bases de datos.
Acceso vía FTP o SFTP (recomendamos SFTP por seguridad) o al administrador de archivos de DirectAdmin.
phpMyAdmin o acceso a la base de datos MySQL/MariaDB desde DirectAdmin.
Conocimiento básico de cómo hacer copias de seguridad y restaurar archivos.
Tiempo suficiente (el proceso puede tomar entre 30 minutos y 1 hora, dependiendo del tamaño de la tienda).

[WARNING] No intentes actualizar sin hacer una copia de seguridad completa. Un error puede dejar tu tienda inaccesible. Hazla siempre.

Paso 1: Haz una copia de seguridad completa

Este es el paso más importante. Una copia de seguridad te permitirá restaurar tu tienda si algo sale mal. Debes respaldar dos cosas: los archivos y la base de datos.

Copia de seguridad de archivos

Ingresa a DirectAdmin y ve a Gestión de archivos.
Selecciona la carpeta donde está instalado PrestaShop (normalmente public_html o tienda).
Haz clic en Comprimir y elige Zip o Tar.gz. Esto creará un archivo comprimido con todos los archivos.
Descarga ese archivo a tu computadora mediante FTP o SFTP.

[TIP] Si tu tienda es grande, puedes usar FTP para descargar la carpeta completa. Es más rápido que comprimir en el servidor.

Copia de seguridad de la base de datos

En DirectAdmin, ve a phpMyAdmin (suele estar en la sección Base de datos).
Selecciona la base de datos de tu PrestaShop.
Haz clic en Exportar y elige el método Rápido con formato SQL.
Descarga el archivo .sql generado.

Guarda ambos archivos en un lugar seguro de tu computadora. ¡No los borres hasta que la actualización esté completa y verificada!

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

Ve al sitio oficial de PrestaShop y descarga la última versión estable (actualmente la 8.x o 9.x, según la fecha). El archivo viene en formato .zip.

No uses versiones beta o release candidates en producción. Solo versiones estables.

Paso 3: Prepara el entorno de actualización

Antes de subir archivos nuevos, es recomendable poner tu tienda en modo mantenimiento para que los clientes no vean errores durante el proceso.

Activar modo mantenimiento

Conéctate a tu servidor vía FTP o al administrador de archivos de DirectAdmin.
Localiza el archivo /config/defines.inc.php en la raíz de PrestaShop.
Ábrelo con un editor de texto (como Notepad++ o el editor de DirectAdmin).
Busca la línea: define('_PS_MODE_DEV_', false); y justo debajo agrega:
```
define('_PS_MAINTENANCE_TASK_', true);
```
Esto permitirá que la tienda se muestre en modo mantenimiento incluso si no tienes acceso al back office.
Guarda el archivo.

[INFO] Si tu versión de PrestaShop es muy antigua (1.6 o anterior), el método puede variar. En ese caso, mejor activa el modo mantenimiento desde el back office si aún puedes acceder.

Paso 4: Sube los archivos nuevos (sin sobrescribir todo)

Aquí viene la parte delicada. No debes subir todos los archivos de la nueva versión porque sobrescribirías tus configuraciones, temas, módulos y archivos personalizados. La forma correcta es:

Extrae el archivo ZIP de la nueva versión en tu computadora.
Copia solo las carpetas y archivos que no sean de configuración personalizada. En general, debes sobrescribir:
- admin/ (la carpeta de administración, pero renómbrala después)
- classes/
- controllers/
- core/
- js/
- localization/
- mails/
- modules/ (excepto módulos personalizados, pero en la mayoría de casos se sobrescriben)
- override/ (si existe, ten cuidado con personalizaciones)
- themes/ (solo si usas el tema por defecto; si tienes un tema personalizado, no lo sobrescribas)
- tools/
- vendor/
- webservice/
- Archivos raíz como index.php, config.php, etc.
No sobrescribas:
- config/settings.inc.php (contiene la configuración de la base de datos)
- img/ (tus imágenes de productos)
- download/ (archivos descargables)
- upload/ (archivos subidos por clientes)
- themes/ si tienes un tema personalizado (solo copia los archivos del tema por defecto si quieres actualizarlo)
- modules/ si tienes módulos de pago o personalizados (mejor actualízalos después desde el back office)

Una forma más segura es subir todo el contenido de la nueva versión excepto la carpeta config, y luego restaurar tu archivo settings.inc.php original. Pero si no te sientes seguro, sigue el método manual.

Subir archivos vía FTP

Conéctate a tu servidor con un cliente FTP (FileZilla, por ejemplo).
Navega hasta la carpeta raíz de PrestaShop.
Arrastra las carpetas y archivos que vas a sobrescribir desde tu computadora al servidor.
Cuando el FTP te pregunte si quieres sobrescribir, elige Sobrescribir todo.
Espera a que termine la transferencia (puede tardar varios minutos).

[TIP] Si tu conexión es lenta, puedes subir el ZIP completo al servidor y luego descomprimirlo desde el administrador de archivos de DirectAdmin. Luego, mueve las carpetas necesarias.

Paso 5: Ejecuta el script de actualización

Una vez que los archivos están en su lugar, debes ejecutar el script de actualización de PrestaShop.

En tu navegador, escribe la URL de tu tienda seguida de /install/upgrade/upgrade.php. Por ejemplo: https://tutienda.com/install/upgrade/upgrade.php.
Si todo está correcto, verás una página con instrucciones. Haz clic en Actualizar o Upgrade.
El script comenzará a actualizar la base de datos. Puede tomar varios minutos, dependiendo del tamaño.
Al final, verás un mensaje de éxito. No cierres la página hasta que termine.

[WARNING] Si ves errores de tiempo de ejecución, es posible que necesites aumentar los límites de PHP en DirectAdmin. Ve a Configuración de PHP y aumenta max_execution_time a 300 segundos y memory_limit a 256M o más.

Paso 6: Limpieza y verificación

Después de la actualización, debes hacer algunas tareas de limpieza:

Elimina la carpeta /install del servidor. Es un riesgo de seguridad dejarla.
Renombra la carpeta /admin por seguridad. Puedes hacerlo desde el administrador de archivos de DirectAdmin. Elige un nombre difícil de adivinar, como admin_xyz123.
Actualiza la URL de administración en el archivo /config/settings.inc.php si es necesario (no suele serlo, pero verifica).
Desactiva el modo mantenimiento: Elimina la línea que agregaste en defines.inc.php o cámbiala a false.

Verifica el funcionamiento

Accede a tu tienda como cliente: revisa que las páginas carguen, los productos se vean y el carrito funcione.
Accede al back office con la nueva URL (ej: https://tutienda.com/admin_xyz123).
Ve a Parámetros de la tienda > Rendimiento y Regenera el índice.
Ve a Módulos y actualiza los que tengan versión nueva.

Solución de problemas comunes (FAQ)

¿Qué hago si la tienda muestra un error blanco después de la actualización?

Es probable que haya un conflicto con un módulo o tema. Prueba a:

Desactivar todos los módulos desde la base de datos (en la tabla ps_module pon active = 0).
Cambiar temporalmente al tema por defecto (modificando _THEME_NAME_ en la tabla ps_configuration).
Revisar los logs de error en /var/log/ o en el panel de DirectAdmin.

¿Puedo actualizar desde PrestaShop 1.6 directamente a la 8.x?

Sí, pero el salto es grande. Es recomendable hacerlo en etapas: primero a 1.7, luego a 8.x. Si lo haces directo, pueden fallar módulos y temas. Mejor sigue el método manual con paciencia.

¿Pierdo mis módulos de pago al actualizar?

No deberías, pero algunos módulos de pago requieren actualización. Antes de actualizar, verifica que tus módulos sean compatibles con la nueva versión. Si no, contacta al desarrollador.

¿Cómo restauro mi tienda si falla todo?

Si la actualización falla y no puedes acceder, restaura la copia de seguridad que hiciste:

Sube la carpeta de archivos backup vía FTP.
Importa la base de datos desde phpMyAdmin (borra todas las tablas primero y luego importa el SQL).
Vuelve a activar el modo mantenimiento y verifica.

[INFO] Si usas Syspanel (HestiaCP), el proceso es muy similar. Solo que el acceso a la base de datos y archivos se hace desde el puerto 2106. El resto de pasos son idénticos.

Conclusión

Actualizar PrestaShop DirectAdmin manualmente puede parecer intimidante, pero siguiendo estos pasos con cuidado, es un proceso seguro y controlado. La clave está en la preparación: copia de seguridad, paciencia y verificación. No olvides que mantener tu tienda actualizada no solo mejora la seguridad, sino que también te da acceso a nuevas funcionalidades y mejor rendimiento.

Si te surge alguna duda durante el proceso, revisa la documentación oficial de PrestaShop o consulta con tu proveedor de hosting. ¡Buena suerte con tu actualización!