Dokumentation · Technische Dokumentation

Deinstallations- und Bereinigungsverhalten

Dieses Dokument erklärt genau, was passiert, wenn das ADP Car Market Hub-Plugin von einer WordPress-Website gelöscht wird, einschließlich der Frage, welche Daten immer entfernt werden, welche Daten nur entfernt werden, wenn die Opt-in-Bereinigungsoption aktiviert ist, und wie Multisite-Installationen gehandhabt werden.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie:

Eine saubere Entfernung des Plugins von einer Live-Website planen.
Verstehen möchten, ob das Löschen des Plugins importierte Fahrzeuge, Anfragen (Leads) oder Einstellungen behält oder zerstört.
Die Einhaltung der DSGVO / des Datenschutzes bei der Plugin-Entfernung prüfen möchten.
Eine Website auf ein anderes Plugin migrieren möchten und wissen müssen, was zurückbleibt.

Übersicht

Das Plugin wird mit einem uninstall.php-Skript ausgeliefert, das WordPress automatisch ausgeführt wird, wenn das Plugin unter Plugins → Installierte Plugins gelöscht wird. Das Skript:

Entfernt immer die Transients des Plugins und hebt die Planung der WP-Cron-Ereignisse des Plugins auf.
Löscht immer die benutzerdefinierten Datenbanktabellen des Plugins, einschließlich derer, die Besucher- oder personenbezogene Daten enthalten.
Entfernt optional vom Plugin erstellte Beiträge (Fahrzeuge, Leads, importierte Anhänge, vom Plugin erstellte Seiten), wenn die Einstellung Daten bei Deinstallation löschen aktiviert ist.
Entfernt immer alle Plugin-Optionen.

Das Prinzip ist standardmäßig datenschutzfreundlich (Privacy-First): Alle Daten, die das Plugin über Besucher sammelt (Analytics-Ereignisse, Suchauftrag-Abonnements), werden bedingungslos entfernt, während Inhalte, die auf importierten Daten aufbauen (die ein Kunde möglicherweise auch nach der Deinstallation des Importers behalten möchte), nur dann entfernt werden, wenn der Kunde dies explizit auswählt.

Was immer entfernt wird

Unabhängig von der Einstellung Daten bei Deinstallation löschen führt die Deinstallationsroutine Folgendes aus:

Transients:
as24ci_access_token — zwischengespeicherter AutoScout24-Zugriffstoken.
as24ci_cron_import_running — Importlauf-Sperre (Lock).
as24ci_image_queue_running — Bild-Warteschlangen-Worker-Sperre.
WP-Cron-Ereignisse:
as24ci_scheduled_import — geplanter Hauptimport.
as24ci_daily_cleanup — Bereinigung der Analytics-Aufbewahrung.
Benutzerdefinierte Tabellen:
<prefix>as24ci_analytics — Tracking-Ereignisse für Besucher.
<prefix>as24_vehicles — Tabelle für Fahrzeugfelddaten.
<prefix>as24ci_search_agents — Abonnements für gespeicherte Suchen (enthält E-Mail-Adressen und Suchkriterien).
<prefix>as24ci_content_studio_assets — Content Studio-Assets.
<prefix>as24ci_content_studio_jobs — Content Studio-Jobs.
Schema-Versionsoptionen:
as24ci_vehicles_db_version.
as24ci_search_agent_db_version.
as24ci_content_studio_db_version.
Plugin-Optionen: Jeder Schlüssel, der von AS24CI\Options::get_all_keys() deklariert wird, plus ein kleiner Satz explizit angehängter nicht-konstanter Schlüssel: as24ci_models_cache_keys, as24ci_page_archive_id, as24ci_page_compare_id, as24ci_page_favorites_id, das veraltete as24ci_api_total_cache und die Content Studio-Einstellungen (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).

Was nur entfernt wird, wenn das Opt-in aktiviert ist

Die Einstellung as24ci_delete_data_on_uninstall steuert die destruktive Bereinigung von vom Plugin erstellten Inhalten. Wenn sie 1 entspricht, führt die Deinstallationsroutine zusätzlich Folgendes aus:

Durchläuft alle as24ci_car-Beiträge (jeder Status) und:
Löscht die in _as24ci_image_ids aufgelisteten Anhänge (importierte Bilder).
Löscht das Beitragsbild (Featured Image) des Beitrags, sofern vorhanden.
Löscht den Fahrzeugbeitrag selbst mit wp_delete_post( $id, true ).
Löscht alle as24ci_lead-Beiträge.
Löscht bei der Aktivierung erstellte Seiten, deren IDs in as24ci_page_archive_id, as24ci_page_compare_id und as24ci_page_favorites_id gespeichert sind.

Manuelle Galerie-Anhänge (referenziert aus _as24ci_manual_image_ids) werden absichtlich nicht gelöscht. Dies schützt Bilder, die ein Kunde manuell hinzugefügt hat, selbst wenn der übergeordnete Fahrzeugbeitrag entfernt wird.

Multisite-Handhabung

Bei einer Netzwerkinstallation:

Das Skript durchläuft jede von get_sites() zurückgegebene Website.
Für jede Website führt es switch_to_blog() aus, startet die destruktive Bereinigung (falls aktiviert), löscht die Website-spezifischen Tabellen für Analytics, Fahrzeuge, Suchaufträge und Content Studio (Jobs + Assets), entfernt Website-spezifische Optionen und restore_current_blog().
Nach der Verarbeitung aller Websites kehrt die Funktion zurück und führt den Einzel-Website-Zweig nicht aus.

Überprüfen Sie den Multisite-Pfad anhand der Rollenkonfiguration Ihres Netzwerks, bevor Sie eine Massendeinstallation in der Live-Umgebung durchführen; das Skript führt keine standortübergreifenden Kaskadierungen durch, die über die oben aufgeführten Operationen hinausgehen.

Schritt-für-Schritt-Anleitung

Das Plugin entfernen und alle importierten Inhalte behalten

(Optional) Öffnen Sie die Einstellungen des Plugins und vergewissern Sie sich, dass Daten bei Deinstallation löschen auf aus steht.
Gehen Sie zu Plugins → Installierte Plugins, deaktivieren Sie "ADP Car Market Hub" und klicken Sie dann auf Löschen.
Bestätigen Sie das Löschen. WordPress führt uninstall.php aus. Importierte Fahrzeugbeiträge und deren Bilder verbleiben in der Datenbank; Plugin-Einstellungen und Besucherdaten werden entfernt.

Das Plugin und alle vom Plugin erstellten Inhalte entfernen

Öffnen Sie die Einstellungen des Plugins.
Aktivieren Sie Daten bei Deinstallation löschen.
Speichern Sie.
Gehen Sie zu Plugins → Installierte Plugins, deaktivieren Sie das Plugin und klicken Sie dann auf Löschen.
Bestätigen Sie. WordPress führt uninstall.php aus, wodurch importierte Fahrzeuge, importierte Anhänge, Leads und die vom Plugin erstellten Archiv-/Vergleichs-/Favoritenseiten entfernt werden.

Konfigurationsreferenz

Optionsschlüssel	Auswirkung
`as24ci_delete_data_on_uninstall`	Wenn `1`, werden bei der Deinstallation auch importierte Beiträge, importierte Anhänge, Lead-Beiträge und vom Plugin erstellte Seiten entfernt. Standardwert ist `0`.

Die vollständige Liste der Plugin-Optionen finden Sie unter Speicherung von Optionen und Einstellungen.

Betriebshinweise

Die Deinstallation läuft in einem speziellen WordPress-Kontext mit eingeschränktem Bootstrap. Das Skript vermeidet das Laden schwerer Abhängigkeiten und verhält sich defensiv gegenüber fehlenden Klassen (eine fest codierte Optionsliste wird als Fallback verwendet, wenn AS24CI\Options nicht geladen werden kann).
Das Löschen benutzerdefinierter Tabellen wird mit rohem DROP TABLE IF EXISTS auf den Tabellennamen mit Präfix ausgeführt. Hoster, die Berechtigungen zur Schemaänderung einschränken, können hier Warnungen erzeugen; das Löschen erfolgt nach dem Best-Effort-Prinzip und bricht die Deinstallation nicht ab.
Importierte Bilder, auf die von anderen Beiträgen verwiesen wird (z. B. als Beitragsbilder in nicht verwandten Inhalten wiederverwendet), werden dennoch entfernt, wenn die Opt-in-Bereinigung aktiviert ist. Überprüfen Sie die Wiederverwendung importierter Anhänge, bevor Sie sich dafür entscheiden.
Manuelle Galeriebilder verbleiben in der WordPress-Mediathek, selbst wenn die Opt-in-Bereinigung aktiviert ist; entfernen Sie diese bei Bedarf separat.
Webhook-URLs und Shared Secrets werden in den Plugin-Optionen gespeichert und daher bei der Deinstallation bedingungslos entfernt. Externe Systeme empfangen keine Ereignisse mehr, sobald das Plugin gelöscht ist.
Die reine Deaktivierung (ohne Löschen) führt uninstall.php nicht aus. Sie löscht nur anstehende WP-Cron-Ereignisse und aktualisiert die Rewrite-Rules.

Fehlerbehebung

Importierte Fahrzeuge verbleiben nach der Deinstallation — *Daten bei Deinstallation löschen* war deaktiviert, als das Plugin gelöscht wurde. Stellen Sie das Plugin vorübergehend wieder her, um die Admin-Oberfläche aufzurufen, aktivieren Sie den Schalter und löschen Sie es erneut. Alternativ können Sie as24ci_car-Beiträge manuell mit WP-CLI entfernen.
Benutzerdefinierte Tabellen existieren nach der Deinstallation immer noch — dem Datenbankbenutzer fehlen die DROP-Rechte. Löschen Sie die Tabellen manuell mit einem privilegierten Konto.
Multisite-Deinstallation hat auf einigen Websites Daten hinterlassen — bestätigen Sie, dass der Netzwerkadministrator die Löschung durchgeführt hat. Website-spezifische Deinstallationen, die von Website-Administratoren ausgelöst werden, kaskadieren je nach WordPress-Version nicht immer über das gesamte Netzwerk. Überprüfen Sie das aktuelle Verhalten anhand Ihrer WordPress-Version vor größeren Rollouts.
Plugin-Optionen erscheinen nach der Neuinstallation wieder — sie wurden durch die Aktivierung neu erstellt. Die Bereinigung läuft nur beim Löschen, nicht beim Deaktivieren.