L'applicazione viene aggiornata dall'amministratore nella scheda Impostazioni → Aggiornamenti. Gli aggiornamenti si scaricano dal server del produttore. La maggior parte delle versioni si installa con un clic (installazione automatica, senza FTP); alcuni pacchetti si caricano manualmente via FTP - l'applicazione stessa indica quale via riguarda quella versione.

Gli aggiornamenti richiedono una licenza valida (la stessa che sblocca il salvataggio nell'applicazione). Senza di essa l'elenco delle versioni non viene scaricato.

Controllo e notifica automatici

L'applicazione controlla da sola la disponibilità di aggiornamenti - non serve più entrare ogni volta nelle impostazioni:

  • dopo l'accesso (all'ingresso nell'applicazione),
  • periodicamente, mentre l'applicazione resta aperta,
  • al ritorno sulla scheda del browser (se è passato un po' di tempo dall'ultimo controllo).

Quando esce una nuova versione, l'amministratore vedrà una breve notifica („Aggiornamento disponibile - la versione X.Y.Z è pronta per l'installazione") con il pulsante Mostra, che apre subito Impostazioni → Aggiornamenti. La notifica appare una volta per ogni versione (non si ripete a ogni accesso) - per la versione successiva ne riceverai una nuova.

Indicatore di nuova versione

Indipendentemente dalla notifica, quando è disponibile una versione più recente, l'amministratore vede un pallino rosso sull'icona dell'ingranaggio (⚙) nel menu superiore, e dopo aver aperto le impostazioni - lo stesso pallino accanto alla scheda Aggiornamenti. Il pallino scompare automaticamente dopo l'installazione dell'ultima versione. L'indicatore (e la notifica) sono visibili solo agli amministratori.

Controllo delle versioni disponibili

  1. Clicca sull'icona dell'ingranaggio (⚙) → scheda Aggiornamenti.

Versione di sviluppo. Se l'applicazione funziona in modalità sviluppo (codice direttamente dal repository), il controllo degli aggiornamenti è disattivato: non c'è pallino rosso né notifiche, e la scheda indica chiaramente che stai lavorando su una versione di sviluppo.

  1. Clicca Controlla aggiornamenti. Vedrai:
    • Versione installata - la versione attiva sul server,
    • Versione del codice - la versione dei file dell'applicazione,
    • Versioni disponibili - l'elenco delle versioni più recenti con la Lista delle modifiche (changelog) di ciascuna.

Le versioni si installano una alla volta - è attivo solo il pulsante della versione successiva. Le altre si sbloccano dopo il caricamento della precedente.

Scaricamento del pacchetto

  1. Alla versione disponibile più vicina clicca Scarica.
  2. Apparirà un avviso di copia di backup - prima dell'aggiornamento esegui un backup del database e della cartella allegati (uploads/). Conferma per continuare.
  3. Il server scaricherà il pacchetto e ne verificherà il checksum (SHA‑256). Poi, a seconda del tipo di pacchetto:
    • Pacchetto con installazione automatica - apparirà il pulsante Installa (descritto sotto). Non devi caricare nulla via FTP.
    • Pacchetto da caricare manualmente - il browser salverà il file .zip sul tuo disco (se necessario lo riscaricherai con il pulsante Salva pacchetto (.zip)) e mostrerà le istruzioni FTP.

Installazione con un clic (installazione automatica)

Per le versioni che supportano l'installazione automatica (la maggior parte degli aggiornamenti) non serve l'FTP:

  1. Dopo lo scaricamento clicca Installa.
  2. Apparirà una barra di avanzamento („Installazione in corso…") che mostra le fasi: migrazioni del database → copia dei file → finalizzazione.
  3. Al termine il pulsante diventerà Aggiorna applicazione - cliccalo per caricare la nuova versione (puoi anche aggiornare la pagina con Ctrl/Cmd + Shift + R).

L'installatore non tocca i tuoi dati - ignora includes/config.php, uploads/, storage/ e logs/, ed esegue da solo le eventuali migrazioni del database. Vale comunque la pena avere una copia di backup (avviso al momento dello scaricamento).

Attenzione: la barra di avanzamento è pienamente „in tempo reale" solo a partire dal momento in cui la versione installata contiene già questo meccanismo. Nell'installazione da una versione precedente la barra può mostrare l'avanzamento a scatti.

Installazione via FTP (pacchetti senza installazione automatica)

Quando il pacchetto non supporta l'installazione automatica, l'applicazione mostrerà le istruzioni per il caricamento manuale:

  1. Esegui una copia di backup del database e della cartella uploads/ (se non l'hai ancora fatto).
  2. Estrai il file .zip scaricato.
  3. Collegati all'hosting via FTP e carica il contenuto del pacchetto nella cartella dell'applicazione, sovrascrivendo i file esistenti.
  4. NON sovrascrivere (conserva i tuoi):
    • includes/config.php - configurazione e segreti,
    • uploads/ - allegati e avatar,
    • storage/ - dati operativi,
    • logs/ - log.
  5. Aggiorna l'applicazione nel browser (Ctrl/Cmd + Shift + R) e clicca di nuovo Controlla aggiornamenti per confermare il nuovo numero di versione.

Se la versione introduce modifiche al database, le istruzioni di quella versione (changelog / nota di versione) indicheranno passaggi aggiuntivi. In caso di dubbio, ripristina prima la copia di backup e contatta il fornitore.

Domande frequenti

  • „Impossibile connettersi al server degli aggiornamenti" - controlla la connessione internet e se la licenza è valida. L'elenco delle versioni viene fornito solo alle installazioni con una chiave valida.
  • „Hai la versione più recente" - non c'è una versione più nuova di quella installata.
  • La versione non è cambiata dopo il caricamento - assicurati che i file siano finiti nella cartella giusta e aggiorna la pagina ignorando la cache (Ctrl/Cmd + Shift + R).