Dokumentation · Betrieb und Wartung

Backup und Wiederherstellung

Dieses Dokument erklärt, welche Daten das ADP Car Market Hub-Plugin erstellt oder verwaltet, welche Komponenten in ein Backup aufgenommen werden müssen und wie eine Website nach einem Ausfall oder einer Migration wieder in einen funktionsfähigen Zustand versetzt werden kann.

Wann dieses Dokument zu verwenden ist

Lesen Sie dieses Dokument, wenn Sie ein Website-Administrator, Hosting-Ingenieur oder WordPress-Entwickler sind, der für die Backup-Strategie und das Disaster Recovery auf einer Website verantwortlich ist, auf der das Plugin läuft. Überprüfen Sie es, bevor Sie ein Plugin-Update, eine Servermigration oder eine wesentliche Konfigurationsänderung durchführen.

Übersicht

Das Plugin speichert Daten an verschiedenen Orten innerhalb der WordPress-Installation. Ein vollständiges und wiederherstellbares Backup muss alle diese Komponenten enthalten. Das Plugin selbst bietet keine eigenen Backup-Tools; Backups hängen von dem Standard-WordPress-Backup-Ansatz ab, der von Ihrem Hosting-Anbieter oder Backup-Plugin verwendet wird.

Importierte Fahrzeugbestände können bei Verlust erneut aus AutoScout24 importiert werden, jedoch nur, wenn eine gültige API-Verbindung verfügbar ist. Plugin-Konfigurationen, Leads, Analytics-Daten und Protokolldateien können nicht aus AutoScout24 wiederhergestellt werden und müssen durch das Website-Backup geschützt werden.

Was das Plugin speichert

DatentypSpeicherortHinweise
Plugin-Einstellungen und -KonfigurationWordPress Options-Tabelle (wp_options)Allen Option-Keys ist das Präfix as24ci_ vorangestellt
Fahrzeug-Anker-BeiträgeWordPress Posts-Tabelle (wp_posts, wp_postmeta)Custom Post Type: as24ci_car. Der Beitrag fungiert als WordPress-Anker (Permalink, Taxonomien, Template) und speichert einen kleinen Satz von reinen Importer-Post-Metadaten (z. B. _as24ci_listing_id, _as24ci_content_hash, _as24ci_image_ids). Der Großteil der Fahrzeugfelddaten befindet sich in der unten stehenden benutzerdefinierten Tabelle.
FahrzeugfelddatenBenutzerdefinierte Datenbanktabelle {prefix}as24_vehiclesEine Zeile pro Fahrzeug, verknüpft mit dem as24ci_car-Beitrag über post_id. Enthält die strukturierten Fahrzeugattribute, die für die Anzeige, Archivfilter und die Suche verwendet werden.
Leads (Kontaktformular-Einsendungen)WordPress Posts-Tabelle (wp_posts, wp_postmeta)Custom Post Type: as24ci_lead
Analytics-EventsBenutzerdefinierte Datenbanktabelle {prefix}as24ci_analyticsVerfolgung von Besucher-Events; wird bei der Deinstallation des Plugins gelöscht
Suchaufträge (Suchaufträge für Besucher)Benutzerdefinierte Datenbanktabelle {prefix}as24ci_search_agentsPersonenbezogene Daten; wird bei der Deinstallation des Plugins gelöscht
Content Studio-Jobs und generierte AssetsBenutzerdefinierte Datenbanktabellen {prefix}as24ci_content_studio_jobs und {prefix}as24ci_content_studio_assetsKI-Inhaltsgenerierungs-Jobs und deren generierte Marketing-Ausgaben (Bildunterschriften, Hashtags, Alt-Texte, Bildreferenzen); beide werden bei der Deinstallation des Plugins gelöscht
Importierte FahrzeugbilderWordPress Mediathek (wp_uploads/)An Fahrzeug-Beiträge angehängt; nachverfolgt in _as24ci_image_ids
Plugin-Protokolldateien{wp-uploads}/as24ci-logs/adp-car-market-hub.logRotiert bei 10 MB; Archive werden nach 7 Tagen gelöscht
Vom Plugin erstellte SeitenWordPress Seiten in wp_postsArchivseite, Vergleichsseite und Favoritenseite; IDs sind in den Optionen as24ci_page_archive_id, as24ci_page_compare_id und as24ci_page_favorites_id gespeichert

Systemvoraussetzungen

  • Eine WordPress-Backup-Lösung, die in der Lage ist, sowohl die Datenbank als auch das Dateisystem (Uploads-Ordner) zu sichern. Beispiele hierfür sind Snapshots auf Hosting-Ebene, verwaltete Backup-Dienste oder WordPress-Backup-Plugins. Überprüfen Sie dieses Verhalten und die Kompatibilität mit Ihrer aktuellen Umgebung.
  • Schreibzugriff auf die Staging- oder Wiederherstellungsumgebung für Wiederherstellungstests.
  • Die gleiche PHP-Version und WordPress-Version wie in der Produktionsumgebung, wenn Sie eine Wiederherstellung in einer Testumgebung durchführen, um Kompatibilitätsprobleme zu vermeiden.

Backup-Verfahren

Datenbank-Backup

  1. Sichern Sie die gesamte WordPress-Datenbank. Dies erfasst wp_options (Plugin-Einstellungen), wp_posts und wp_postmeta (Fahrzeug-Anker-Beiträge und Leads) sowie alle vom Plugin verwalteten benutzerdefinierten Tabellen ({prefix}as24_vehicles, {prefix}as24ci_analytics, {prefix}as24ci_search_agents, {prefix}as24ci_content_studio_jobs, {prefix}as24ci_content_studio_assets).
  2. Verwenden Sie ein Backup-Tool oder einen Hosting-Snapshot, der einen vollständigen SQL-Dump exportiert. Partielle Backups, die nur ausgewählte Tabellen enthalten, lassen die benutzerdefinierten Tabellen möglicherweise aus.
  3. Bei WordPress-Multisite-Installationen hat jede Website im Netzwerk ihren eigenen Satz von {prefix}_{siteid}_-Tabellen. Stellen Sie sicher, dass Ihr Backup-Tool alle Website-Tabellen erfasst.

Dateisicherungs-Backup

  1. Sichern Sie das Verzeichnis WordPress wp-content/uploads/. Dieses enthält: - Alle importierten Fahrzeugbilder (die an Fahrzeug-Beiträge angehängt sind). - Das Plugin-Protokollverzeichnis: as24ci-logs/. Dieses Verzeichnis ist durch eine .htaccess-Datei vor öffentlichem Zugriff geschützt; stellen Sie sicher, dass Ihr Backup-Tool versteckte Dateien erfasst.
  2. Sichern Sie das Plugin-Verzeichnis wp-content/plugins/adp-car-market-hub/, wenn Sie benutzerdefinierte Änderungen auf Dateiebene vorgenommen haben (z. B. benutzerdefinierte Template-Overrides). Beachten Sie, dass das Plugin-Verzeichnis selbst normalerweise bei Updates ersetzt wird und nicht der primäre Ort für Anpassungen sein sollte.

Hinweis zur Konfiguration

Die API-Zugangsdaten des Plugins (Client ID, Client Secret) werden in den WordPress-Optionen gespeichert und sind im Datenbank-Backup enthalten. Dies sind sensible Werte. Stellen Sie sicher, dass Datenbank-Backup-Dateien sicher gespeichert werden und der Zugriff eingeschränkt ist.

Wiederherstellungsverfahren

Vollständige Website-Wiederherstellung

  1. Stellen Sie die Datenbank aus dem Backup über Ihr Hosting-Control-Panel, phpMyAdmin oder einen Befehlszeilen-MySQL-Client wieder her.
  2. Stellen Sie das Verzeichnis wp-content/uploads/ aus dem Datei-Backup wieder her.
  3. Wenn Sie die Wiederherstellung auf einem neuen Server oder einer neuen Domain durchführen, aktualisieren Sie die WordPress-Website-URL in der Datenbank (wp_options-Zeilen siteurl und home) mithilfe der WordPress-CLI (wp option update) oder indem Sie die Datenbank direkt bearbeiten.
  4. Löschen Sie nach der Wiederherstellung jeglichen WordPress-Objekt-Cache.
  5. Melden Sie sich im WordPress-Adminbereich an und navigieren Sie zu ADP Car Market Hub → System & Hilfe, um den Status der API-Verbindung zu überprüfen.
  6. Öffnen Sie ADP Car Market Hub → Import & Limits und bestätigen Sie, dass der Importzeitplan aktiv ist.
  7. Lösen Sie im Tab „Import & Limits“ einen manuellen Import aus und überprüfen Sie, ob Fahrzeuge korrekt erstellt oder aktualisiert werden.

Partielle Wiederherstellung: Nur Einstellungen

Wenn nur die Plugin-Einstellungen wiederhergestellt werden müssen (z. B. nach einer versehentlichen Fehlkonfiguration):

  1. Importieren Sie das Datenbank-Backup in eine temporäre oder Staging-Datenbank.
  2. Extrahieren Sie die relevanten wp_options-Zeilen, deren Keys das Präfix as24ci_ haben, mithilfe einer SQL-Abfrage oder eines Datenbank-Vergleichstools.
  3. Wenden Sie die wiederhergestellten Optionswerte auf die Produktionsdatenbank an.
  4. Testen Sie die Verbindung und die Import-Pipeline, bevor Sie bestätigen, dass die Wiederherstellung abgeschlossen ist.

Nur Fahrzeugbilder wiederherstellen

Wenn Fahrzeugbilder versehentlich aus der Mediathek gelöscht wurden:

  1. Stellen Sie das wp-content/uploads/-Datei-Backup wieder her, um die ursprünglichen Bilddateien zurückzuerhalten.
  2. Führen Sie alternativ den Import erneut mit aktivierter Option für den Bildimport aus. Der Importer prüft vorhandene Anhangs-Quell-URLs (_as24ci_source_url-Post-Metadaten) und überspringt Bilder, die bereits vorhanden sind. Fehlende Bilder werden erneut von AutoScout24 heruntergeladen.

Betriebshinweise

  • Das Plugin kann Backups nicht selbstständig verwalten oder planen. Die Verantwortung für Backups liegt beim Website-Eigentümer, dem Hosting-Anbieter oder einem dedizierten WordPress-Backup-Plugin.
  • Die Analytics-Tabelle ({prefix}as24ci_analytics) und die Suchaufträge-Tabelle ({prefix}as24ci_search_agents) enthalten personenbezogene Daten (Besucher-Events, E-Mail-Adressen von Abonnenten). Behandeln Sie Backup-Dateien, die diese Tabellen enthalten, in Übereinstimmung mit Ihren geltenden Datenschutzbestimmungen.
  • Die Analytics-Tabelle wird bei der Deinstallation des Plugins immer gelöscht, selbst wenn die Option Daten bei Deinstallation löschen deaktiviert ist. Wenn Sie beabsichtigen, Analytics-Daten über eine Neuinstallation des Plugins hinweg zu behalten, exportieren oder sichern Sie die Tabelle vor der Deinstallation manuell.
  • Vom Plugin importierte Fahrzeugbilder werden in den Post-Metadaten unter _as24ci_image_ids nachverfolgt. Diese IDs verknüpfen Fahrzeug-Beiträge mit ihren Anhängen in der Mediathek. Wenn diese Post-Metadaten bei einer Wiederherstellung nicht vorhanden sind, verbleiben die Bilder möglicherweise als verwaiste Anhänge in der Mediathek.
  • Protokolldateien in as24ci-logs/ sind für die Wiederherstellung der Website-Funktionalität nicht kritisch, können aber nützliche Diagnoseinformationen enthalten. Wenn Sie mehr als 7 Tage Protokollverlauf aufbewahren müssen, kopieren Sie archivierte Protokolldateien in einen Langzeitspeicher, bevor das Plugin sie löscht.

Fehlerbehebung

SymptomWahrscheinliche UrsachePrüfung
API-Verbindung schlägt nach Wiederherstellung fehlWebsite-URL oder Zugangsdaten geändertÜberprüfen Sie die Zugangsdaten im Tab „Einstellungen“; überprüfen Sie die Website-URL in wp_options
Fahrzeugbilder werden nach Wiederherstellung nicht angezeigtUpload-Dateien nicht wiederhergestellt oder Mediathek-Anhangs-IDs nicht synchronStellen Sie das Uploads-Verzeichnis wieder her; lösen Sie einen Re-Import aus, um Bilder erneut herunterzuladen
Importzeitplan läuft nach Wiederherstellung nichtWP-Cron-Events nicht migriertAktivieren Sie den automatischen Import im Tab „Import & Limits“ erneut, um das Cron-Event neu zu planen
Benutzerdefinierte Tabellen nach Wiederherstellung nicht vorhandenBackup enthielt keine benutzerdefinierten TabellenAktivieren und deaktivieren Sie das Plugin, um die Tabellenerstellung auszulösen, oder stellen Sie die Datenbank aus einem vollständigen Backup wieder her
Lead-Benachrichtigungen werden nach Wiederherstellung nicht zugestelltEinstellung für Empfänger-E-Mail geändert oder WordPress-E-Mail-Konfiguration auf neuem Server andersÜberprüfen Sie die Lead-Empfänger-E-Mail in den Einstellungen; überprüfen Sie die WordPress-E-Mail-Zustellung

Verwandte Dokumente