Update-Prozess

Dieses Dokument beschreibt den empfohlenen Prozess für die Aktualisierung des ADP Car Market Hub-Plugins auf einer Live-WordPress-Website. Das Befolgen eines strukturierten Update-Prozesses verringert das Risiko von Datenverlusten, Konfigurationsänderungen oder Regressionen 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 verarbeitet Migrationen des Datenbankschemas automatisch bei der Aktivierung und bei plugins_loaded, aber ein Staging-Test vor dem produktiven Deployment wird bei signifikanten Versionsänderungen dringend empfohlen.

Der allgemeine Ablauf ist: Changelog prüfen → Backup erstellen → auf Staging testen → auf Produktion anwenden → Betrieb überprüfen.

Anforderungen

• Administrator-Zugriff auf den WordPress-Admin sowohl in der Staging-Umgebung als auch in der Produktionsumgebung.
• Ein aktuelles vollständiges Backup der Produktionsdatenbank und des Upload-Verzeichnisses (siehe Backup und Wiederherstellung).
• Eine Staging-Umgebung, die die Produktionswebsite widerspiegelt. Wenn keine Staging-Umgebung existiert, erstellen Sie vor dem Update ein vollständiges Backup und seien Sie bereit für einen Rollback.
• Die Berechtigung manage_as24_imports für das Benutzerkonto, welches 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 alle neuen 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 Produktionsdatenbank 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 der WordPress-Admin nicht mehr verfügbar 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 Produktionszustand widerspiegelt, stellen Sie vor dem Update ein aktuelles Produktions-Backup auf Staging wieder her.
3. Überprüfen Sie nach dem Update auf Staging Folgendes: - Die Plugin-Admin-Seiten laden ohne PHP-Fehler oder weisse Bildschirme. - Der Tab Health zeigt keine neuen kritischen Probleme. - Der API-Verbindungsstatus im Tab „System & Help“ lautet Connected. - Ein manueller Import wird erfolgreich abgeschlossen (verwenden Sie die Schaltfläche Trigger import now unter Automation). - Importierte Fahrzeugangebote werden im Frontend-Archiv und auf den Fahrzeug-Detailseiten korrekt angezeigt. - Das Lead-Kontaktformular wird erfolgreich abgesendet 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 Produktion fort. Melden Sie das Problem und warten Sie auf einen Fix oder Anweisungen.

Schritt 4: Update auf Produktion anwenden

Option A: Update über den WordPress-Admin

1. Melden Sie sich im Produktions-WordPress-Admin 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 reaktiviert es. 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 via SFTP oder den Datei-Manager 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 wird Schema-Migrationen auslösen, sobald die nächste WordPress-Anfrage verarbeitet wird.

Schritt 5: Produktions-Update überprüfen

1. Öffnen Sie ADP Car Market Hub → System & Help und bestätigen Sie, dass der API-Verbindungsstatus Connected lautet.
2. Überprüfen Sie den Dashboard-Tab und bestätigen Sie, dass die Fahrzeuganzahl und die Informationen zum letzten Durchlauf vorhanden sind.
3. Öffnen Sie den Logs-Tab und bestätigen Sie, dass keine neuen Fehler im Zusammenhang mit dem Update vorliegen.
4. Navigieren Sie zur Fahrzeug-Archivseite im Frontend und bestätigen Sie, dass die Angebote korrekt geladen werden.
5. Wenn die Versionsnummer des Plugins irgendwo im Admin angezeigt wird (z. B. im Tab „Health“ oder „Support“), bestätigen Sie, dass die neue Version angezeigt wird.
6. Lösen Sie einen manuellen Import im Tab „Import & Limits“ aus und bestätigen Sie, dass dieser fehlerfrei abgeschlossen wird.

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

1. Führen Sie nach dem Produktions-Update für die nächsten ein bis zwei Tage die standardmässigen täglichen Kontrollen 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.

Konfigurations-Referenz

Betriebliche Hinweise

• 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 ausserhalb 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 gecachte Access-Token sind von Plugin-Updates nicht betroffen. Laufende Importe sollten normal abgeschlossen werden.

Rollback durchführen

Wenn das Produktions-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