Hier ist eine vollständige Schritt-für-Schritt-Anleitung für ein fehlerfreies Update von JTL-Shop 5.x auf 5.5, inklusive Vorbereitung, Durchführung, Safe-Mode-Hinweis, Fallstricken und Nachbearbeitung:
✅ 1. Vorbereitung (vor dem Update)
🔒 Backup erstellen
- Dateien: Komplettes Shopverzeichnis via FTP sichern.
- Datenbank: Backup per phpMyAdmin oder Adminer (SQL-Dump).
🔬 Staging-Umgebung vorbereiten
- Staging-Domain/Subdomain eingerichtet ✅
config.JTL-Shop.ini.phpanpassen (Pfad, DB-Zugang)- Sicherstellen, dass keine automatisierten Prozesse im Hintergrund laufen (z. B. Cronjobs oder Plugins mit Aufgabenplanern).
🎨 Templates & Plugins prüfen
- Child-Template aktiv nutzen ✅
- Alle installierten Plugins auf Updates prüfen:
- Kompatibilität mit JTL 5.5 über Plugin-Hersteller oder JTL Extension Store checken.
- Deaktivieren von inkompatiblen oder obsoleten Plugins vor dem Update.
🚀 2. Update durchführen
🛠️ Safe Mode aktivieren (empfohlen)
- Der Safe-Mode verhindert die Ausführung inkompatibler Plugins während des Updates.
- So aktivierst du ihn: plaintextKopierenBearbeiten
/admin/update/index.php?safemode=1oder falls du dich im Hauptverzeichnis befindest: plaintextKopierenBearbeiten/update/index.php?safemode=1
📦 Updatepaket herunterladen
- JTL-Shop 5.5 Updatepaket (nicht Vollinstallation!) von jtl-software.de laden.
- Dateien über das bestehende Shop-Verzeichnis kopieren (via FTP/SFTP, Dateien überschreiben, keine löschen!).
🧩 Update starten
- Gehe im Browser zu: pgsqlKopierenBearbeiten
deine-domain.de/update/ - Safe Mode aktivieren (siehe oben), falls nicht bereits passiert.
- Den Update-Prozess Schritt für Schritt durchlaufen.
⚠️ 3. Wichtige Hinweise & Fallstricke
🔁 Cache
- Nach dem Update den kompletten Cache leeren:
- Im Admin: System > Cache > Alle Caches leeren
- Zusätzlich per FTP:
/var/cacheggf. manuell löschen
🧹 Theme-Cache / Template-Cache
- JTL-Shop speichert kompilierte Templates: auch hier Cache löschen, z. B. via: bashKopierenBearbeiten
/templates_c/
🧪 PHP-Version
- JTL-Shop 5.5 benötigt mindestens PHP 8.1.
- Sicherstellen, dass deine Hosting-Umgebung entsprechend konfiguriert ist.
🔐 .htaccess
- Nach dem Update werden oft neue
.htaccess-Regeln verwendet. Prüfe, ob deine eigene Datei mit der neuen Version kompatibel ist.
🔄 Plugin-Reihenfolge und Hooks
- Manche Plugins, die vorher funktionierten, können durch neue Core-Änderungen ausfallen.
- Achte besonders auf:
- SEO-Plugins
- Zahlungs- und Versandarten
- Template-Anpassungen mit Override-Dateien
✅ 4. Nachbearbeitung (Post-Update-Checkliste)
| Bereich | Was tun |
|---|---|
| Backend-Funktionen | Alle Menüpunkte einmal anklicken – v. a. Artikel, Kategorien, Kunden |
| Frontend | Startseite, Produktdetailseiten, Checkout vollständig durchklicken |
| Templates | Child-Template testen (Startseite, Kategorie, Produkt, Warenkorb) |
| Bestellprozess | Testbestellung durchführen |
| Suche & Filter | Funktionieren Suchfunktion, Filter, Sortierungen? |
| Zahlungsarten | Zahlungsmodule auf Funktion prüfen |
| Versandarten | Versandlogik + Auswahl überprüfen |
| E-Mail-Vorlagen | Test-E-Mails senden lassen (Bestellbestätigung etc.) |
| Tracking/Consent | Ist Cookie-Consent noch korrekt? GTM etc. erneut prüfen |
| Feeds/API | Google Merchant Feed, Unicorn, Middleware, JTL-Wawi-Sync testen |
🧪 5. Staging auf Live übertragen (wenn alles passt)
Sobald du das Update erfolgreich auf der Staging-Seite getestet hast:
- Wiederhole das Update auf der Live-Seite.
- Alternativ: Live-Website kurz in Wartungsmodus versetzen.
- Optional: Vorher finalen Datenbank-Backup machen.
- Abschließend alle oben genannten Post-Checks auch im Live-Shop durchführen.
🧯 Extra-Tipp: Monitoring einbauen
- Nutze ein Error-Log (PHP oder JTL), um Probleme direkt zu erkennen:
- Aktivieren via
php.inioder.htaccess: apacheKopierenBearbeitenphp_flag display_errors Off php_flag log_errors On php_value error_log /pfad/zur/logdatei.log
- Aktivieren via
- Bei Bedarf: E-Mail-Benachrichtigung bei 500er-Fehlern einrichten
Wenn du willst, kann ich dir daraus auch eine druckbare PDF-Checkliste generieren oder dir ein Notion-Board mit Aufgaben daraus anlegen. Sag einfach Bescheid!
🧹 Typische „Datenbereinigungen“ nach JTL-Shop-Updates (inkl. wo du sie findest)
Hier die wichtigsten Punkte, die du nach einem Update manuell prüfen oder ausführen kannst:
1. Systembereinigung über das JTL-Backend
- Pfad:
Admin-Menü > System > Wartung > Systembereinigung - Wichtige Optionen hier:
- ❌ Nicht mehr benötigte Dateien entfernen (z. B. Reste von alten Plugins oder Templates)
- 🗑️ Nicht verwendete Sprachvariablen bereinigen
- ⚠️ Verwaiste oder veraltete Datenbankeinträge löschen
- 🧠 Nicht mehr benötigte Einstellungswerte bereinigen
- 🔄 Cache komplett leeren
💡 Empfehlung: Alles außer Artikelbilder-Cache kann hier gefahrlos einmal komplett durchgeführt werden, nachdem du ein Backup gemacht hast.
2. Datenbankstruktur prüfen und aktualisieren (nur bei Problemen)
Wenn es nach dem Update Fehler gibt, kannst du folgendes Tool nutzen:
- Pfad (nur direkt aufrufbar): bashKopierenBearbeiten
/admin/dbcheck.php - Dieses Script prüft:
- fehlende Felder
- inkonsistente Daten
- Indexprobleme
⚠️ Achtung:
dbcheck.phpist ein mächtiges Tool, nutze es nur bei Problemen, und immer mit vorherigem Datenbank-Backup!
3. SEO-URLs neu generieren
- Pfad:
Admin > Inhalte > SEO > URLs neu erstellen - Hake hier „Alle URL-Typen“ an, besonders:
- Artikel
- Kategorien
- CMS-Seiten
- Hersteller
Nach größeren Updates (wie auf 5.5) ist das oft sinnvoll, da sich der URL-Aufbau leicht ändern kann.
4. Eventuell Cronjobs oder Queue-Prozesse neu starten
- Bei neuen Funktionen (z. B. Caching über Cronjobs) kann es sein, dass alte Prozesse hängen.
- Pfad:
Admin > System > Cronjobs (bzw. geplante Aufgaben)
Wenn dort etwas inaktiv oder fehlerhaft ist: Einmal deaktivieren, speichern, wieder aktivieren.
5. Plugins & Template-Daten prüfen
- Plugins können verwaiste Tabellen oder Einstellungen hinterlassen.
- Wenn du Plugins entfernt hast, prüfe via:
Admin > Plugins > Installierte Plugins > Deinstallieren (inkl. Daten löschen)- Danach ggf. über FTP: Verzeichnis unter
/includes/pluginsmanuell löschen.
6. Logs prüfen auf Probleme
- Pfad:
Admin > System > Logfile- oder direkt in
/var/log/(Server-Zugriff nötig)
Schaue hier nach wiederkehrenden Fehlern, z. B. bei Hooks, Plugin-Fehlern oder nicht vorhandenen Methoden.
🔍 Bonus: Konsistenz der Artikel prüfen
- Gerade bei veralteten Plugins oder Änderungen an Attributen kann es zu Inkonsistenzen kommen.
- Nutze:
Admin > Artikel > Artikelübersicht > Filter: Artikel ohne KategorieAdmin > Artikel > Artikelübersicht > Filter: Artikel ohne Bilder
Wenn du möchtest, kann ich dir eine konkrete „Nach dem Update“-Checkliste als PDF oder Notion-Vorlage zusammenstellen, inklusive dieser Punkte. Sag einfach Bescheid.
Was this helpful?
0 / 0