So stufen Sie ein PrestaShop-Modul nach einem fehlerhaften Update herab

Wenn Modul-Updates schiefgehen

Sie haben ein PrestaShop-Modul aktualisiert und jetzt funktioniert etwas nicht mehr. Vielleicht hat der Checkout aufgehört zu funktionieren, die Startseite wirft Fehler, oder das Admin-Panel reagiert nicht mehr. Modul-Updates können aus vielen Gründen fehlschlagen - inkompatible PHP-Versionen, Konflikte mit anderen Modulen, Datenbankmigrationsfehler oder einfach Bugs in der neuen Version. Unabhängig von der Ursache müssen Sie schnell zurückrollen, um die Funktionalität Ihres Shops wiederherzustellen.

Leider enthält PrestaShop keine eingebaute "Rückgängig"-Schaltfläche für Modul-Updates. Es gibt keinen nativen Versionsverlauf oder automatischen Rollback-Mechanismus für einzelne Module. Das bedeutet, Sie müssen das Downgrade manuell durchführen. Dieser Leitfaden behandelt jede verfügbare Methode, von der einfachsten bis zur komplexesten.

Bevor Sie beginnen - Sicherheit zuerst

1. Schalten Sie Ihren Shop in den Wartungsmodus - Gehen Sie zu Shopparameter > Allgemein > Wartung und aktivieren Sie ihn.
2. Erstellen Sie ein Datenbank-Backup - Die neue Modulversion hat möglicherweise Datenbankänderungen vorgenommen.
3. Dokumentieren Sie den aktuellen Fehler - Notieren Sie exakte Fehlermeldungen und betroffene Seiten.

Methode 1 - Vorherige Version über das Back Office neu installieren

Dies ist die einfachste Methode und funktioniert, wenn Sie noch Zugang zum PrestaShop-Admin-Panel haben und die ZIP-Datei der vorherigen Version besitzen.

Schritt-für-Schritt-Anleitung

1. Navigieren Sie zu Module > Modulmanager
2. Finden Sie das problematische Modul und klicken Sie auf Deinstallieren (NICHT "Löschen" - Deinstallieren bewahrt die Moduldaten in der Datenbank)
3. Bestätigen Sie die Deinstallation
4. Klicken Sie oben auf der Seite auf Modul hochladen
5. Laden Sie die ZIP-Datei der vorherigen funktionierenden Version hoch
6. Installieren und konfigurieren Sie das Modul

Wo Sie die vorherige Version bekommen

• Ihre E-Mail - Die meisten Modulverkäufer senden Download-Links mit jedem Kauf
• Marktplatz-Konto - Bei PrestaShop Addons und Drittanbieter-Marktplätzen wie mypresta.rocks können Sie vorherige Versionen aus Ihrer Bestellhistorie herunterladen
• Ihre Backups - Aus regelmäßigen Backups können Sie den Modulordner extrahieren
• Entwickler kontaktieren - Modulentwickler können in der Regel ältere Versionen bereitstellen

Methode 2 - FTP/SFTP Dateiersetzung

Wenn das Admin-Panel nicht erreichbar ist (weißer Bildschirm, 500-Fehler), müssen Sie direkt mit Dateien über FTP oder SFTP arbeiten.

Schritt-für-Schritt-Anleitung

1. Verbinden Sie sich mit Ihrem Server über FTP/SFTP mit einem Client wie FileZilla
2. Navigieren Sie zu /modules/ in Ihrem PrestaShop-Installationsverzeichnis
3. Finden Sie den Modulordner (z.B. /modules/mymodule/)
4. Benennen Sie den aktuellen Ordner um - z.B. mymodule zu mymodule_kaputt
5. Laden Sie die Dateien der vorherigen Version in einen neuen mymodule-Ordner hoch
6. Setzen Sie korrekte Dateiberechtigungen - Verzeichnisse auf 755, Dateien auf 644
7. Leeren Sie den PrestaShop-Cache durch Löschen der Inhalte von /var/cache/prod/ und /var/cache/dev/

Methode 3 - Über die Kommandozeile

Wenn Sie SSH-Zugang zu Ihrem Server haben, können Sie das Rollback effizienter über die Kommandozeile durchführen.

# Per SSH verbinden
ssh user@ihrserver.com

# Zum PrestaShop-Stammverzeichnis navigieren
cd /var/www/html/prestashop

# Defektes Modul sichern
mv modules/mymodule modules/mymodule_kaputt_$(date +%Y%m%d)

# Vorherige Version entpacken
unzip /pfad/zu/mymodule_v1.2.3.zip -d modules/

# Korrekte Berechtigungen setzen
find modules/mymodule -type d -exec chmod 755 {} \;
find modules/mymodule -type f -exec chmod 644 {} \;
chown -R www-data:www-data modules/mymodule

# PrestaShop-Cache leeren
rm -rf var/cache/prod/* var/cache/dev/*

Methode 4 - Vollständiges Datenbank-Rollback

Wenn das Modul-Update Datenbankmigrationen enthielt, die rückgängig gemacht werden müssen, müssen Sie ein Datenbank-Backup von vor dem Update wiederherstellen.

Wann Sie ein Datenbank-Rollback brauchen

• Das Modul hat neue Datenbanktabellen erstellt
• Das Modul hat bestehende Tabellenstrukturen geändert
• Das Modul hat Konfigurationswerte eingefügt oder geändert
• Der alte Modulcode wirft Fehler über fehlende oder unerwartete Datenbankspalten

Warnung - Eine vollständige Datenbankwiederherstellung setzt ALLE Änderungen seit dem Backup zurück, einschließlich neuer Bestellungen, Kundenregistrierungen und Produktänderungen. Wenn möglich, stellen Sie nur die Tabellen wieder her, die das Modul speziell geändert hat.

Methode 5 - Manuelle Datenbankbereinigung

Wenn Sie kein Datenbank-Backup von vor dem Update haben, können Sie die Datenbankänderungen des Moduls manuell rückgängig machen.

Prüfen, was sich geändert hat

Öffnen Sie die Haupt-PHP-Datei des Moduls und suchen Sie nach Upgrade-Methoden -

// Suchen Sie nach Dateien wie:
// modules/mymodule/upgrade/upgrade-2.0.0.php

public function upgrade($version)
{
    if (version_compare($version, '2.0.0', '<')) {
        Db::getInstance()->execute('ALTER TABLE `' . _DB_PREFIX_ . 'mymodule` 
            ADD COLUMN `new_field` VARCHAR(255)');
    }
}

Nach dem Downgrade - Wichtige Aufräumarbeiten

Alle Caches leeren

1. Smarty-Cache - Inhalte von /var/cache/prod/ und /var/cache/dev/ löschen
2. OPcache - PHP-FPM oder Apache neu starten
3. CDN-Cache - Bei Cloudflare oder anderem CDN den Cache leeren
4. Browser-Cache - Im Inkognito-Fenster testen

Modulversion verifizieren

Überprüfen Sie nach dem Downgrade, ob PrestaShop die korrekte Version erkennt.

Gründlich testen

• Die spezifische Funktionalität des Moduls
• Den Checkout-Prozess von Anfang bis Ende
• Die Admin-Seiten, auf denen das Modul Inhalte hinzufügt
• Mobile und Desktop-Ansichten
• Performance

Zukünftige Update-Probleme verhindern

• Immer vor dem Update sichern
• Updates in einer Staging-Umgebung testen
• Das Changelog lesen
• Frühere Versionen aufbewahren
• Kompatibilität prüfen

Wann den Modulentwickler kontaktieren

Wenn keine der obigen Methoden das Problem löst, kontaktieren Sie den Modulentwickler mit Ihrer PrestaShop-Version, PHP-Version, den betroffenen Modulversionen, exakten Fehlermeldungen und einer Liste anderer installierter Module.