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 Sie dieses Dokument verwenden sollten
Lesen Sie dieses Dokument, wenn Sie Website-Administrator, Hosting-Ingenieur oder WordPress-Entwickler sind und für die Backup-Strategie und das Disaster Recovery auf einer Website verantwortlich sind, 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 all diese Komponenten enthalten. Das Plugin selbst bietet keine eigenen Backup-Tools; Backups hängen vom Standard-WordPress-Backup-Ansatz ab, der von Ihrem Hosting-Anbieter oder Backup-Plugin verwendet wird.
Importierte Fahrzeugangebote 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 Logdateien können nicht aus AutoScout24 wiederhergestellt werden und müssen durch das Website-Backup geschützt werden.
Was das Plugin speichert
| Datentyp | Speicherort | Hinweise |
|---|---|---|
| Plugin-Einstellungen und Konfiguration | WordPress Options-Tabelle (wp_options) | Allen Option-Keys ist das Präfix as24ci_ vorangestellt |
| Fahrzeug-Anker-Beiträge | WordPress 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 Grossteil der Fahrzeugfelddaten befindet sich in der unten stehenden benutzerdefinierten Tabelle. |
| Fahrzeugfeldaten | Benutzerdefinierte Datenbanktabelle {prefix}as24_vehicles | Eine 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-Anfragen) | WordPress Posts-Tabelle (wp_posts, wp_postmeta) | Custom Post Type: as24ci_lead |
| Analytics-Ereignisse | Benutzerdefinierte Datenbanktabelle {prefix}as24ci_analytics | Verfolgung von Besucherereignissen; wird bei der Deinstallation des Plugins gelöscht |
| Suchaufträge (Suchabos für Besucher) | Benutzerdefinierte Datenbanktabelle {prefix}as24ci_search_agents | Personenbezogene Daten; wird bei der Deinstallation des Plugins gelöscht |
| Content Studio-Jobs und generierte Assets | Benutzerdefinierte Datenbanktabellen {prefix}as24ci_content_studio_jobs und {prefix}as24ci_content_studio_assets | KI-Inhaltsgenerierungs-Jobs und deren generierte Marketing-Ergebnisse (Bildunterschriften, Hashtags, Alt-Texte, Bildreferenzen); beide werden bei der Deinstallation des Plugins gelöscht |
| Importierte Fahrzeugbilder | WordPress Mediathek (wp_uploads/) | An Fahrzeugbeiträge angehängt; nachverfolgt in _as24ci_image_ids |
| Plugin-Logdateien | {wp-uploads}/as24ci-logs/adp-car-market-hub.log | Rotiert bei 10 MB; Archive werden nach 7 Tagen gelöscht |
| Vom Plugin erstellte Seiten | WordPress Seiten in wp_posts | Archivseite, Vergleichsseite und Favoritenseite; IDs sind in den Optionen as24ci_page_archive_id, as24ci_page_compare_id und as24ci_page_favorites_id gespeichert |
Anforderungen
- Eine WordPress-Backup-Lösung, die sowohl die Datenbank als auch das Dateisystem (Uploads-Ordner) sichern kann. 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 die Wiederherstellung in einer Testumgebung durchführen, um Kompatibilitätsprobleme zu vermeiden.
Backup-Verfahren
Datenbank-Backup
- Sichern Sie die gesamte WordPress-Datenbank. Dies erfasst
wp_options(Plugin-Einstellungen),wp_postsundwp_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). - 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.
- 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.
Dateisystem-Backup
- Sichern Sie das Verzeichnis WordPress
wp-content/uploads/. Dieses enthält: - Alle importierten Fahrzeugbilder (die an Fahrzeugbeiträge angehängt sind). - Das Plugin-Log-Verzeichnis:as24ci-logs/. Dieses Verzeichnis ist durch eine.htaccess-Datei vor öffentlichem Zugriff geschützt; stellen Sie sicher, dass Ihr Backup-Tool versteckte Dateien erfasst. - Sichern Sie das Plugin-Verzeichnis
wp-content/plugins/adp-car-market-hub/, falls 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
- Stellen Sie die Datenbank aus dem Backup über Ihr Hosting-Control-Panel, phpMyAdmin oder einen Befehlszeilen-MySQL-Client wieder her.
- Stellen Sie das Verzeichnis
wp-content/uploads/aus dem Dateisystem-Backup wieder her. - Wenn Sie die Wiederherstellung auf einem neuen Server oder einer neuen Domain durchführen, aktualisieren Sie die WordPress-Website-URL in der Datenbank (
wp_optionsZeilensiteurlundhome) mithilfe der WordPress CLI (wp option update) oder durch direktes Bearbeiten der Datenbank. - Löschen Sie nach der Wiederherstellung jeglichen WordPress-Objekt-Cache.
- Melden Sie sich im WordPress-Adminbereich an und navigieren Sie zu ADP Car Market Hub → System & Help, um den Status der API-Verbindung zu überprüfen.
- Öffnen Sie ADP Car Market Hub → Import & Limits und vergewissern Sie sich, dass der Importzeitplan aktiv ist.
- 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):
- Importieren Sie das Datenbank-Backup in eine temporäre oder Staging-Datenbank.
- Extrahieren Sie die relevanten
wp_options-Zeilen mit Keys, die das Präfixas24ci_haben, mithilfe einer SQL-Abfrage oder eines Datenbank-Vergleichstools. - Wenden Sie die wiederhergestellten Optionswerte auf die Produktionsdatenbank an.
- Testen Sie die Verbindung und die Import-Pipeline, bevor Sie die Wiederherstellung als abgeschlossen bestätigen.
Nur Fahrzeugbilder wiederherstellen
Wenn Fahrzeugbilder versehentlich aus der Mediathek gelöscht wurden:
- Stellen Sie das
wp-content/uploads/-Dateisystem-Backup wieder her, um die ursprünglichen Bilddateien zurückzuerhalten. - Alternativ können Sie den Import erneut ausführen, wobei der Bildimport aktiviert sein muss. Der Importer prüft vorhandene Anhang-Quell-URLs (
_as24ci_source_urlPost-Meta) und überspringt Bilder, die bereits vorhanden sind. Fehlende Bilder werden erneut von AutoScout24 heruntergeladen.
Betriebliche Hinweise
- 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 (Besucherereignisse, E-Mail-Adressen von Abonnenten). Behandeln Sie Backup-Dateien, die diese Tabellen enthalten, in Übereinstimmung mit den für Sie 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 Analytics-Daten über eine Neuinstallation des Plugins hinweg behalten möchten, exportieren oder sichern Sie die Tabelle vor der Deinstallation manuell.
- Vom Plugin importierte Fahrzeugbilder werden in den Post-Metadaten unter
_as24ci_image_idsnachverfolgt. Diese IDs verknüpfen Fahrzeugbeiträ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. - Logdateien in
as24ci-logs/sind für die Wiederherstellung der Website-Funktionalität nicht kritisch, können aber nützliche Diagnoseinformationen enthalten. Wenn Sie Log-Historien von mehr als 7 Tagen aufbewahren müssen, kopieren Sie archivierte Logdateien in einen Langzeitspeicher, bevor das Plugin sie löscht.
Fehlerbehebung
| Symptom | Wahrscheinliche Ursache | Prüfung |
|---|---|---|
| API-Verbindung schlägt nach Wiederherstellung fehl | Website-URL oder Zugangsdaten haben sich geändert | Überprüfen Sie die Zugangsdaten im Tab „Settings“; prüfen Sie die Website-URL in wp_options |
| Fahrzeugbilder werden nach Wiederherstellung nicht angezeigt | Upload-Dateien wurden nicht wiederhergestellt oder Mediathek-Anhang-IDs sind asynchron | Stellen Sie das Uploads-Verzeichnis wieder her; lösen Sie einen Re-Import aus, um Bilder erneut herunterzuladen |
| Importzeitplan läuft nach Wiederherstellung nicht | WP-Cron-Ereignisse wurden nicht migriert | Aktivieren Sie den automatischen Import im Tab „Import & Limits“ erneut, um das Cron-Ereignis neu zu planen |
| Benutzerdefinierte Tabellen nach Wiederherstellung nicht vorhanden | Backup enthielt keine benutzerdefinierten Tabellen | Aktivieren 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 zugestellt | Empfänger-E-Mail-Einstellung geändert oder WordPress-Mail-Konfiguration auf neuem Server anders | Überprüfen Sie die Lead-Empfänger-E-Mail in den Einstellungen; prüfen Sie den WordPress-E-Mail-Versand |