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, einschliesslich der Frage, welche Daten immer entfernt werden, welche Daten nur entfernt werden, wenn das Opt-in-Bereinigungs-Flag aktiviert ist, und wie Multisite-Installationen gehandhabt werden.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie Folgendes tun müssen:

Eine saubere Entfernung des Plugins von einer Live-Website planen.
Verstehen, ob das Löschen des Plugins importierte Fahrzeuge, Leads oder Einstellungen beibehält oder zerstört.
Die Einhaltung der DSGVO / des Datenschutzes bei der Plugin-Entfernung überprüfen.
Eine Website auf ein anderes Plugin migrieren 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 bricht die geplanten WP-Cron-Events des Plugins ab.
Löscht immer die benutzerdefinierten Datenbanktabellen des Plugins, einschliesslich 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 den vollständigen Satz an Plugin-Optionen.

Die Absicht ist standardmässig datenschutzorientiert (Privacy-First): Alle Daten, die das Plugin über Besucher sammelt (Analytics-Events, Suchabo-Anmeldungen), werden bedingungslos entfernt, während Inhalte, die auf der Grundlage importierter Daten erstellt wurden (die ein Kunde möglicherweise auch nach der Deinstallation des Importers behalten möchte), nur dann entfernt werden, wenn der Kunde dies explizit wünscht.

Was immer entfernt wird

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

Transients:
as24ci_access_token — zwischengespeichertes AutoScout24-Access-Token.
as24ci_cron_import_running — Importlauf-Sperre.
as24ci_image_queue_running — Sperre für den Image-Queue-Worker.
WP-Cron-Events:
as24ci_scheduled_import — geplanter Hauptimport.
as24ci_daily_cleanup — Bereinigung der Analytics-Aufbewahrung.
Benutzerdefinierte Tabellen:
<prefix>as24ci_analytics — Tracking-Events für Besucher.
<prefix>as24_vehicles — Tabelle für Fahrzeugfelddaten.
<prefix>as24ci_search_agents — Suchabo-Abonnements (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 eine kleine Reihe von nicht-konstanten Schlüsseln, die explizit angehängt werden: 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, falls 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 von _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 switch_to_blog() es, führt die destruktive Bereinigung aus (falls aktiviert), löscht die Website-spezifischen Tabellen für Analytics, Fahrzeuge, Suchabos 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 Zweig für Einzel-Websites 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 websiteü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 deaktiviert ist.
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 ihre 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, was importierte Fahrzeuge, importierte Anhänge, Leads und die vom Plugin erstellten Archiv-/Vergleichs-/Favoritenseiten entfernt.

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.

Betriebliche Hinweise

Die Deinstallation wird in einem speziellen WordPress-Kontext mit eingeschränktem Bootstrap ausgeführt. 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. Hosts, 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, die von anderen Beiträgen referenziert werden (z. B. als Beitragsbilder in nicht verwandten Inhalten wiederverwendet werden), 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 Events 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-Events 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-Benutzeroberflä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-Berechtigungen. Löschen Sie die Tabellen manuell mit einem privilegierten Konto.
Multisite-Deinstallation hat auf einigen Websites Daten hinterlassen — bestätigen Sie, dass der Netzwerkadministrator das Löschen ausgefü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 Ihres WordPress-Releases vor grossen Rollouts.
Plugin-Optionen erscheinen nach der Neuinstallation wieder — sie wurden durch die Aktivierung neu erstellt. Die Bereinigung wird nur beim Löschen ausgeführt, nicht beim Deaktivieren.