Documentazione · Operazioni e manutenzione
Disinstallazione e pulizia dei dati
Questo documento descrive cosa succede quando il plugin ADP Car Market Hub viene disattivato o disinstallato, quali dati vengono rimossi, quali vengono conservati e come controllare il comportamento di pulizia. Copre anche i rischi e le opzioni di ripristino.
Quando utilizzare questo documento
Leggere questo documento prima di disinstallare il plugin da un sito di produzione. È particolarmente importante se si desidera preservare i dati dei veicoli importati, i lead o i dati di analytics dopo la rimozione del plugin, o se è necessario comprendere cosa verrà eliminato automaticamente.
Panoramica
La routine di disinstallazione del plugin viene eseguita quando un amministratore elimina il plugin tramite Amministratore WordPress → Plugin → Elimina. La routine è definita in uninstall.php e viene eseguita nel contesto dell'amministratore WordPress.
La semplice disattivazione del plugin non elimina alcun dato. La rimozione dei dati avviene solo quando il plugin viene eliminato (non solo disattivato).
La routine di disinstallazione distingue tra:
- Elementi che vengono sempre rimossi — indipendentemente da qualsiasi impostazione
- Elementi che vengono rimossi in modo condizionale — solo se l'opzione Elimina i dati alla disinstallazione è abilitata
- Elementi che non vengono mai rimossi dalla routine di disinstallazione
Cosa viene sempre rimosso alla disinstallazione
I seguenti elementi vengono sempre eliminati quando il plugin viene rimosso, indipendentemente dall'impostazione Elimina i dati alla disinstallazione:
| Elemento | Dettagli |
|---|---|
| Tutte le opzioni del plugin | Tutte le righe wp_options con chiavi aventi prefisso as24ci_, incluse credenziali API, impostazioni di importazione, configurazione della pianificazione, impostazioni di design, impostazioni del modulo lead e impostazioni di analytics |
Tabella del database: {prefix}as24ci_analytics | Rimossa incondizionatamente poiché contiene i dati di tracciamento dei visitatori e non deve persistere dopo la rimozione del plugin |
Tabella del database: {prefix}as24_vehicles | Rimossa incondizionatamente (dati dei campi del veicolo utilizzati per la visualizzazione e la ricerca) |
Tabella del database: {prefix}as24ci_search_agents | Rimossa incondizionatamente poiché contiene dati personali (nome dell'iscritto, email, preferenze di ricerca) |
Tabella del database: {prefix}as24ci_content_studio_jobs | Rimossa incondizionatamente (record dei job di generazione di contenuti AI di Content Studio) |
Tabella del database: {prefix}as24ci_content_studio_assets | Rimossa incondizionatamente (asset di marketing generati da Content Studio: didascalie, hashtag, testo alternativo, riferimenti alle immagini) |
| Opzioni della versione dello schema | as24ci_vehicles_db_version, as24ci_search_agent_db_version e as24ci_content_studio_db_version vengono eliminate insieme alle relative tabelle |
| Eventi WP-Cron | as24ci_scheduled_import e as24ci_daily_cleanup vengono annullati dalla pianificazione |
| Transient | as24ci_access_token, as24ci_cron_import_running, as24ci_image_queue_running vengono eliminati |
Queste eliminazioni non possono essere annullate. Se è necessario conservare i dati di analytics o i dati dei campi del veicolo, esportarli dal database prima di procedere con la disinstallazione.
Cosa viene rimosso in modo condizionale alla disinstallazione
I seguenti elementi vengono eliminati solo se l'opzione Elimina i dati alla disinstallazione (as24ci_delete_data_on_uninstall) è impostata su 1 (abilitata):
| Elemento | Dettagli |
|---|---|
Post dei veicoli (CPT: as24ci_car) | Tutti i post del custom post type as24ci_car, in qualsiasi stato (pubblicato, bozza, cestinato), vengono eliminati in modo permanente |
| Immagini dei veicoli importate | Gli allegati tracciati nei meta del post _as24ci_image_ids per ciascun post del veicolo vengono eliminati in modo permanente dalla libreria multimediale di WordPress |
| Immagini in evidenza | Se l'immagine in evidenza del post del veicolo è un allegato importato, viene anch'essa eliminata |
Post dei lead (CPT: as24ci_lead) | Tutti i post del custom post type as24ci_lead vengono eliminati in modo permanente |
| Pagine create all'attivazione | La pagina dell'archivio, la pagina di confronto e la pagina dei preferiti create dal plugin all'attivazione (ID memorizzati in as24ci_page_archive_id, as24ci_page_compare_id e as24ci_page_favorites_id) vengono eliminate in modo permanente |
Se questa opzione è disabilitata (impostazione predefinita), tutti i post dei veicoli, le immagini e i lead rimangono nel database e nella libreria multimediale di WordPress dopo l'eliminazione del plugin. Non saranno accessibili tramite l'interfaccia utente di amministrazione del plugin, ma i dati sottostanti di WordPress vengono preservati.
Cosa non viene mai rimosso
I seguenti elementi non vengono eliminati dalla routine di disinstallazione, indipendentemente dalle impostazioni:
| Elemento | Dettagli |
|---|---|
| Immagini della galleria caricate manualmente | Gli allegati tracciati in _as24ci_manual_image_ids (immagini aggiunte manualmente tramite la libreria multimediale di WordPress, non importate da AutoScout24) non vengono mai eliminati |
| Account utente WordPress | A tutti gli utenti a cui è stata concessa la funzionalità manage_as24_imports viene conservata tale voce di funzionalità nei meta utente di WordPress |
| File di log | La directory {uploads}/as24ci-logs/ e il suo contenuto non vengono eliminati dalla routine di disinstallazione. Se necessario, eliminarli manualmente tramite SFTP o il file manager dell'hosting |
| Dati memorizzati nella cache degli oggetti | Le cache degli oggetti esterne (come Redis o Memcached) possono conservare i dati transienti relativi al plugin fino alla loro naturale scadenza |
Come controllare il comportamento di pulizia
L'opzione Elimina i dati alla disinstallazione si trova nella scheda Impostazioni del plugin.
- Aprire ADP Car Market Hub → Impostazioni.
- Trovare l'interruttore o la casella di controllo Elimina i dati alla disinstallazione.
- Abilitarla se si desidera che tutti i post dei veicoli importati, le immagini, i lead e le pagine di attivazione vengano rimossi quando il plugin viene eliminato.
- Lasciarla disabilitata (impostazione predefinita) se si desidera preservare il contenuto importato dopo la rimozione del plugin.
Raccomandazione: Per un sito di test o di staging in cui i dati importati possono essere scartati, abilitare questa opzione prima di disinstallare. Per un sito di produzione in cui la cronologia delle importazioni potrebbe essere riutilizzata o verificata, lasciarla disabilitata e gestire la rimozione dei contenuti manualmente.
Comportamento in ambiente Multisite
Sulle installazioni multisito di WordPress, la routine di disinstallazione viene eseguita una volta per ciascun sito della rete. Per ogni sito:
- Se Elimina i dati alla disinstallazione è abilitato, i post dei veicoli, le immagini, i lead e le pagine di attivazione vengono eliminati per quel sito.
- Le tabelle personalizzate del database (
as24ci_analytics,as24_vehicles,as24ci_search_agents,as24ci_content_studio_jobs,as24ci_content_studio_assets) vengono rimosse per quel sito (sempre). - Tutte le opzioni del plugin per quel sito vengono eliminate (sempre).
Il ciclo multisito utilizza switch_to_blog() / restore_current_blog() per elaborare ciascun sito in modo indipendente.
Procedura passo-passo: disinstallazione sicura in produzione
- Effettuare un backup completo del database e della directory dei caricamenti prima di procedere. Vedere Backup e ripristino.
- Se si desidera preservare i dati dei veicoli, lasciare disabilitata l'opzione Elimina i dati alla disinstallazione (impostazione predefinita). Se si desidera una rimozione completa, abilitarla ora.
- Se è necessario conservare i dati di analytics per la reportistica, esportare la tabella
{prefix}as24ci_analyticsdal database utilizzando phpMyAdmin, la CLI di WordPress o lo strumento del database dell'hosting prima di procedere. Questa tabella viene sempre rimossa al momento della disinstallazione. - Navigare su Amministratore WordPress → Plugin.
- Disattivare prima il plugin, quindi fare clic su Elimina.
- Confermare la richiesta di eliminazione. La routine di disinstallazione verrà eseguita automaticamente.
- Verificare il risultato: - Navigare su Amministratore WordPress → Strumenti → Database (o uno strumento di database) e confermare che le tabelle personalizzate siano state rimosse. - Se l'opzione Elimina i dati alla disinstallazione era abilitata, verificare che la pagina dell'archivio veicoli non esista più. - Se i dati sono stati conservati, confermare che i post dei veicoli siano ancora presenti in Amministratore WordPress → Post o visitando direttamente l'URL dell'archivio.
- Eliminare manualmente la directory dei log tramite SFTP se non è più necessaria:
{wp-content/uploads}/as24ci-logs/.
Note operative e rischi
- La tabella di analytics (
{prefix}as24ci_analytics) viene sempre rimossa al momento della disinstallazione senza preavviso, anche se l'opzione Elimina i dati alla disinstallazione è disabilitata. Se si dispone di dati di analytics che si desidera conservare, esportarli prima di eliminare il plugin. - Allo stesso modo, la tabella dei veicoli (
{prefix}as24_vehicles), la tabella degli agenti di ricerca ({prefix}as24ci_search_agents) e le due tabelle di Content Studio ({prefix}as24ci_content_studio_jobs,{prefix}as24ci_content_studio_assets) vengono sempre rimosse. - Le immagini importate ed eliminate dalla routine di disinstallazione vengono rimosse in modo permanente dal filesystem del server. Non possono essere recuperate dalla libreria multimediale di WordPress.
- Se la funzione
get_sites()non è disponibile su un'installazione multisito, la routine di disinstallazione ripiega sul comportamento per sito singolo e processed solo il sito corrente. - Le chiavi delle opzioni ripulite al momento della disinstallazione sono derivate dalla classe
Optionsa runtime, in modo che l'elenco sia sempre aggiornato con la versione del plugin installata. Viene utilizzato un elenco hard-coded di ripiego se la classeOptionsnon può essere caricata. - La disattivazione del plugin senza la sua eliminazione non esegue la routine di disinstallazione. Nessun dato viene rimosso al momento della disattivazione. Il plugin può essere riattivato in qualsiasi momento e riprenderà il normale funzionamento.
Risoluzione dei problemi
| Sintomo | Causa probabile | Verifica |
|---|---|---|
| I post dei veicoli sono ancora presenti dopo la disinstallazione | L'opzione Delete data on uninstall era disabilitata (impostazione predefinita) | Comportamento previsto; eliminare i post manualmente o riabilitare l'opzione ed eliminare nuovamente |
| Dati di analytics mancanti dopo la disinstallazione | La tabella di analytics viene sempre rimossa al momento della disinstallazione | Esportare la tabella prima di eliminare il plugin |
| File di log ancora presenti dopo la disinstallazione | I file di log non vengono rimossi dalla routine di disinstallazione | Eliminare la directory as24ci-logs/ manualmente tramite SFTP |
| Immagini caricate manualmente eliminate | Verificare che siano state aggiunte tramite _as24ci_manual_image_ids, non importate tramite _as24ci_image_ids | Se eliminate accidentalmente, ripristinarle da un backup |
| Opzioni del plugin ancora presenti dopo la disinstallazione | La routine di disinstallazione non è stata completata (errore PHP durante l'eliminazione) | Controllare il registro degli errori PHP; attivare nuovamente reinstallando ed eliminando di nuovo |
| Tabelle personalizzate ancora presenti nel database | La routine di disinstallazione ha riscontrato un errore di autorizzazione del database | Eseguire DROP TABLE IF EXISTS {prefix}as24ci_analytics manualmente |