Processo di aggiornamento

Questo documento descrive il processo raccomandato per l'aggiornamento del plugin ADP Car Market Hub su un sito WordPress di produzione. Seguire un processo di aggiornamento strutturato riduce il rischio di perdita di dati, modifiche alla configurazione o regressioni del frontend.

Quando utilizzare questo documento

Leggi questo documento ogni volta che è disponibile una nuova versione del plugin e devi applicarla a un sito live. Leggilo anche prima di qualsiasi aggiornamento programmato del core di WordPress che potrebbe influire sulla compatibilità del plugin.

Panoramica

Gli aggiornamenti del plugin possono includere correzioni di bug, patch di sicurezza, nuove funzionalità o modifiche allo schema del database. Il plugin gestisce le migrazioni dello schema del database automaticamente all'attivazione e su plugins_loaded, ma per modifiche significative di versione si raccomanda vivamente un test in un ambiente di staging prima della distribuzione in produzione.

Il processo generale è: esaminare il changelog → eseguire un backup → testare in staging → applicare in produzione → verificare il funzionamento.

Requisiti

• Accesso come amministratore all'amministrazione di WordPress sia sull'ambiente di staging che sull'ambiente di produzione.
• Un backup completo recente del database di produzione e della directory degli upload (vedi Backup e ripristino).
• Un ambiente di staging che rispecchi il sito di produzione. Se non esiste un ambiente di staging, esegui un backup completo prima di aggiornare e preparati a un eventuale rollback.
• La funzionalità manage_as24_imports sull'account che esegue l'aggiornamento.

Istruzioni passo-passo

Passo 1: Esaminare le note di rilascio

1. Leggi le note di rilascio per la nuova versione (vedi Note di rilascio).
2. Identifica eventuali modifiche significative (breaking changes), migrazioni di database o passaggi di configurazione elencati nelle note di rilascio.
3. Prendi nota di eventuali nuovi requisiti di versione PHP o di versione WordPress. Il plugin richiede PHP 8.1 o successivo e WordPress 6.2 o successivo a partire dalla versione 1.0.0. Controlla l'intestazione del file del plugin o readme.txt per i requisiti attualmente dichiarati.

Passo 2: Eseguire un backup completo

1. Esegui il backup del database di produzione e della directory wp-content/uploads/ prima di apportare qualsiasi modifica.
2. Prendi nota della versione corrente del plugin in modo da poter ripristinare ad essa in caso di necessità.
3. Memorizza il backup in una posizione accessibile anche nel caso in cui l'amministrazione di WordPress diventi non disponibile (ad esempio, un backup a livello di hosting o un download locale).

Passo 3: Testare l'aggiornamento in staging

1. Applica la nuova versione del plugin al sito di staging.
2. Se il sito di staging non riflette lo stato di produzione corrente, ripristina un backup di produzione recente in staging prima di applicare l'aggiornamento.
3. Dopo l'aggiornamento in staging, verifica quanto segue: - Le pagine di amministrazione del plugin si caricano senza errori PHP o schermate bianche. - La scheda Health non mostra nuovi problemi critici. - Lo stato della connessione API è Connesso nella scheda Sistema e Supporto. - Un'importazione manuale si completa con successo (usa il pulsante Avvia importazione ora in Automazione). - Gli annunci dei veicoli importati vengono visualizzati correttamente nell'archivio frontend e nelle pagine del singolo veicolo. - Il modulo di contatto per i lead viene inviato correttamente e recapita un'email di notifica. - Gli eventi di tracciamento di Analytics vengono registrati (se Analytics è abilitato).
4. Se riscontri problemi in staging, non procedere in produzione. Segnala il problema e attendi una correzione o indicazioni.

Passo 4: Applicare l'aggiornamento in produzione

Opzione A: Aggiornamento tramite l'amministrazione di WordPress

1. Accedi all'amministrazione di WordPress di produzione.
2. Naviga su Bacheca → Aggiornamenti (o Plugin → Plugin installati).
3. Individua ADP Car Market Hub nell'elenco degli aggiornamenti e fai clic su Aggiorna.
4. WordPress disattiverà il plugin, sostituirà i file del plugin e lo riattiverà. L'hook di attivazione del plugin esegue automaticamente le migrazioni dello schema e delle opzioni.

Opzione B: Aggiornamento manuale dei file

1. Metti il sito in modalità di manutenzione se il tuo flusso di lavoro lo richiede.
2. Scarica il pacchetto della nuova versione del plugin.
3. Tramite SFTP o il file manager del tuo hosting, sostituisci il contenuto di wp-content/plugins/adp-car-market-hub/ con i file della nuova versione.
4. L'hook plugins_loaded del plugin attiverà le migrazioni dello schema al servizio della successiva richiesta WordPress.

Passo 5: Verificare l'aggiornamento in produzione

1. Apri ADP Car Market Hub → Sistema e Supporto e conferma che lo stato della connessione API sia Connesso.
2. Controlla la scheda Bacheca e conferma che il conteggio dei veicoli e le informazioni sull'ultima esecuzione siano presenti.
3. Apri la scheda Log e conferma che non ci siano nuovi errori correlati all'aggiornamento.
4. Naviga nella pagina dell'archivio veicoli sul frontend e conferma che gli annunci vengano caricati correttamente.
5. Se il numero di versione del plugin è visualizzato in qualsiasi punto dell'amministrazione (ad esempio, nella scheda Health o Supporto), conferma che mostri la nuova versione.
6. Avvia un'importazione manuale dalla scheda Importazione e Limiti e conferma che si completi senza errori.

Passo 6: Monitorare per 24–48 ore

1. Dopo l'aggiornamento in produzione, esegui i controlli giornalieri standard (vedi Operazioni quotidiane) per i successivi uno o due giorni.
2. Monitora la presenza di nuovi errori nella scheda Log.
3. Conferma che le importazioni pianificate continuino a essere eseguite puntualmente.

Riferimento di configurazione

Note operative

• Il plugin utilizza gli hook plugins_loaded e admin_init per controllare e applicare le migrazioni dello schema del database. Gli aggiornamenti dello schema vengono eseguiti automaticamente e non richiedono l'esecuzione manuale di query SQL.
• Il plugin registra una funzionalità personalizzata (manage_as24_imports) durante l'attivazione. Se questa funzionalità risulta mancante dopo un aggiornamento, disattiva e riattiva il plugin per attivare la registrazione della funzionalità.
• Il plugin memorizza una versione del database nella tabella delle opzioni di WordPress (as24ci_db_version). Il plugin legge questo valore e applica eventuali migrazioni in sospeso quando rileva una discrepanza di versione.
• I template personalizzati sovrascritti e memorizzati al di fuori della directory del plugin (ad esempio, in un tema child) non sono influenzati dagli aggiornamenti del plugin. Tuttavia, se l'aggiornamento modifica la struttura dei template, potrebbe essere necessario aggiornare i template personalizzati per adeguarli.
• La coda delle immagini, i transient di blocco dell'importazione e il token di accesso memorizzato nella cache non sono influenzati dagli aggiornamenti del plugin. I processi di importazione in corso dovrebbero completarsi normalmente.

Ripristino (Rolling back)

Se l'aggiornamento in produzione causa problemi ed è necessario un ripristino:

1. Ripristina il backup del database eseguito al Passo 2.
2. Ripristina i file del plugin precedenti dal backup o scaricando la versione precedente.
3. La versione precedente del plugin rileverà lo stato del database ripristinato e i dati saranno coerenti.
4. Esamina la causa del problema prima di tentare nuovamente l'aggiornamento.

Risoluzione dei problemi

Documenti correlati

• Backup e ripristino
• Manutenzione mensile
• Registrazione e monitoraggio