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:

  1. Elementi che vengono sempre rimossi — indipendentemente da qualsiasi impostazione
  2. Elementi che vengono rimossi in modo condizionale — solo se l'opzione Elimina i dati alla disinstallazione è abilitata
  3. 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:

ElementoDettagli
Tutte le opzioni del pluginTutte 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_analyticsRimossa incondizionatamente poiché contiene i dati di tracciamento dei visitatori e non deve persistere dopo la rimozione del plugin
Tabella del database: {prefix}as24_vehiclesRimossa incondizionatamente (dati dei campi del veicolo utilizzati per la visualizzazione e la ricerca)
Tabella del database: {prefix}as24ci_search_agentsRimossa incondizionatamente poiché contiene dati personali (nome dell'iscritto, email, preferenze di ricerca)
Tabella del database: {prefix}as24ci_content_studio_jobsRimossa incondizionatamente (record dei job di generazione di contenuti AI di Content Studio)
Tabella del database: {prefix}as24ci_content_studio_assetsRimossa incondizionatamente (asset di marketing generati da Content Studio: didascalie, hashtag, testo alternativo, riferimenti alle immagini)
Opzioni della versione dello schemaas24ci_vehicles_db_version, as24ci_search_agent_db_version e as24ci_content_studio_db_version vengono eliminate insieme alle relative tabelle
Eventi WP-Cronas24ci_scheduled_import e as24ci_daily_cleanup vengono annullati dalla pianificazione
Transientas24ci_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):

ElementoDettagli
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 importateGli 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 evidenzaSe 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'attivazioneLa 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:

ElementoDettagli
Immagini della galleria caricate manualmenteGli 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 WordPressA 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 logLa 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 oggettiLe 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.

  1. Aprire ADP Car Market Hub → Impostazioni.
  2. Trovare l'interruttore o la casella di controllo Elimina i dati alla disinstallazione.
  3. 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.
  4. 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:

  1. 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.
  2. 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).
  3. 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

  1. Effettuare un backup completo del database e della directory dei caricamenti prima di procedere. Vedere Backup e ripristino.
  2. 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.
  3. Se è necessario conservare i dati di analytics per la reportistica, esportare la tabella {prefix}as24ci_analytics dal 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.
  4. Navigare su Amministratore WordPress → Plugin.
  5. Disattivare prima il plugin, quindi fare clic su Elimina.
  6. Confermare la richiesta di eliminazione. La routine di disinstallazione verrà eseguita automaticamente.
  7. 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.
  8. 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 Options a 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 classe Options non 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

SintomoCausa probabileVerifica
I post dei veicoli sono ancora presenti dopo la disinstallazioneL'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 disinstallazioneLa tabella di analytics viene sempre rimossa al momento della disinstallazioneEsportare la tabella prima di eliminare il plugin
File di log ancora presenti dopo la disinstallazioneI file di log non vengono rimossi dalla routine di disinstallazioneEliminare la directory as24ci-logs/ manualmente tramite SFTP
Immagini caricate manualmente eliminateVerificare che siano state aggiunte tramite _as24ci_manual_image_ids, non importate tramite _as24ci_image_idsSe eliminate accidentalmente, ripristinarle da un backup
Opzioni del plugin ancora presenti dopo la disinstallazioneLa 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 databaseLa routine di disinstallazione ha riscontrato un errore di autorizzazione del databaseEseguire DROP TABLE IF EXISTS {prefix}as24ci_analytics manualmente

Documenti correlati