Actualizar PrestaShop en DirectAdmin: Guía completa

Actualizar PrestaShop es una de las tareas de mantenimiento más importantes para la salud de tu tienda online. Una versión desactualizada no solo te priva de nuevas funcionalidades, sino que expone tu negocio a vulnerabilidades de seguridad críticas. Si tu hosting utiliza el panel de control DirectAdmin, estás de suerte, porque el proceso es bastante manejable si sigues los pasos correctos.

Esta guía completa está diseñada para que, incluso sin ser un experto en desarrollo, puedas realizar la actualización de tu PrestaShop desde DirectAdmin de forma segura y sin perder ventas. Vamos a desglosar el proceso en fases claras, desde la preparación hasta la verificación final, incluyendo consejos para evitar los errores más comunes.

¿Por qué es crucial mantener PrestaShop actualizado?

Antes de ensuciarnos las manos con archivos y bases de datos, entendamos el "por qué". Cada versión nueva de PrestaShop corrige bugs, mejora el rendimiento y, lo más importante, parchea agujeros de seguridad. Ignorar las notificaciones de actualización en tu back-office es como dejar la puerta de tu tienda física abierta por la noche.

Además, las pasarelas de pago (como PayPal o Stripe) y los módulos de envío actualizan sus requisitos técnicos constantemente. Si tu PrestaShop se queda atrás, estos servicios dejarán de funcionar correctamente, lo que se traduce en pérdida de ventas y clientes frustrados. La actualización no es un capricho, es una necesidad operativa.

Fase 1: Preparación del Entorno (La Clave del Éxito)

El error más común es lanzarse a actualizar sin preparar el terreno. Esta fase es la más aburrida, pero también la que te salvará el pellejo si algo sale mal. Dedica al menos 30 minutos a esta parte.

1.1. Haz una Copia de Seguridad Completa (Backup)

Esta es la regla de oro. Nunca, jamás, actualices sin una copia de seguridad. Necesitas dos cosas: una copia de los archivos del sitio y una copia de la base de datos.

Para hacerlo desde DirectAdmin, sigue estos pasos:

Accede a tu panel de DirectAdmin (normalmente en https://tudominio.com:2222).
Busca la sección "Respaldo" o "Backup" en el menú principal.
Aquí tienes dos opciones:
- Respaldo Completo: Crea un archivo .tar.gz con todos tus archivos, bases de datos y configuraciones de correo. Es la opción más segura y recomendada.
- Respaldo por partes: Puedes seleccionar solo el directorio de public_html y luego, en la sección de "Gestión de MySQL", exportar tu base de datos manualmente.

[!TIP]
Descarga siempre la copia de seguridad a tu ordenador local o a un almacenamiento en la nube (Google Drive, Dropbox). Si el servidor falla, no querrás que tu única copia esté en el mismo disco duro que el sitio que estás actualizando.

1.2. Identifica tu Versión Actual y la Nueva

Entra en tu back-office de PrestaShop (panel de administración). En el pie de página o en el menú "Parámetros Avanzados > Información", verás la versión exacta que tienes instalada (por ejemplo, 1.7.8.10).

Ahora, visita el sitio oficial de PrestaShop o tu área de clientes para ver cuál es la última versión estable disponible. La actualización más segura es siempre de forma incremental. No intentes saltar de la versión 1.6 a la 1.8 directamente. Si tu versión es muy antigua, el proceso será más complejo y deberás actualizar paso a paso (1.6 -> 1.7 -> 1.8).

1.3. Pon tu Tienda en Modo Mantenimiento

Esto es esencial para que los clientes no vean errores durante el proceso y no realicen pedidos que podrían perderse o corromperse.

En tu back-office, ve a "Parámetros Generales > Mantenimiento".
Activa el "Modo mantenimiento".
Opcionalmente, puedes añadir tu propia IP para poder ver la tienda mientras está en mantenimiento. Busca "Mi IP" en Google para saber cuál es y pégala en el campo correspondiente.

[!WARNING]
Si no activas el modo mantenimiento, un cliente podría estar en medio del proceso de pago cuando actualices los archivos, lo que provocará errores en su pedido y una mala experiencia de usuario.

Fase 2: La Actualización Manual desde DirectAdmin

Ahora viene la acción. Usaremos el método manual, que te da el control total. Aunque existen módulos como "1-Click Upgrade", a veces fallan por límites de memoria o tiempo de ejecución del servidor. El método manual es más fiable si sigues estos pasos.

2.1. Descarga la Nueva Versión de PrestaShop

Ve al sitio oficial de PrestaShop y descarga el paquete completo de la nueva versión (no la versión de "actualización", sino el archivo .zip principal).
Guarda el archivo en tu ordenador.

2.2. Sube los Archivos a tu Servidor

Aquí es donde DirectAdmin se vuelve tu mejor aliado. Tienes dos formas de subir los archivos: por FTP o por el Administrador de Archivos de DirectAdmin. Usaremos el Administrador de Archivos por ser más visual y no requerir programas externos.

En DirectAdmin, entra en "Administrador de Archivos".
Navega hasta la carpeta public_html. Esta es la raíz de tu tienda.
Haz clic en "Subir" y selecciona el archivo .zip que descargaste de PrestaShop.
Espera a que la subida termine. Si el archivo es muy grande, puede tardar varios minutos. No cierres la pestaña del navegador.

2.3. Descomprime el Archivo

Una vez subido, verás el archivo .zip en la lista. Haz clic derecho sobre él y selecciona la opción "Extraer" o "Descomprimir".

[!WARNING]
El archivo se extraerá en una carpeta con el nombre de la versión (ej. prestashop-1.8.1.0). NO subas el contenido de esa carpeta directamente a public_html aún. Necesitamos hacer una operación previa para no sobrescribir tus archivos de configuración.

2.4. La Estrategia de Reemplazo (La Parte Crucial)

Este paso es el que la mayoría de las guías omiten y causa muchos dolores de cabeza. No debes borrar todo y subir lo nuevo, porque perderías tus módulos, temas y configuración. La estrategia es reemplazar solo los archivos del núcleo (core).

Dentro de la carpeta extraída (ej. prestashop-1.8.1.0), verás una subcarpeta llamada prestashop (o los archivos directamente). Entra en ella.
Ahora, selecciona TODOS los archivos y carpetas que hay dentro de esa subcarpeta, EXCEPTO la carpeta config, la carpeta img y el archivo parameters.php si es que existen (aunque en versiones nuevas no viene, pero por seguridad). En versiones modernas de PrestaShop, la estructura es limpia y no incluye archivos de configuración del usuario.
Con todos los archivos seleccionados, haz clic en "Copiar" (o "Mover").
Navega un nivel hacia arriba, hasta public_html.
Haz clic en "Pegar". El sistema te preguntará si deseas sobrescribir los archivos existentes. Acepta y di que sí a todo.
Si te pide confirmación para sobrescribir archivos, marca la casilla "Aplicar a todos" y confirma.

Este proceso reemplazará los archivos del núcleo de PrestaShop con los nuevos, pero respetará tu carpeta config, tu carpeta img (fotos de productos) y tus archivos de ajustes personalizados que estén en la raíz.

2.5. Actualiza la Base de Datos

Ahora viene la parte que sincroniza la nueva estructura de archivos con tu base de datos.

Abre tu navegador y ve a tudominio.com/install/upgrade.php (si no existe, prueba con tudominio.com/install/).
Si el archivo upgrade.php no está, tendrás que subirlo manualmente. Dentro del paquete de la nueva versión, busca la carpeta install. Dentro de ella, hay una subcarpeta llamada upgrade. Cópiala y pégala en la carpeta install de tu public_html.
Al ejecutar upgrade.php, el asistente te guiará. Simplemente sigue los pasos. Te pedirá que selecciones tu versión actual (la que tenías antes de empezar) y luego hará el resto automáticamente.
Este proceso puede tardar unos minutos. No interrumpas la ejecución.

[!TIP]
Si el asistente de actualización de base de datos se queda en blanco o da error de "tiempo de ejecución excedido", es un problema de configuración del servidor. Contacta con tu proveedor de hosting y pídeles que aumenten el max_execution_time en PHP a 600 segundos para la carpeta public_html.

Fase 3: Post- Actualización (Verificación y Limpieza)

Una vez que el script de actualización de la base de datos termine, es hora de asegurarnos de que todo funciona.

3.1. Regenera el Cache y los Archivos de Clases

A veces, los archivos de caché antiguos causan conflictos.

En tu back-office de PrestaShop, ve a "Parámetros Avanzados > Rendimiento".
Haz clic en el botón "Vaciar la caché" (el símbolo de la escoba).
En la misma página, asegúrate de tener la opción "Forzar la compilación de las plantillas" activada para que los nuevos archivos de plantilla se generen. Después de verificar la tienda, puedes desactivarla para mejorar el rendimiento.

3.2. Verifica el Front Office y el Back Office

Front Office: Abre tu tienda en una ventana de incógnito. Comprueba que la página de inicio carga bien, que las imágenes de los productos se ven y que las categorías funcionan. Haz una búsqueda de un producto.
Back Office: Accede a tu panel de administración. Revisa que todos los menús cargan correctamente, especialmente los de "Catálogo", "Pedidos" y "Módulos".

3.3. Actualiza los Módulos y el Tema

Las nuevas versiones de PrestaShop suelen requerir versiones actualizadas de los módulos y temas.

Ve a "Módulos > Módulos y Servicios".
Verás una pestaña o un aviso que te indica qué módulos tienen actualizaciones disponibles. Actualiza todos los que puedas.
Ve a "Diseño > Tema y Logo" y verifica si tu tema es compatible con la nueva versión. Si no lo es, deberías contactar con el desarrollador del tema para obtener una actualización.

3.4. Desactiva el Modo Mantenimiento

Una vez que todo esté verificado y funcionando, ve a "Parámetros Generales > Mantenimiento" y desactiva el modo mantenimiento. Tu tienda vuelve a estar operativa para el público.

Fase 4: Solución de Problemas Comunes

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

4.1. Error 500 (Internal Server Error)

Este es el error más genérico y frustrante. Suele deberse a un problema con el archivo .htaccess o a una incompatibilidad de PHP.

Solución 1: Entra en el Administrador de Archivos de DirectAdmin y renombra el archivo .htaccess en public_html a .htaccess_old. Luego, ve al back-office (si puedes) y en "Parámetros Avanzados > Herramientas" usa el botón para regenerar el .htaccess.
Solución 2: Verifica que tu versión de PHP en DirectAdmin sea la correcta. PrestaShop 1.7 y 1.8 requieren PHP 7.1 o superior. Puedes cambiarlo en la sección "Gestión de PHP" de DirectAdmin.

4.2. La Tienda Carga en Blanco (Pantalla Blanca)

Esto suele indicar un error de PHP que está oculto.

Activa el modo de depuración. Edita el archivo config/defines.inc.php en la raíz de tu public_html.
Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);.
Guarda el archivo y recarga la tienda. Ahora verás el error específico en pantalla. Una vez solucionado, vuelve a poner el valor en false.

4.3. Problemas con la Base de Datos (Tablas Corruptas)

Si ves errores de SQL, puede que alguna tabla no se haya actualizado bien.

Accede a "MySQL" en DirectAdmin y abre phpMyAdmin.
Selecciona tu base de datos de PrestaShop.
Haz clic en la pestaña "Operaciones" y busca la opción "Reparar tabla" o "Optimizar". Repara todas las tablas que aparezcan como "Dañadas".

Preguntas Frecuentes (FAQ) sobre la Actualización

¿Puedo actualizar PrestaShop desde el back-office directamente?

Sí, PrestaShop tiene un módulo llamado "1-Click Upgrade". Te avisará de nuevas versiones. Sin embargo, para tiendas con muchos módulos o personalizaciones, el método manual que te hemos explicado es más fiable y te da control total sobre el proceso, especialmente si el módulo automático falla por límites del servidor.

[INFO] ¿Qué es Syspanel y cómo se relaciona con DirectAdmin?

Syspanel es el nombre comercial que le damos a nuestro panel de control, que es una interfaz de gestión de hosting. El puerto de acceso por defecto es el 2106 (por ejemplo, tudominio.com:2106). Si tu hosting usa Syspanel, la interfaz es muy similar a DirectAdmin, y los pasos para subir archivos y gestionar bases de datos serán prácticamente idénticos. Busca las secciones "Administrador de Archivos" y "MySQL" dentro de Syspanel.

¿Qué pasa si mi versión de PrestaShop es muy antigua (ej. 1.6)?

Si vienes de una versión 1.6, el proceso es más delicado. Te recomiendo encarecidamente que actualices primero a la última versión de la rama 1.6, luego a la última de la 1.7, y luego a la rama 1.8 si existe. Saltar directamente es la causa número uno de errores fatales. Si tienes dudas, considera contratar un servicio de migración profesional.

¿Perderé mis productos y pedidos durante la actualización?

No, si sigues los pasos de esta guía. El proceso de actualización modifica la estructura de la base de datos, pero no borra los datos (productos, pedidos, clientes). La clave está en no borrar la base de datos y en no sobrescribir la carpeta img que contiene las fotos de tus productos. La copia de seguridad es tu red de seguridad por si algo falla.

¿Cuánto tiempo tarda el proceso completo?

El tiempo puede variar enormemente. La subida de archivos es lo que más tarda (depende de tu conexión y del tamaño de tu tienda). La actualización de la base de datos suele tardar entre 5 y 15 minutos. En total, calcula entre 1 y 2 horas para hacerlo con calma y sin prisas.

¿Es necesario actualizar el tema y los módulos?

Sí, es altamente recomendable. Un tema o un módulo desactualizado