La aplicación la actualiza el administrador en la pestaña Ajustes → Actualizaciones. Las actualizaciones se descargan del servidor del fabricante. Las nuevas versiones se instalan con un solo clic (auto-instalador, normalmente sin FTP). Por FTP se suben los archivos en la primera instalación del programa; en una actualización, el soporte técnico resulta útil cuando el servidor no permite que la aplicación sobrescriba sus archivos. Si el paquete descargado no tuviera auto-instalador, la aplicación mostrará las instrucciones para subirlo por FTP.

Descargar actualizaciones requiere una licencia activa (la misma que desbloquea el guardado en la aplicación). El servidor del fabricante ofrece la lista de versiones solo para la clave asignada al dominio de esta instalación. Cuando caduca el derecho a actualizaciones registrado en la clave, el botón de la nueva versión pasa a estado Bloqueado, y el motivo se muestra debajo del número de versión y al pasar el cursor sobre el botón.

Con una licencia con actualizaciones hasta una fecha, lo que cuenta es la fecha de publicación de la versión (visible junto a cada versión de la lista): la licencia incluye las versiones publicadas hasta el final del derecho, pero no las posteriores. El programa sigue funcionando - simplemente no podrás descargar las versiones más nuevas hasta que renueves el derecho (nueva clave del proveedor, ver el capítulo sobre la licencia). Conviene instalar la última actualización del periodo cubierto antes de que termine: el servidor del fabricante suele ofrecer solo la versión más reciente, así que después de esa fecha puede que ya no muestre la anterior.

Comprobación automática y notificación

La aplicación comprueba automáticamente si hay actualizaciones disponibles - ya no hace falta entrar cada vez en la configuración:

  • al iniciar sesión (al entrar en la aplicación),
  • de vez en cuando, mientras la aplicación permanece abierta,
  • al volver a la pestaña del navegador (si ha pasado un tiempo desde la última comprobación).

Cuando aparece una nueva versión, el administrador verá una breve notificación («Actualización disponible - la versión X.Y.Z está lista para instalar») con un botón Mostrar que abre directamente Configuración → Actualizaciones. La notificación se muestra una vez por versión (no molesta en cada entrada) - cuando salga la siguiente versión recibirás una nueva.

Si no se puede instalar la nueva versión (por ejemplo, ha caducado el derecho a actualizaciones), la notificación lo indica claramente: «La versión X.Y.Z está disponible, pero no se puede instalar: …» junto con el motivo. Cuando las actualizaciones no están disponibles por un problema con la clave de licencia (falta de clave, clave no reconocida, revocada, asignada a otro dominio o desconocida para el servidor), el administrador recibe una única advertencia Actualizaciones no disponibles con la explicación - la siguiente solo cuando el problema desaparezca y vuelva a producirse.

Indicador de nueva versión

Independientemente de la notificación, cuando hay disponible una versión más reciente, el administrador ve un punto rojo en el icono de la rueda dentada (⚙) del menú superior, y al abrir los ajustes, el mismo punto junto a la pestaña Actualizaciones. El punto desaparece automáticamente al instalar la versión más reciente. El indicador (y la notificación) los ven únicamente los administradores.

Comprobación de las versiones disponibles

  1. Haz clic en el icono de la rueda dentada (⚙) → pestaña Actualizaciones.

Versión de desarrollo. Si la aplicación funciona en modo de desarrollo (código directamente desde el repositorio), la comprobación de actualizaciones está desactivada: no hay punto rojo ni notificaciones, y la pestaña indica claramente que estás trabajando con una versión de desarrollo.

  1. Haz clic en Comprobar actualizaciones. Verás:
    • Versión instalada - la versión que funciona en el servidor,
    • Versión del código - la versión de los archivos de la aplicación,
    • Versiones disponibles - lista de versiones más recientes con el Registro de cambios (changelog) de cada una.

Las versiones se instalan una tras otra - solo está activo el botón de la siguiente versión. Las demás se habilitarán tras instalar la anterior.

Task Manager: pestaña Actualizaciones con la lista de versiones y el botón de instalación.
Pestaña Actualizaciones: versión en el servidor, versiones más recientes y lista de cambios.

Descarga del paquete

  1. En la versión disponible más cercana, haz clic en Descargar.
  2. Aparecerá una advertencia sobre la copia de seguridad - antes de actualizar, haz una copia de seguridad de la base de datos y de la carpeta de adjuntos (uploads/). Confirma para continuar.
  3. El servidor descargará el paquete y verificará su suma de comprobación (SHA-256). A partir de ahí, según el tipo de paquete:
    • Paquete con instalador automático - aparecerá el botón Instalar (descripción más abajo). No necesitas subir nada por FTP.
    • Paquete para subir manualmente - el navegador guardará el archivo .zip en tu disco (si lo necesitas, puedes volver a descargarlo con el botón Guardar paquete (.zip)) y te mostrará las instrucciones de FTP.

Instalación con un clic (instalador automático)

Para las versiones que admiten auto-instalación no necesitas FTP:

  1. Tras la descarga, haz clic en Instalar.
  2. Aparecerá una barra de progreso («Instalando…») que muestra las etapas: migraciones de la base de datos → copia de archivos → finalización.
  3. Al finalizar, el botón se convertirá en Actualizar aplicación - haz clic en él para cargar la nueva versión (también puedes recargar la página con Ctrl/Cmd + Shift + R).

El instalador no toca tus datos - omite includes/config.php, uploads/, storage/ y logs/, y realiza por sí mismo las posibles migraciones de la base de datos. Aun así, conviene tener una copia de seguridad (aviso al descargar).

Nota: la barra de progreso funciona realmente «en tiempo real» solo a partir de la versión instalada que ya incluye este mecanismo. Si actualizas desde una versión anterior, es posible que el progreso avance a saltos.

Instalación por FTP (paquetes sin instalador automático)

Cuando el paquete no admite la instalación automática, la aplicación mostrará las instrucciones para la carga manual:

  1. Haz una copia de seguridad de la base de datos y de la carpeta uploads/ (si todavía no lo has hecho).
  2. Descomprime el archivo .zip descargado.
  3. Conéctate al hosting por FTP y carga el contenido del paquete en el directorio de la aplicación, sobrescribiendo los archivos existentes.
  4. NO sobrescribas (conserva los tuyos):
    • includes/config.php - configuración y secretos,
    • uploads/ - adjuntos y avatares,
    • storage/ - datos de trabajo,
    • logs/ - registros.
  5. Recarga la aplicación en el navegador (Ctrl/Cmd + Shift + R) y vuelve a hacer clic en Comprobar actualizaciones para confirmar el nuevo número de versión.

Si la versión introduce cambios en la base de datos, las instrucciones de esa versión (changelog / nota de versión) indicarán los pasos adicionales. En caso de duda, restaura primero la copia de seguridad y ponte en contacto con el proveedor.

Preguntas frecuentes

  • «No se pudo conectar con el servidor de actualizaciones» - comprueba la conexión a internet y si la licencia es válida. La lista de versiones solo se ofrece a las instalaciones con una clave válida. La descripción técnica del error de conexión (por ejemplo, «Could not resolve host…») el programa la añade entre paréntesis después de la palabra «detalles» - será útil para el soporte técnico del hosting.
  • «Tienes la versión más reciente» - no hay ninguna versión más nueva que la instalada. Este mensaje aparece únicamente cuando el servidor ha reconocido la clave - si hay un problema con la clave, verás uno de los mensajes siguientes.
  • «Esta instalación no tiene clave de licencia…» - introduce la clave en Configuración → Avanzado → Licencia; sin ella, la aplicación ni siquiera pregunta al servidor por las versiones.
  • «El servidor de actualizaciones no reconoce la clave de licencia…» - la firma de la clave no coincide con la del servidor del fabricante (clave dañada o de otro origen). Introduce la clave recibida del proveedor o ponte en contacto con él.
  • «La clave de licencia de esta instalación no está en la base de datos del servidor de actualizaciones…» - la clave es correcta, pero el servidor del fabricante no la reconoce. El proveedor debe registrarla o emitir una nueva.
  • «La clave de licencia… ha sido revocada…» - el proveedor ha revocado esta clave (normalmente después de emitir una nueva). Introduce la nueva clave.
  • «La clave de licencia está asignada a otro dominio…» - la clave se emitió para una dirección distinta de aquella en la que funciona el programa. Pide al proveedor una clave para este dominio.
  • «La versión X.Y.Z está disponible, pero no se puede instalar: tu derecho a actualizaciones terminó el DD.MM.AAAA…» - esta versión se publicó después de que terminara tu derecho a actualizaciones. El programa sigue funcionando; para instalarla, renueva el derecho (clave nueva del proveedor). Por lo general, la lista ya no muestra la versión anterior del período de tu derecho - el servidor del fabricante solo ofrece la última versión publicada.
  • «En el servidor falta la extensión PHP «zip»…» - sin esta extensión, la aplicación no puede descomprimir el paquete. Actívala en el panel de hosting (ajustes de PHP → extensiones) y vuelve a intentarlo. La aplicación lo comprueba antes de descargar el paquete.
  • La versión no ha cambiado tras la instalación - asegúrate de que los archivos se han subido al directorio correcto y recarga la página sin usar la caché (Ctrl/Cmd + Shift + R).
  • Mensaje sobre permisos de escritura (p. ej. «No se ha podido sobrescribir el archivo … (¿permisos de escritura?)») - el servidor no permite que la aplicación guarde sus archivos. Corrige los permisos del directorio de la aplicación en el panel de hosting o por FTP y repite la actualización. Las migraciones que ya se hayan ejecutado no se repetirán.
  • «El servidor de la aplicación devolvió una respuesta inesperada (HTTP …)» - el programa en tu servidor terminó con un error antes de poder responder (al comprobar o descargar actualizaciones). La causa queda registrada en el log de errores de PHP de tu hosting - compártelo con el soporte técnico.
  • Botón «Bloqueado» - el motivo aparece bajo el número de versión (y al pasar el cursor sobre el botón): hay que instalar antes una versión anterior, la licencia ya no cubre esta actualización (por ejemplo, se acabó el derecho a actualizaciones) o la versión no tiene una firma válida del editor.