Backup e ripristino

Questo documento spiega quali dati il plugin ADP Car Market Hub crea o gestisce, quali componenti devono essere inclusi in un backup e come ripristinare un sito a uno stato funzionante dopo un guasto o una migrazione.

Quando utilizzare questo documento

Leggi questo documento se sei un amministratore del sito, un tecnico di hosting o uno sviluppatore WordPress responsabile della strategia di backup e del disaster recovery su un sito che esegue il plugin. Consultalo prima di eseguire un aggiornamento del plugin, una migrazione del server o qualsiasi modifica significativa della configurazione.

Panoramica

Il plugin memorizza i dati in diverse posizioni all'interno dell'installazione di WordPress. Un backup completo e ripristinabile deve includere tutti questi componenti. Il plugin stesso non fornisce i propri strumenti di backup; i backup dipendono dall'approccio di backup standard di WordPress utilizzato dal tuo fornitore di hosting o dal plugin di backup.

Gli annunci di veicoli importati possono essere reimportati da AutoScout24 in caso di smarrimento, ma solo se è disponibile una connessione API valida. La configurazione del plugin, i lead, i dati analitici e i file di log non possono essere recuperati da AutoScout24 e devono essere protetti dal backup del sito.

Cosa memorizza il plugin

Requisiti

• Una soluzione di backup per WordPress in grado di eseguire il backup sia del database che del file system (cartella uploads). Gli esempi includono snapshot a livello di hosting, servizi di backup gestiti o plugin di backup per WordPress. Verifica questo comportamento e la compatibilità con il tuo ambiente attuale.
• Accesso in scrittura all'ambiente di staging o di ripristino per i test di ripristino.
• La stessa versione di PHP e la stessa versione di WordPress della produzione quando si esegue il ripristino in un ambiente di test, per evitare problemi di compatibilità.

Procedura di backup

Backup del database

1. Esegui il backup dell'intero database di WordPress. Questo acquisisce wp_options (impostazioni del plugin), wp_posts e wp_postmeta (post ancora dei veicoli e lead) e tutte le tabelle personalizzate gestite dal plugin ({prefix}as24_vehicles, {prefix}as24ci_analytics, {prefix}as24ci_search_agents, {prefix}as24ci_content_studio_jobs, {prefix}as24ci_content_studio_assets).
2. Utilizza uno strumento di backup o uno snapshot di hosting che esporti un dump SQL completo. I backup parziali che includono solo tabelle selezionate potrebbero escludere le tabelle personalizzate.
3. Sulle installazioni multisito di WordPress, ogni sito della rete ha il proprio set di tabelle {prefix}_{siteid}_. Conferma che il tuo strumento di backup acquisisca tutte le tabelle del sito.

Backup dei file

1. Esegui il backup della directory wp-content/uploads/ di WordPress. Questa contiene: - Tutte le immagini dei veicoli importate (allegate ai post dei veicoli). - La directory dei log del plugin: as24ci-logs/. Questa directory è protetta dall'accesso pubblico tramite un file .htaccess; conferma che il tuo strumento di backup acquisisca i file nascosti.
2. Esegui il backup della directory del plugin wp-content/plugins/adp-car-market-hub/ se hai apportato modifiche personalizzate a livello di file (ad esempio, sovrascritture di template personalizzati). Tieni presente che la directory del plugin stessa viene normalmente sostituita durante gli aggiornamenti e non dovrebbe essere il luogo principale per le personalizzazioni.

Nota sulla configurazione

Le credenziali API del plugin (Client ID, Client Secret) sono memorizzate nelle opzioni di WordPress e sono incluse nel backup del database. Si tratta di valori sensibili. Assicurati che i file di backup del database siano archiviati in modo sicuro e che l'accesso sia limitato.

Procedura di ripristino

Ripristino completo del sito

1. Ripristina il database dal backup utilizzando il pannello di controllo dell'hosting, phpMyAdmin o un client MySQL da riga di comando.
2. Ripristina la directory wp-content/uploads/ dal backup dei file.
3. Se esegui il ripristino su un nuovo server o dominio, aggiorna l'URL del sito WordPress nel database (righe wp_options siteurl e home) utilizzando la CLI di WordPress (wp option update) o modificando direttamente il database.
4. Svuota qualsiasi cache degli oggetti di WordPress dopo il ripristino.
5. Accedi all'amministrazione di WordPress e naviga su ADP Car Market Hub → System & Help per verificare lo stato della connessione API.
6. Apri ADP Car Market Hub → Import & Limits e conferma che la pianificazione dell'importazione sia attiva.
7. Avvia un'importazione manuale dalla scheda Import & Limits e verifica che i veicoli vengano creati o aggiornati correttamente.

Ripristino parziale: solo impostazioni

Se è necessario ripristinare solo le impostazioni del plugin (ad esempio, dopo un'errata configurazione accidentale):

1. Importa il backup del database in un database temporaneo o di staging.
2. Estrai le righe wp_options pertinenti con chiavi con prefisso as24ci_ utilizzando una query SQL o uno strumento di confronto database.
3. Applica i valori delle opzioni recuperati al database di produzione.
4. Testa la connessione e la pipeline di importazione prima di confermare che il ripristino sia completo.

Ripristino solo delle immagini dei veicoli

Se le immagini dei veicoli sono state eliminate accidentalmente dalla libreria multimediale:

1. Ripristina il backup dei file wp-content/uploads/ per recuperare i file di immagine originali.
2. In alternativa, esegui nuovamente l'importazione con l'importazione delle immagini abilitata. L'importatore controlla gli URL di origine degli allegati esistenti (post meta _as24ci_source_url) e salta le immagini già presenti. Le immagini mancanti verranno scaricate nuovamente da AutoScout24.

Note operative

• Il plugin non può gestire o pianificare i backup in modo indipendente. La responsabilità del backup spetta al proprietario del sito, al fornitore di hosting o a un plugin di backup dedicato per WordPress.
• La tabella di analisi ({prefix}as24ci_analytics) e la tabella degli agenti di ricerca ({prefix}as24ci_search_agents) contengono dati personali (eventi dei visitatori, indirizzi email degli iscritti). Gestisci i file di backup contenenti queste tabelle in conformità con le normative sulla privacy applicabili.
• La tabella di analisi viene sempre eliminata dalla routine di disinstallazione del plugin, anche se l'opzione Delete data on uninstall è disabilitata. Se intendi conservare i dati di analisi durante una reinstallazione del plugin, esporta o conserva la tabella manualmente prima di disinstallare.
• Le immagini dei veicoli importate dal plugin sono tracciate nei post meta sotto _as24ci_image_ids. Questi ID collegano i post dei veicoli ai loro allegati nella libreria multimediale. Se questo post meta non è presente in un ripristino, le immagini potrebbero rimanere nella libreria multimediale come allegati orfani.
• I file di log in as24ci-logs/ non sono critici per il ripristino delle funzionalità del sito, ma possono contenere informazioni diagnostiche utili. Se è necessario conservare più di 7 giorni di cronologia dei log, copia i file di log archiviati in uno spazio di archiviazione a lungo termine prima che il plugin li elimini.

Risoluzione dei problemi

Documenti correlati

• Processo di aggiornamento
• Manutenzione mensile
• Disinstallazione e pulizia dei dati
• Registrazione e monitoraggio