Update-Prozess

Dieses Dokument beschreibt den empfohlenen Prozess für die Aktualisierung des ADP Car Market Hub-Plugins auf einer produktiven WordPress-Website. Das Befolgen eines strukturierten Update-Prozesses minimiert das Risiko von Datenverlusten, Konfigurationsänderungen oder Fehlern im Frontend.

Wann dieses Dokument zu verwenden ist

Lesen Sie dieses Dokument immer dann, wenn eine neue Version des Plugins verfügbar ist und Sie diese auf einer Live-Website einspielen müssen. Lesen Sie es auch vor jedem geplanten WordPress-Core-Update, das die Plugin-Kompatibilität beeinträchtigen könnte.

Übersicht

Plugin-Updates können Fehlerbehebungen, Sicherheitspatches, neue Funktionen oder Änderungen am Datenbankschema enthalten. Das Plugin führt Migrationen des Datenbankschemas bei der Aktivierung und bei plugins_loaded automatisch durch. Bei größeren Versionsänderungen wird jedoch dringend ein Test auf einer Staging-Umgebung vor dem produktiven Deployment empfohlen.

Der allgemeine Ablauf ist: Changelog prüfen → Backup erstellen → auf Staging testen → im Produktivsystem einspielen → Betrieb überprüfen.

Voraussetzungen

• Administrator-Zugriff auf das WordPress-Admin-Dashboard sowohl in der Staging- als auch in der Produktivumgebung.
• Ein aktuelles vollständiges Backup der produktiven Datenbank und des Uploads-Verzeichnisses (siehe Backup und Wiederherstellung).
• Eine Staging-Umgebung, die die Live-Website widerspiegelt. Falls keine Staging-Umgebung vorhanden ist, erstellen Sie vor dem Update ein vollständiges Backup und halten Sie sich für einen Rollback bereit.
• Die Berechtigung manage_as24_imports für das Benutzerkonto, das das Update durchführt.

Schritt-für-Schritt-Anleitung

Schritt 1: Versionshinweise prüfen

1. Lesen Sie die Versionshinweise für die neue Version (siehe Release Notes).
2. Identifizieren Sie alle in den Versionshinweisen aufgeführten Breaking Changes, Datenbankmigrationen oder Konfigurationsschritte.
3. Beachten Sie eventuelle neue Anforderungen an die PHP-Version oder die WordPress-Version. Das Plugin erfordert ab Version 1.0.0 PHP 8.1 oder höher und WordPress 6.2 oder höher. Überprüfen Sie den Plugin-Datei-Header oder readme.txt auf die aktuell deklarierten Anforderungen.

Schritt 2: Vollständiges Backup erstellen

1. Sichern Sie die produktive Datenbank und das Verzeichnis wp-content/uploads/, bevor Änderungen vorgenommen werden.
2. Notieren Sie sich die aktuelle Plugin-Version, damit Sie bei Bedarf zu dieser zurückkehren können.
3. Speichern Sie das Backup an einem Ort, der auch dann zugänglich ist, wenn das WordPress-Admin-Dashboard nicht mehr erreichbar sein sollte (z. B. ein Backup auf Hosting-Ebene oder ein lokaler Download).

Schritt 3: Update auf Staging testen

1. Spielen Sie die neue Plugin-Version auf der Staging-Website ein.
2. Wenn die Staging-Website nicht den aktuellen Live-Zustand widerspiegelt, stellen Sie vor dem Update ein aktuelles Backup der Live-Website auf Staging wieder her.
3. Überprüfen Sie nach dem Update auf Staging Folgendes: - Die Admin-Seiten des Plugins laden ohne PHP-Fehler oder White Screens. - Der Tab Health zeigt keine neuen kritischen Probleme an. - Der API-Verbindungsstatus im Tab „System & Hilfe“ lautet Verbunden. - Ein manueller Import wird erfolgreich abgeschlossen (verwenden Sie die Schaltfläche Import jetzt starten unter Automatisierung). - Importierte Fahrzeugdaten werden im Frontend-Archiv und auf den Fahrzeug-Detailseiten korrekt dargestellt. - Das Lead-Kontaktformular lässt sich erfolgreich absenden und stellt eine Benachrichtigungs-E-Mail zu. - Analytics-Tracking-Events werden aufgezeichnet (falls Analytics aktiviert ist).
4. Wenn auf Staging Probleme festgestellt werden, fahren Sie nicht mit der Live-Umgebung fort. Melden Sie das Problem und warten Sie auf eine Behebung oder Anleitung.

Schritt 4: Update im Produktivsystem einspielen

Option A: Update über das WordPress-Admin-Dashboard

1. Melden Sie sich im produktiven WordPress-Admin-Bereich an.
2. Navigieren Sie zu Dashboard → Updates (oder Plugins → Installierte Plugins).
3. Suchen Sie ADP Car Market Hub in der Update-Liste und klicken Sie auf Aktualisieren.
4. WordPress deaktiviert das Plugin, ersetzt die Plugin-Dateien und aktiviert es wieder. Der Aktivierungs-Hook des Plugins führt Schema- und Options-Migrationen automatisch aus.

Option B: Manuelles Datei-Update

1. Versetzen Sie die Website in den Wartungsmodus, falls Ihr Workflow dies erfordert.
2. Laden Sie das Paket der neuen Plugin-Version herunter.
3. Ersetzen Sie über SFTP oder den Dateimanager Ihres Hostings den Inhalt von wp-content/plugins/adp-car-market-hub/ durch die Dateien der neuen Version.
4. Der Hook plugins_loaded des Plugins löst die Schema-Migrationen aus, sobald der nächste WordPress-Request verarbeitet wird.

Schritt 5: Update im Produktivsystem überprüfen

1. Öffnen Sie ADP Car Market Hub → System & Hilfe und bestätigen Sie, dass der API-Verbindungsstatus Verbunden lautet.
2. Überprüfen Sie den Dashboard-Tab und stellen Sie sicher, dass die Fahrzeuganzahl und die Informationen zum letzten Durchlauf vorhanden sind.
3. Öffnen Sie den Logs-Tab und vergewissern Sie sich, dass keine neuen Fehler im Zusammenhang mit dem Update vorliegen.
4. Navigieren Sie zur Fahrzeug-Archivseite im Frontend und prüfen Sie, ob die Inserate korrekt geladen werden.
5. Wenn die Versionsnummer des Plugins im Admin-Bereich angezeigt wird (z. B. im Health- oder Support-Tab), bestätigen Sie, dass dort die neue Version steht.
6. Starten Sie einen manuellen Import über den Tab „Import & Limits“ und bestätigen Sie, dass dieser fehlerfrei abgeschlossen wird.

Schritt 6: Für 24–48 Stunden überwachen

1. Führen Sie nach dem Live-Update für die nächsten ein bis zwei Tage die standardmäßigen täglichen Überprüfungen durch (siehe Tägliche Arbeitsabläufe).
2. Achten Sie im Logs-Tab auf neue Fehler.
3. Bestätigen Sie, dass geplante Importe weiterhin pünktlich ausgeführt werden.

Konfigurationsreferenz

Betriebshinweise

• Das Plugin verwendet die Hooks plugins_loaded und admin_init, um Datenbankschema-Migrationen zu prüfen und anzuwenden. Schema-Upgrades laufen automatisch ab und erfordern keine manuelle SQL-Ausführung.
• Das Plugin registriert während der Aktivierung eine benutzerdefinierte Berechtigung (manage_as24_imports). Wenn diese Berechtigung nach einem Update fehlt, deaktivieren Sie das Plugin und aktivieren Sie es erneut, um die Registrierung der Berechtigung auszulösen.
• Das Plugin speichert eine Datenbankversion in der Options-Tabelle WordPress (as24ci_db_version). Das Plugin liest diesen Wert aus und wendet alle ausstehenden Migrationen an, wenn es eine Versionsabweichung feststellt.
• Benutzerdefinierte Template-Overrides, die außerhalb des Plugin-Verzeichnisses gespeichert sind (z. B. in einem Child-Theme), sind von Plugin-Updates nicht betroffen. Wenn das Update jedoch die Template-Struktur ändert, müssen Ihre benutzerdefinierten Templates eventuell entsprechend angepasst werden.
• Die Bildwarteschlange, Import-Sperr-Transients und das zwischengespeicherte Access-Token sind von Plugin-Updates nicht betroffen. Laufende Importvorgänge sollten normal abgeschlossen werden.

Rollback durchführen

Wenn das Live-Update Probleme verursacht und ein Rollback erforderlich ist:

1. Stellen Sie das in Schritt 2 erstellte Datenbank-Backup wieder her.
2. Stellen Sie die vorherigen Plugin-Dateien aus dem Backup oder durch Herunterladen der vorherigen Version wieder her.
3. Die vorherige Plugin-Version erkennt den wiederhergestellten Datenbankzustand und die Daten sind konsistent.
4. Untersuchen Sie die Ursache des Fehlers, bevor Sie das Update erneut versuchen.

Fehlerbehebung

Verwandte Dokumente

• Backup und Wiederherstellung
• Monatliche Wartung
• Protokollierung und Überwachung