L'applicazione viene aggiornata dall'amministratore nella scheda Impostazioni → Aggiornamenti. Gli aggiornamenti si scaricano dal server del produttore. Le nuove versioni si installano con un clic (auto-installer, di solito senza FTP). Via FTP si caricano i file alla prima installazione del programma; in fase di aggiornamento l'assistenza tecnica torna utile quando il server non permette all'applicazione di sovrascrivere i propri file. Se il pacchetto scaricato non avesse l'auto-installer, l'applicazione mostrerà le istruzioni per il caricamento via FTP.

Il download degli aggiornamenti richiede una licenza attiva (la stessa che sblocca il salvataggio nell'applicazione). L'elenco delle versioni viene reso disponibile dal server del produttore solo per la chiave associata al dominio di questa installazione. Quando il diritto agli aggiornamenti registrato nella chiave scade, il pulsante della nuova versione mostra lo stato Bloccato, e il motivo è visibile sotto il numero di versione e passando il cursore sul pulsante.

Con una licenza con aggiornamenti fino a una data conta la data di pubblicazione della versione (visibile accanto a ogni versione nell'elenco): la licenza copre le versioni pubblicate entro la fine del diritto, non quelle più recenti. Il programma continua a funzionare - semplicemente non potrai scaricare le versioni più recenti finché non rinnovi il diritto (nuova chiave dal fornitore, vedi il capitolo sulla licenza). L'ultimo aggiornamento del periodo coperto conviene installarlo prima della sua scadenza: il server del produttore di solito rende disponibile solo l'ultima versione, quindi dopo quella data potrebbe non mostrare più quella precedente.

Controllo e notifica automatici

L'applicazione verifica 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 direttamente Impostazioni → Aggiornamenti. La notifica viene mostrata una volta per ogni versione (non infastidisce a ogni accesso) - alla versione successiva ne riceverai una nuova.

Se la nuova versione non può essere installata (ad esempio il diritto agli aggiornamenti è scaduto), la notifica lo dice chiaramente: "La versione X.Y.Z è disponibile, ma non può essere installata: …" insieme al motivo. Quando gli aggiornamenti non sono disponibili a causa della chiave di licenza (chiave mancante, non riconosciuta, revocata, associata a un altro dominio o sconosciuta al server), l'amministratore riceve un unico avviso Aggiornamenti non disponibili con la spiegazione - il successivo solo quando il problema scompare e poi ritorna.

Indicatore di nuova versione

Indipendentemente dalla notifica, quando è disponibile una versione più recente, l'amministratore vede un puntino rosso sull'icona a forma di ruota dentata (⚙) nel menu superiore, e dopo l'apertura delle impostazioni - lo stesso puntino accanto alla scheda Aggiornamenti. Il puntino scompare automaticamente dopo l'installazione della versione più recente. 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 in esecuzione sul server,
    • Versione del codice - la versione dei file dell'applicazione,
    • Versioni disponibili - elenco delle versioni più recenti con il registro delle modifiche (changelog) di ciascuna di esse.

Le versioni si installano una dopo l'altra - è attivo solo il pulsante della versione successiva. Le successive si sbloccano dopo aver caricato la precedente.

Task Manager: scheda Aggiornamenti con l'elenco delle versioni e il pulsante di installazione.
Scheda Aggiornamenti: versione sul server, nuove versioni ed elenco delle modifiche.

Scaricamento del pacchetto

  1. Alla versione disponibile più vicina clicca Scarica.
  2. Comparirà un avviso sul backup - prima dell'aggiornamento esegui il backup del database e della cartella degli 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 installer automatico - apparirà il pulsante Installa (descrizione sotto). Non devi caricare nulla via FTP.
    • Pacchetto da caricare manualmente - il browser salverà il file .zip sul tuo disco (se necessario potrai scaricarlo di nuovo con il pulsante Salva pacchetto (.zip)) e mostrerà le istruzioni FTP.

Installazione con un clic (installazione automatica)

Per le versioni che supportano l'auto-installazione non ti serve l'FTP:

  1. Dopo lo scaricamento clicca Installa.
  2. Verrà visualizzata una barra di avanzamento («Installazione in corso…») con le varie fasi: migrazione del database → copia dei file → completamento.
  3. Al termine il pulsante si trasformerà in Aggiorna applicazione - clicca per caricare la nuova versione (puoi anche aggiornare la pagina con Ctrl/Cmd + Shift + R).

L'installer non tocca i tuoi dati - ignora includes/config.php, uploads/, storage/ e logs/, ed esegue da solo eventuali migrazioni del database. È comunque consigliabile avere un backup (avviso al momento del download).

Nota: la barra di avanzamento è davvero «in tempo reale» solo a partire dal momento in cui la versione installata include già questo meccanismo. Se installi da una versione precedente, l'avanzamento potrebbe essere mostrato a salti.

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 di lavoro,
    • 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" - verifica la connessione a internet e che la licenza sia valida. L'elenco delle versioni viene fornito solo alle installazioni con chiave valida. Il programma aggiunge tra parentesi, dopo la parola "dettagli", la descrizione tecnica dell'errore di connessione (ad es. "Could not resolve host…") - utile per l'assistenza tecnica dell'hosting.
  • "Hai la versione più recente" - non esiste una versione più recente di quella installata. Questo messaggio compare solo quando il server ha riconosciuto la chiave - in caso di problema con la chiave vedrai uno dei messaggi seguenti.
  • "Questa installazione non ha una chiave di licenza…" - inserisci la chiave in Impostazioni → Avanzate → Licenza; senza di essa l'applicazione non interroga nemmeno il server sulle versioni.
  • "Il server degli aggiornamenti non riconosce la chiave di licenza…" - la firma della chiave non corrisponde a quella del server del produttore (chiave danneggiata o proveniente da un'altra fonte). Inserisci la chiave ricevuta dal fornitore oppure contattalo.
  • "La chiave di licenza di questa installazione non è presente nel database del server degli aggiornamenti…" - la chiave è corretta, ma il server del produttore non la conosce. Il fornitore deve registrarla oppure emetterne una nuova.
  • "La chiave di licenza… è stata revocata…" - il fornitore ha revocato questa chiave (di solito dopo averne emessa una nuova). Inserisci la nuova chiave.
  • "La chiave di licenza è assegnata a un altro dominio…" - la chiave è stata emessa per un indirizzo diverso da quello su cui funziona il programma. Chiedi al fornitore una chiave per questo dominio.
  • „La versione X.Y.Z è disponibile, ma non è possibile installarla: il tuo diritto agli aggiornamenti è scaduto il GG.MM.AAAA…” - la versione è stata pubblicata dopo la scadenza del diritto agli aggiornamenti. Il programma continua a funzionare; per installarla, rinnova il diritto (nuova chiave dal fornitore). Di solito l'elenco non mostra più la versione precedente del periodo di diritto - il server del produttore mette a disposizione solo l'ultima versione pubblicata.
  • "Sul server manca l'estensione PHP "zip"..." - senza questa estensione l'applicazione non riesce a decomprimere il pacchetto. Attivala nel pannello dell'hosting (impostazioni PHP → estensioni) e riprova. L'applicazione lo verifica prima di scaricare il pacchetto.
  • 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).
  • Messaggio sui diritti di scrittura (ad es. "Impossibile sovrascrivere il file … (diritti di scrittura?)") - il server non permette all'applicazione di salvare i propri file. Correggi i permessi della cartella dell'applicazione nel pannello dell'hosting oppure via FTP e ripeti l'aggiornamento. Le migrazioni già eseguite non verranno ripetute.
  • „Il server dell'applicazione ha restituito una risposta inattesa (HTTP …)” - il programma sul tuo server si è interrotto con un errore prima di poter rispondere (durante il controllo o il download di un aggiornamento). La causa viene registrata nel log degli errori PHP dell'hosting - fornisci quel log al supporto tecnico.
  • Pulsante „Bloccato” - il motivo è indicato sotto il numero di versione (e passando il cursore sul pulsante): bisogna prima installare una versione precedente, la licenza non copre più questo aggiornamento (ad esempio il diritto agli aggiornamenti è scaduto) oppure la versione non ha una firma valida dell'editore.