Actualizar PrestaShop puede modificar archivos, estructura de base de datos, dependencias y comportamiento de módulos. En una tienda activa también existen pedidos, clientes y stock que cambian mientras trabajás. Por eso la actualización debe prepararse como una operación con respaldo, prueba, ventana de mantenimiento y plan de restauración.
Identificá la versión actual y la versión de destino
Registrá la versión exacta de PrestaShop, PHP, base de datos, tema y módulos críticos. Luego revisá las notas de la versión de destino, sus requisitos y el camino de actualización admitido.
No asumas que podés saltar varias versiones mayores en un solo paso. Una actualización menor dentro de una rama y una migración hacia una versión mayor tienen riesgos diferentes. Si el sitio utiliza una versión antigua, puede ser necesario actualizar por etapas o reconstruir componentes incompatibles.
Comprobá los requisitos del servidor
La versión de destino puede exigir otro PHP, extensiones adicionales, una base de datos más reciente o límites superiores. En cPanel podés consultar PHP y los módulos instalados y, cuando corresponda, elegir otra versión de PHP.
No cambies PHP directamente en producción antes de comprobar que la versión actual de PrestaShop, el tema y los módulos también la soporten. En algunos casos conviene actualizar primero la aplicación utilizando una versión intermedia de PHP y cambiarla después.
Inventario de módulos, tema y personalizaciones
Creá una lista con:
- módulos nativos y de terceros;
- versión y proveedor de cada módulo crítico;
- tema activo y tema hijo, si existe;
- overrides y modificaciones directas;
- integraciones con pagos, envíos, facturación y ERP;
- tareas cron y scripts externos;
- personalizaciones de correos y plantillas.
Una actualización puede completar correctamente el núcleo y aun así romper el checkout por un módulo incompatible. Confirmá por escrito la compatibilidad de cada componente esencial; que un módulo no muestre un aviso no significa que haya sido probado.
Creá un entorno de prueba
Cloná archivos y base de datos en un subdominio o entorno no público. Protegelo con contraseña, bloqueá su indexación y desactivá correos o pasarelas reales para evitar pedidos, cobros y notificaciones duplicadas.
La copia debe parecerse a producción: misma versión de PHP, módulos, tema y volumen de datos. Una instalación vacía no reproduce problemas relacionados con pedidos históricos, combinaciones o tablas grandes.
Backup completo y verificable
Antes de actualizar guardá:
- todos los archivos de PrestaShop;
- base de datos completa;
- imágenes y documentos de productos;
- configuración del servidor relevante;
- lista de versiones y credenciales necesarias para restaurar;
- logs de la actualización.
Podés generar un backup desde cPanel. Descargá o copiá el respaldo fuera de la carpeta de la tienda y verificá que pueda abrirse. Una copia que solo existe dentro de la cuenta no ayuda si se agota el espacio o se dañan sus archivos.
El backup de archivos y el de base de datos deben representar el mismo momento. Restaurar archivos antiguos sobre una base con pedidos nuevos puede dejar versiones incompatibles y perder coherencia.
Update Assistant: el reemplazo de “1-Click Upgrade”
El módulo oficial que antes se conocía como 1-Click Upgrade actualmente se denomina Update Assistant; su nombre técnico sigue siendo Autoupgrade. Permite comprobar requisitos, crear backups, actualizar y restaurar desde el Back Office o mediante CLI.
Actualizá el propio módulo Update Assistant antes de utilizarlo y confirmá que sea compatible con la versión inicial y la de destino. No descargues copias modificadas desde sitios no oficiales.
Preparar la tienda para la ventana de mantenimiento
- Anunciá una ventana de baja actividad.
- Registrá el último número de pedido y el estado del stock.
- Activá el modo mantenimiento y permití solamente tu IP.
- Detené importaciones, sincronizaciones y cron que puedan modificar datos.
- Generá el backup final coherente.
- Comprobá espacio en disco y recursos disponibles.
No realices una actualización mientras siguen entrando pedidos. Aunque el proceso termine, una restauración posterior podría eliminar operaciones producidas durante la ventana.
Opciones del asistente
Update Assistant puede ofrecer opciones para desactivar módulos no nativos, deshabilitar overrides o regenerar plantillas de correo. La elección depende de las personalizaciones:
- Desactivar módulos no nativos: reduce conflictos durante el proceso, pero luego deben reactivarse y probarse uno por uno.
- Deshabilitar overrides: ayuda a aislar incompatibilidades, aunque puede retirar temporalmente funciones personalizadas.
- Regenerar correos: puede actualizar plantillas, pero revisá si tu tienda utiliza diseños personalizados.
Leé cada advertencia y no avances si la comprobación de requisitos informa un bloqueo. Resolverlo antes es más seguro que forzar el proceso.
Durante la actualización
- No cierres ni recargues la página sin que el asistente lo indique.
- No ejecutes otra actualización en paralelo.
- No cambies PHP ni permisos mientras trabaja.
- Conservá el registro y descargá los logs si aparece un error.
- No elimines el backup hasta finalizar todas las pruebas.
Si el proceso se interrumpe, anotá la etapa exacta. Repetirlo ciegamente puede agravar una actualización parcial.
Pruebas después de actualizar
Back Office
- Ingreso de empleados y permisos.
- Productos, categorías, combinaciones y stock.
- Pedidos, clientes, facturas y devoluciones.
- Módulos, registros y páginas de configuración.
Front Office
- Portada, categorías, productos y buscador.
- Cuenta de cliente y recuperación de contraseña.
- Carrito, cupones, impuestos y transportistas.
- Checkout completo y páginas de confirmación.
- Diseño móvil, imágenes, CSS y JavaScript.
Integraciones
- Pago aprobado, pendiente y rechazado.
- Notificaciones de la pasarela.
- Correos transaccionales.
- Cron, ERP, facturación y transportistas externos.
- Analytics, píxeles y etiquetas de seguimiento.
Reactivá componentes de manera gradual
Si desactivaste módulos o overrides, reactivá primero los esenciales y probá después de cada grupo. Esto facilita identificar el componente que genera un error. No abras la tienda al público hasta completar una compra real controlada.
Cachés y registros
Después de la actualización puede ser necesario limpiar la caché de PrestaShop y, si existe, la caché externa. Hacelo una vez y comprobá el sitio. No programes purgas frecuentes como solución permanente.
Revisá los registros del Back Office, PHP y servidor. Un error que no aparece visualmente puede afectar tareas programadas, correos o módulos. No muestres errores PHP en pantalla pública.
Cuándo restaurar
Considerá restaurar si la actualización queda incompleta, la base de datos no termina de migrar o una función crítica no tiene solución dentro de la ventana prevista. Restaurá archivos y base de datos del mismo backup; reemplazar solamente archivos puede dejar el esquema de datos en una versión diferente.
Si ya ingresaron pedidos después de reabrir, detener el sitio y restaurar una copia anterior puede perderlos. Evaluá la situación antes de sobrescribir producción y conservá exportaciones de las operaciones nuevas.
Errores frecuentes
- Tiempo de ejecución agotado: revisá logs, recursos y posibilidad de utilizar CLI en actualizaciones grandes.
- Error 500: comprobá PHP, módulos, overrides y registro de errores.
- Back Office inaccesible: verificá caché, permisos y compatibilidad del tema administrativo o módulos.
- Checkout roto: desactivá temporalmente el módulo sospechoso y revisá su versión.
- Correos modificados: compará las plantillas personalizadas con las regeneradas.
- Página sin estilos: limpiá caché y comprobá generación de recursos y permisos.
Softaculous y las actualizaciones automáticas
Softaculous puede detectar instalaciones y ofrecer actualizaciones o backups. En una tienda con módulos, tema y pagos personalizados, una actualización automática no reemplaza el entorno de prueba ni la matriz de compatibilidad. Para cambios mayores, priorizá el procedimiento oficial de PrestaShop y una ventana controlada.
Lista final
- Definí versión actual, destino y camino admitido.
- Verificá PHP, base de datos, módulos, tema y overrides.
- Probá primero en una copia no pública.
- Prepará un backup completo y restaurable.
- Actualizá Update Assistant.
- Poné la tienda en mantenimiento y detené tareas externas.
- Ejecutá la actualización y conservá los logs.
- Probá Back Office, Front Office, pagos, envíos y correos.
- Reactivá componentes gradualmente.
- Reabrí únicamente cuando la compra completa funcione.
PrestaShop documenta el uso de Update Assistant desde el Back Office y el procedimiento para crear backups antes de actualizar. Consultá siempre la documentación de la versión de destino y no omitas la prueba de restauración.
