Dokumentation · Betrieb und Wartung

Deinstallation und Datenbereinigung

Dieses Dokument beschreibt, was passiert, wenn das ADP Car Market Hub-Plugin deaktiviert oder deinstalliert wird, welche Daten entfernt werden, welche erhalten bleiben und wie das Bereinigungsverhalten gesteuert werden kann. Es behandelt auch Risiken und Wiederherstellungsoptionen.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, bevor Sie das Plugin von einer Live-Website deinstallieren. Dies ist besonders wichtig, wenn Sie importierte Fahrzeugdaten, Leads oder Analytics-Daten nach dem Entfernen des Plugins behalten möchten oder wenn Sie verstehen müssen, was automatisch gelöscht wird.

Übersicht

Die Deinstallationsroutine des Plugins wird ausgeführt, wenn ein Administrator das Plugin über WordPress-Admin → Plugins → Löschen löscht. Die Routine ist in uninstall.php definiert und läuft im Kontext des WordPress-Admins.

Das bloße Deaktivieren des Plugins löscht keine Daten. Eine Datenentfernung erfolgt nur, wenn das Plugin gelöscht wird (nicht nur deaktiviert).

Die Deinstallationsroutine unterscheidet zwischen:

Elementen, die immer entfernt werden – unabhängig von jeglichen Einstellungen
Elementen, die bedingt entfernt werden – nur wenn die Option Daten bei Deinstallation löschen aktiviert ist
Elementen, die niemals entfernt werden durch die Deinstallationsroutine

Was bei der Deinstallation immer entfernt wird

Die folgenden Elemente werden beim Entfernen des Plugins immer gelöscht, unabhängig von der Einstellung Daten bei Deinstallation löschen:

Element	Details
Alle Plugin-Optionen	Alle `wp_options`-Zeilen mit Schlüsseln, die das Präfix `as24ci_` tragen, einschließlich API-Zugangsdaten, Importeinstellungen, Zeitplan-Konfiguration, Design-Einstellungen, Lead-Formular-Einstellungen und Analytics-Einstellungen
Datenbanktabelle: `{prefix}as24ci_analytics`	Wird bedingungslos gelöscht, da sie Besucher-Tracking-Daten enthält und nach dem Entfernen des Plugins nicht bestehen bleiben darf
Datenbanktabelle: `{prefix}as24_vehicles`	Wird bedingungslos gelöscht (Fahrzeugfelddaten, die für Anzeige und Suche verwendet werden)
Datenbanktabelle: `{prefix}as24ci_search_agents`	Wird bedingungslos gelöscht, da sie personenbezogene Daten enthält (Name des Abonnenten, E-Mail, Suchpräferenzen)
Datenbanktabelle: `{prefix}as24ci_content_studio_jobs`	Wird bedingungslos gelöscht (Einträge der Content Studio KI-Inhaltsgenerierungs-Jobs)
Datenbanktabelle: `{prefix}as24ci_content_studio_assets`	Wird bedingungslos gelöscht (vom Content Studio generierte Marketing-Assets: Bildunterschriften, Hashtags, Alternativtexte, Bildreferenzen)
Schema-Versionsoptionen	`as24ci_vehicles_db_version`, `as24ci_search_agent_db_version` und `as24ci_content_studio_db_version` werden zusammen mit ihren Tabellen gelöscht
WP-Cron-Events	Die Zeitpläne für `as24ci_scheduled_import` und `as24ci_daily_cleanup` werden aufgehoben
Transients	`as24ci_access_token`, `as24ci_cron_import_running`, `as24ci_image_queue_running` werden gelöscht

Diese Löschungen können nicht rückgängig gemacht werden. Wenn Sie Analytics-Daten oder Fahrzeugfelddaten behalten müssen, exportieren Sie diese vor der Deinstallation aus der Datenbank.

Was bei der Deinstallation bedingt entfernt wird

Die folgenden Elemente werden nur gelöscht, wenn die Option Daten bei Deinstallation löschen (as24ci_delete_data_on_uninstall) auf 1 (aktiviert) gesetzt ist:

Element	Details
Fahrzeug-Beiträge (CPT: `as24ci_car`)	Alle Beiträge des Custom Post Type `as24ci_car`, in jedem Status (veröffentlicht, Entwurf, Papierkorb), werden dauerhaft gelöscht
Importierte Fahrzeugbilder	Anhänge, die in den `_as24ci_image_ids`-Beitragsmetadaten für jeden Fahrzeug-Beitrag erfasst sind, werden dauerhaft aus der WordPress-Mediathek gelöscht
Beitragsbilder (Featured Images)	Wenn das Beitragsbild des Fahrzeug-Beitrags ein importierter Anhang ist, wird es ebenfalls gelöscht
Lead-Beiträge (CPT: `as24ci_lead`)	Alle Beiträge des Custom Post Type `as24ci_lead` werden dauerhaft gelöscht
Bei Aktivierung erstellte Seiten	Die Archivseite, die Vergleichsseite und die Favoritenseite, die vom Plugin bei der Aktivierung erstellt wurden (IDs gespeichert in `as24ci_page_archive_id`, `as24ci_page_compare_id` und `as24ci_page_favorites_id`), werden dauerhaft gelöscht

Wenn diese Option deaktiviert ist (Standardeinstellung), verbleiben alle Fahrzeug-Beiträge, Bilder und Leads nach dem Löschen des Plugins in der WordPress-Datenbank und Mediathek. Sie sind dann zwar nicht mehr über die Admin-Benutzeroberfläche des Plugins zugänglich, aber die zugrunde liegenden WordPress-Daten bleiben erhalten.

Was niemals entfernt wird

Die folgenden Elemente werden von der Deinstallationsroutine nicht gelöscht, unabhängig von den Einstellungen:

Element	Details
Manuell hochgeladene Galeriebilder	Anhänge, die in `_as24ci_manual_image_ids` erfasst sind (Bilder, die manuell über die WordPress-Mediathek hinzugefügt und nicht aus AutoScout24 importiert wurden), werden niemals gelöscht
WordPress-Benutzerkonten	Allen Benutzern, denen die Berechtigung `manage_as24_imports` zugewiesen wurde, bleibt dieser Berechtigungseintrag in den WordPress-Benutzermetadaten erhalten
Protokolldateien (Logs)	Das Verzeichnis `{uploads}/as24ci-logs/` und dessen Inhalt werden von der Deinstallationsroutine nicht gelöscht. Löschen Sie diese bei Bedarf manuell über SFTP oder den Datei-Manager Ihres Hostings
Im Object Cache verbleibende Cache-Daten	Externe Object Caches (wie Redis oder Memcached) können pluginbezogene transiente Daten behalten, bis diese auf natürliche Weise ablaufen

Wie Sie das Bereinigungsverhalten steuern

Die Option Daten bei Deinstallation löschen befindet sich im Einstellungs-Tab des Plugins.

Öffnen Sie ADP Car Market Hub → Einstellungen.
Suchen Sie den Umschalter oder das Kontrollkästchen Daten bei Deinstallation löschen.
Aktivieren Sie die Option, wenn Sie möchten, dass alle importierten Fahrzeug-Beiträge, Bilder, Leads und Aktivierungsseiten gelöscht werden, sobald das Plugin gelöscht wird.
Lassen Sie sie deaktiviert (Standardeinstellung), wenn Sie die importierten Inhalte nach dem Entfernen des Plugins erhalten möchten.

Empfehlung: Aktivieren Sie diese Option vor der Deinstallation auf einer Test- oder Staging-Website, auf der importierte Daten verworfen werden können. Lassen Sie sie auf einer Live-Website, auf der der Importverlauf möglicherweise wiederverwendet oder geprüft werden muss, deaktiviert und verwalten Sie die Entfernung von Inhalten manuell.

Verhalten bei Multisite-Installationen

Bei WordPress-Multisite-Installationen läuft die Deinstallationsroutine einmal pro Website im Netzwerk. Für jede Website gilt:

Wenn Daten bei Deinstallation löschen aktiviert ist, werden Fahrzeug-Beiträge, Bilder, Leads und Aktivierungsseiten für diese Website gelöscht.
Die benutzerdefinierten Datenbanktabellen (as24ci_analytics, as24_vehicles, as24ci_search_agents, as24ci_content_studio_jobs, as24ci_content_studio_assets) werden für diese Website gelöscht (immer).
Alle Plugin-Optionen für diese Website werden gelöscht (immer).

Die Multisite-Schleife verwendet switch_to_blog() / restore_current_blog(), um jede Website unabhängig voneinander zu verarbeiten.

Schritt-für-Schritt: Sichere Deinstallation im Live-Betrieb

Erstellen Sie ein vollständiges Backup der Datenbank und des Upload-Verzeichnisses, bevor Sie fortfahren. Siehe Backup und Wiederherstellung.
Wenn Sie die Fahrzeugdaten erhalten möchten, lassen Sie Daten bei Deinstallation löschen deaktiviert (Standardeinstellung). Wenn Sie eine vollständige Bereinigung wünschen, aktivieren Sie die Option jetzt.
Wenn Sie Analytics-Daten für Berichte aufbewahren müssen, exportieren Sie vor dem Fortfahren die Tabelle {prefix}as24ci_analytics über phpMyAdmin, die WordPress-CLI oder das Datenbank-Tool Ihres Hostings aus der Datenbank. Diese Tabelle wird bei der Deinstallation immer gelöscht.
Navigieren Sie zu WordPress-Admin → Plugins.
Deaktivieren Sie zuerst das Plugin und klicken Sie dann auf Löschen.
Bestätigen Sie die Sicherheitsabfrage zum Löschen. Die Deinstallationsroutine wird automatisch ausgeführt.
Überprüfen Sie das Ergebnis: - Navigieren Sie zu WordPress-Admin → Werkzeuge → Datenbank (oder nutzen Sie ein Datenbank-Tool) und stellen Sie sicher, dass die benutzerdefinierten Tabellen entfernt wurden. - Wenn Daten bei Deinstallation löschen aktiviert war, überprüfen Sie, ob die Fahrzeug-Archivseite nicht mehr existiert. - Wenn die Daten erhalten wurden, vergewissern Sie sich, dass die Fahrzeug-Beiträge unter WordPress-Admin → Beiträge noch vorhanden sind oder rufen Sie die Archiv-URL direkt auf.
Löschen Sie das Protokollverzeichnis manuell über SFTP, falls es nicht mehr benötigt wird: {wp-content/uploads}/as24ci-logs/.

Betriebshinweise und Risiken

Die Analytics-Tabelle ({prefix}as24ci_analytics) wird bei der Deinstallation immer ohne Vorwarnung gelöscht, selbst wenn Daten bei Deinstallation löschen deaktiviert ist. Wenn Sie Analytics-Daten behalten möchten, exportieren Sie diese vor dem Löschen des Plugins.
Ebenso werden die Fahrzeugtabelle ({prefix}as24_vehicles), die Suchagenten-Tabelle ({prefix}as24ci_search_agents) und die beiden Content Studio-Tabellen ({prefix}as24ci_content_studio_jobs, {prefix}as24ci_content_studio_assets) immer gelöscht.
Importierte Bilder, die durch die Deinstallationsroutine gelöscht werden, werden dauerhaft aus dem Dateisystem des Servers entfernt. Sie können nicht aus der WordPress-Mediathek wiederhergestellt werden.
Wenn die Funktion get_sites() auf einer Multisite-Installation nicht verfügbar ist, fällt die Deinstallationsroutine auf das Einzel-Website-Verhalten zurück und verarbeitet nur die aktuelle Website.
Die bei der Deinstallation bereinigten Optionsschlüssel werden zur Laufzeit aus der Klasse Options abgeleitet, sodass die Liste immer auf dem Stand der installierten Plugin-Version ist. Eine fest codierte Fallback-Liste wird verwendet, falls die Klasse Options nicht geladen werden kann.
Das Deaktivieren des Plugins ohne es zu löschen führt die Deinstallationsroutine nicht aus. Bei der Deaktivierung werden keine Daten entfernt. Das Plugin kann jederzeit wieder aktiviert werden und nimmt den normalen Betrieb wieder auf.

Fehlerbehebung

Symptom	Wahrscheinliche Ursache	Prüfung
Fahrzeug-Beiträge nach Deinstallation immer noch vorhanden	`Delete data on uninstall` war deaktiviert (Standardeinstellung)	Erwartetes Verhalten; löschen Sie die Beiträge manuell oder aktivieren Sie die Option erneut und löschen Sie das Plugin noch einmal
Analytics-Daten fehlen nach der Deinstallation	Die Analytics-Tabelle wird bei der Deinstallation immer gelöscht	Exportieren Sie die Tabelle vor dem Löschen des Plugins
Protokolldateien nach Deinstallation immer noch vorhanden	Protokolldateien werden von der Deinstallationsroutine nicht entfernt	Löschen Sie das Verzeichnis `as24ci-logs/` manuell über SFTP
Manuell hochgeladene Bilder wurden gelöscht	Prüfen Sie, ob diese über `_as24ci_manual_image_ids` hinzugefügt und nicht über `_as24ci_image_ids` importiert wurden	Falls versehentlich gelöscht, stellen Sie sie aus einem Backup wieder her
Plugin-Optionen nach Deinstallation immer noch vorhanden	Die Deinstallationsroutine wurde nicht vollständig ausgeführt (PHP-Fehler beim Löschen)	Überprüfen Sie das PHP-Fehlerprotokoll; stoßen Sie den Vorgang erneut an, indem Sie das Plugin neu installieren und wieder löschen
Benutzerdefinierte Tabellen immer noch in der Datenbank vorhanden	Bei der Deinstallationsroutine ist ein Datenbank-Berechtigungsfehler aufgetreten	Führen Sie `DROP TABLE IF EXISTS {prefix}as24ci_analytics` manuell aus