Documentazione · Documentazione tecnica

Comportamento di disinstallazione e pulizia

Questo documento spiega esattamente cosa succede quando il plugin ADP Car Market Hub viene eliminato da un sito WordPress, inclusi quali dati vengono sempre rimossi, quali dati vengono rimossi solo quando l'opzione di pulizia è abilitata e come vengono gestite le installazioni multisito.

Quando utilizzare questo documento

Leggi questo documento se hai la necessità di:

Pianificare una rimozione pulita del plugin da un sito di produzione.
Capire se l'eliminazione del plugin manterrà o distruggerà i veicoli importati, i lead o le impostazioni.
Verificare la conformità al GDPR / protezione dei dati per la rimozione del plugin.
Migrare un sito a un altro plugin e hai bisogno di sapere cosa viene lasciato nel database.

Panoramica

Il plugin include uno script uninstall.php che WordPress viene eseguito automaticamente quando il plugin viene eliminato da Plugin → Plugin installati. Lo script:

Rimuove sempre i transient del plugin e annulla la pianificazione degli eventi WP-Cron del plugin.
Elimina sempre le tabelle di database personalizzate del plugin, incluse quelle che contengono dati dei visitatori o dati personali.
Rimuove opzionalmente i post creati dal plugin (veicoli, lead, allegati importati, pagine create dal plugin) quando l'impostazione Delete data on uninstall è abilitata.
Rimuove sempre l'insieme completo delle opzioni del plugin.
Rimuove sempre l'insieme completo delle opzioni del plugin.

L'intento è orientato alla privacy per impostazione predefinita: tutti i dati raccolti dal plugin sui visitatori (eventi di tracciamento, iscrizioni degli agenti di ricerca) vengono rimossi incondizionatamente, mentre i contenuti creati sopra i dati importati (che un cliente potrebbe voler conservare anche dopo aver disinstallato l'importatore) vengono rimossi solo quando il cliente sceglie esplicitamente di farlo.

Cosa viene sempre rimosso

Indipendentemente dall'impostazione Delete data on uninstall, la procedura di disinstallazione esegue quanto segue:

Transient:
as24ci_access_token — token di accesso AutoScout24 memorizzato nella cache.
as24ci_cron_import_running — blocco dell'esecuzione dell'importazione.
as24ci_image_queue_running — blocco del worker della coda immagini.
Eventi WP-Cron:
as24ci_scheduled_import — importazione pianificata principale.
as24ci_daily_cleanup — pulizia per la conservazione dei dati di tracciamento.
Tabelle personalizzate:
<prefix>as24ci_analytics — eventi di tracciamento dei visitatori.
<prefix>as24_vehicles — tabella dei dati dei campi del veicolo.
<prefix>as24ci_search_agents — iscrizioni alle ricerche salvate (contiene indirizzi email e criteri di ricerca).
<prefix>as24ci_content_studio_assets — asset di Content Studio.
<prefix>as24ci_content_studio_jobs — job di Content Studio.
Opzioni della versione dello schema:
as24ci_vehicles_db_version.
as24ci_search_agent_db_version.
as24ci_content_studio_db_version.
Opzioni del plugin: ogni chiave dichiarata da AS24CI\Options::get_all_keys(), più un piccolo set di chiavi non costanti aggiunte esplicitamente: as24ci_models_cache_keys, as24ci_page_archive_id, as24ci_page_compare_id, as24ci_page_favorites_id, la chiave legacy as24ci_api_total_cache e le impostazioni di Content Studio (as24ci_content_studio_db_version, as24ci_content_studio_google_api_key, as24ci_content_studio_default_language, as24ci_content_studio_default_tone, as24ci_content_studio_brand_voice, as24ci_content_studio_disclaimer_text, as24ci_content_studio_compliance_notes).

Cosa viene rimosso solo quando la pulizia opzionale è abilitata

L'impostazione as24ci_delete_data_on_uninstall controlla la pulizia distruttiva dei contenuti creati dal plugin. Quando è uguale a 1, la procedura di disinstallazione esegue inoltre:

Itera tutti i post as24ci_car (qualsiasi stato) e:
Elimina gli allegati elencati in _as24ci_image_ids (immagini importate).
Elimina l'allegato dell'immagine in evidenza del post, se presente.
Elimina il post del veicolo stesso con wp_delete_post( $id, true ).
Elimina tutti i post as24ci_lead.
Elimina le pagine create all'attivazione i cui ID sono memorizzati in as24ci_page_archive_id, as24ci_page_compare_id e as24ci_page_favorites_id.

Gli allegati delle gallerie manuali (indicati in _as24ci_manual_image_ids) non vengono intenzionalmente non eliminati. Questo protegge le immagini che un cliente ha aggiunto a mano, anche se il post del veicolo principale viene rimosso.

Gestione multisito

Su un'installazione di rete (multisito):

Lo script itera ogni sito restituito da get_sites().
Per ogni sito, esegue switch_to_blog(), avvia la pulizia distruttiva (se abilitata), elimina le tabelle per sito relative a tracciamento, veicoli, agenti di ricerca e Content Studio (job + asset), rimuove le opzioni per sito e restore_current_blog().
Dopo aver elaborato ogni sito, la funzione termina e non esegue il ramo del sito singolo.

Verifica il percorso multisito rispetto alla configurazione dei ruoli della tua rete prima di disinstallare in blocco in produzione; lo script non esegue alcuna operazione a cascata tra i siti oltre a quelle sopra elencate.

Istruzioni passo dopo passo

Rimuovere il plugin e conservare tutti i contenuti importati

(Opzionale) Apri le impostazioni del plugin e conferma che Delete data on uninstall sia impostato su off.
Vai su Plugin → Plugin installati, disattiva "ADP Car Market Hub", quindi fai clic su Elimina.
Conferma l'eliminazione. WordPress esegue uninstall.php. I post dei veicoli importati e le loro immagini rimangono nel database; le impostazioni del plugin e i dati dei visitatori vengono rimossi.

Rimuovere il plugin e tutti i contenuti creati dal plugin

Apri le impostazioni del plugin.
Abilita Delete data on uninstall.
Salva le modifiche.
Vai su Plugin → Plugin installati, disattiva il plugin, quindi fai clic su Elimina.
Conferma. WordPress esegue uninstall.php, che rimuove i veicoli importati, gli allegati importati, i lead e le pagine di archivio/confronto/preferiti create dal plugin.

Riferimento di configurazione

Chiave opzione	Effetto
`as24ci_delete_data_on_uninstall`	Quando impostato su `1`, rimuove anche i post importati, gli allegati importati, i post dei lead e le pagine create dal plugin al momento della disinstallazione. Valore predefinito: `0`.

Per l'elenco completo delle opzioni del plugin, consulta Options And Settings Storage.

Note operative

La disinstallazione viene eseguita in uno speciale contesto WordPress con bootstrap limitato. Lo script evita di caricare dipendenze pesanti ed è prudente riguardo alle classi mancanti (un elenco di opzioni hardcoded viene utilizzato come fallback se AS24CI\Options non può essere caricato).
Le eliminazioni delle tabelle personalizzate vengono eseguite con DROP TABLE IF EXISTS grezzo sul nome della tabella con prefisso. Gli host che limitano i privilegi di modifica dello schema potrebbero generare avvisi in questa fase; l'eliminazione viene eseguita come tentativo migliore e non interrompe la disinstallazione.
Le immagini importate a cui fanno riferimento altri post (ad esempio riutilizzate come immagini in evidenza in contenuti non correlati) verranno comunque rimosse quando la pulizia opzionale è abilitata. Verifica il riutilizzo degli allegati importati prima di abilitare l'opzione.
Le immagini delle gallerie manuali rimangono nella libreria multimediale di WordPress anche quando la pulizia opzionale è abilitata; rimuovile separatamente se necessario.
Gli URL dei webhook e i segreti condivisi sono memorizzati nelle opzioni del plugin e pertanto vengono rimossi incondizionatamente al momento della disinstallazione. I sistemi esterni smetteranno di ricevere eventi non appena il plugin viene eliminato.
La sola disattivazione (senza eliminazione) non esegue uninstall.php. Cancella solo gli eventi WP-Cron in sospeso e aggiorna le regole di riscrittura.

Risoluzione dei problemi

I veicoli importati rimangono dopo la disinstallazione — l'opzione Delete data on uninstall era disattivata quando il plugin è stato eliminato. Ripristina temporaneamente il plugin per accedere all'interfaccia di amministrazione, abilita l'opzione e quindi eliminalo di nuovo. In alternativa, rimuovi manualmente i post as24ci_car con WP-CLI.
Le tabelle personalizzate esistono ancora dopo la disinstallazione — l'utente del database non dispone dei privilegi DROP. Elimina le tabelle manualmente con un account privilegiato.
La disinstallazione multisito ha lasciato dati in alcuni siti — conferma che l'amministratore di rete abbia eseguito l'eliminazione. Le disinstallazioni per singolo sito avviate dagli amministratori del sito non sempre si propagano a cascata sulla rete, a seconda della versione di WordPress. Verifica il comportamento corrente rispetto alla tua versione di WordPress prima di grandi distribuzioni.
Le opzioni del plugin riappaiono dopo la reinstallazione — sono state ricreate dall'attivazione. La pulizia viene eseguita solo sull'eliminazione, non sulla disattivazione.