Das häufigste Missverständnis: Wann ein Update „kurz geht" — und wann nicht
Es gibt tatsächlich JTL Shop Updates, die schnell erledigt sind. Der Unterschied:
Patch-Updates innerhalb einer Minor-Version (z. B. 5.7.2 → 5.7.3) enthalten oft nur Bugfixes und keine Template-Änderungen. Wer Standard-Nova ohne Anpassungen nutzt und keine exotischen Plugins hat, kann das in unter einer Stunde durchführen.
Hauptversionssprünge (5.7.x → 5.8.0) sind anders. Sie bringen:
- Änderungen am Template-Code (neue Komponenten, geänderte Struktur)
- Neue oder geänderte Datenbankfelder
- Veränderte PHP-Abhängigkeiten
- Neue JavaScript-Bibliotheken (in 5.8.0: Nivo Slider raus, Splide rein)
- Geänderte E-Mail-Vorlagen
Jede dieser Ebenen kann mit Ihren vorhandenen Anpassungen in Konflikt geraten. Und weil Sie das vorher nicht genau wissen, braucht es eine strukturierte Vorbereitung.
Was sich in 5.8.0 unter der Haube geändert hat — und warum das den Aufwand bestimmt
Template-Änderungen: Der Diff sagt alles
JTL stellt für jeden Versionssprung einen Template-Diff bereit — eine Datei, die zeigt, welche Template-Zeilen sich geändert haben. Für 5.8.0 ist das:
- Nova Template-Diff 5.7.3 → 5.8.0: build.jtl-shop.de → nova-v5.7.3-to-v5.8.0-tplclean.diff
Wenn Sie das Standard-Nova-Template unverändert nutzen, müssen Sie diesen Diff nicht aktiv bearbeiten — JTL spielt die neuen Template-Dateien automatisch ein.
Wenn Sie Nova angepasst haben (eigene CSS-Klassen, geänderte Slider-Konfiguration, zusätzliche Bereiche) oder ein komplett eigenes Template nutzen, müssen Sie:
- Den Diff öffnen und alle geänderten Zeilen lesen
- Prüfen, ob Ihre Anpassungen die gleichen Bereiche betreffen
- Konflikte manuell auflösen
Die größte Änderung in 5.8.0 auf Template-Ebene ist der Slider-Wechsel: Nivo Slider raus, Splide rein. Wer den Slider im Nova-Template angepasst hat (eigene Konfiguration, CSS-Overrides), muss das für Splide neu umsetzen.
E-Mail-Vorlagen: Der zweite Diff
Analog zum Template-Diff gibt es einen E-Mail-Vorlagen-Diff:
In 5.8.0 wurde die E-Mail-Logik für Versand- und Rechnungsbenachrichtigungen geändert: Versandmails gehen nun an den Warenempfänger, Rechnungsmails an den Rechnungsnehmer. Wer seine E-Mail-Vorlagen angepasst hat, muss prüfen, ob die eigenen Änderungen mit dieser neuen Logik kompatibel sind.
Die 10 Schritte für ein sicheres Update auf 5.8.0
Schritt 1: Vollständiges Backup
Bevor irgendetwas am Shop geändert wird: Backup. Vollständig. Datenbank und Dateisystem.
- Datenbank-Dump (alle Tabellen, vollständig)
- Dateisystem-Backup des kompletten Shop-Verzeichnisses inkl. Templates, Plugins, Uploads
Ohne Backup gibt es keinen Rollback. Das ist eine technische Notwendigkeit.
Schritt 2: Staging-Umgebung aufsetzen oder klonen
Spielen Sie das Update niemals direkt auf dem Live-Shop ein.
Richten Sie eine Staging-Umgebung ein — entweder ein separates Verzeichnis auf demselben Server, eine Subdomain oder einen separaten Staging-Server. Klonen Sie den Live-Shop dorthin: Datenbankdump importieren, Dateien kopieren, Konfiguration anpassen.
Das Staging gibt Ihnen einen sicheren Raum, in dem Fehler keine Auswirkungen auf Ihren laufenden Betrieb haben. Sichern Sie den Staging Shop zudem mit htaccess gegen Crawling und fremde Zugriffe ab.
Achtung: Bei einer Staging Umgebung mit Subdomain kann es zu Lizenzproblemen mit den Plugins kommen. Prüfen Sie hier am besten vorher, welche Lösung zu Testzwecken am besten ist, meist ist ein Unterordner am einfachsten
Schritt 3: Alle Plugins auf 5.8.0-Kompatibilität prüfen
Das ist der Schritt, den viele unterschätzen und der am häufigsten zu Problemen führt.
Gehen Sie in den JTL Extension Store bzw auf die Herstellerseite der Plugins und prüfen Sie für jedes installierte Plugin:
- Ist die aktuell installierte Version mit JTL Shop 5.8.0 kompatibel?
- Hat der Hersteller eine aktualisierte Version für 5.8.0 veröffentlicht?
- Gibt es im JTL-Forum Berichte über Inkompatibilitäten?
Was tun bei inkompatiblen Plugins?
- Wenn eine kompatible Version verfügbar ist: Update-Version des Plugins herunterladen, bereit für Installation
- Wenn noch keine kompatible Version existiert: Plugin-Hersteller kontaktieren — wann ist eine 5.8.0-kompatible Version geplant? Ggf. Plugin deaktivieren und temporär auf Alternativlösung umstellen
Spielen Sie das Shop-Update erst ein, wenn Sie für jedes Plugin entweder eine kompatible Version oder eine Deaktivierungsstrategie haben.
Schritt 4: Template-Diff sichten
Öffnen Sie den Nova-Template-Diff und vergleichen Sie die geänderten Dateien mit Ihren eigenen Anpassungen:
- Nutzen Sie ein Diff-Tool (z. B. VS Code, Beyond Compare, WinMerge)
- Markieren Sie alle Stellen, wo Ihre Anpassungen und der JTL-Diff überlappen
- Notieren Sie, was nach dem Update manuell nachgezogen werden muss
Bei komplett eigenen Templates: Sichten Sie, ob neue Template-Variablen oder Template-Strukturen in 5.8.0 eingeführt wurden, die Ihr Template nutzen sollte (z. B. für die Label-Darstellung).
Schritt 5: E-Mail-Vorlagen-Diff sichten
Analog zu Schritt 4: Öffnen Sie den E-Mail-Diff und prüfen Sie, ob Ihre angepassten Mailvorlagen mit den geänderten Vorlagen in 5.8.0 kompatibel sind. Besonderes Augenmerk auf die neue Versand-/Rechnungsmail-Logik.
Schritt 6: Komplettpaket auf Staging einspielen
Deaktivieren Sie alle Plugins in der Staging-Umgebung.
Laden Sie das JTL Shop 5.8.0 Komplettpaket herunter und spielen Sie es auf die Staging-Umgebung ein. Das Komplettpaket überschreibt die Shop-Core-Dateien — eigene Dateien in /templates/, /plugins/ usw. bleiben erhalten, sofern Sie nichts im Core-Verzeichnis angepasst haben.
Achtung: Beachten Sie ihre vorhandenen robots.txt und htacess Dateien, diese sollten nicht vom Update Paket überschrieben werden
Nach dem Einspielen: Datenbank-Migrationen im Backend ausführen (JTL zeigt einen Hinweis, wenn offene Migrationen vorliegen).
Schritt 7: Plugin-Updates einspielen und konfigurieren
Spielen Sie alle in Schritt 3 identifizierten Plugin-Updates ein. Deaktivieren Sie Plugins, für die noch keine 5.8.0-kompatible Version verfügbar ist.
Überprüfen Sie nach jedem Plugin, ob die Konfiguration erhalten geblieben ist und ob das Plugin im Staging wie erwartet funktioniert.
Schritt 8: Funktionstests auf Staging
Testen Sie alle geschäftskritischen Prozesse:
- Checkout-Prozess — vom Warenkorb bis zur Bestellbestätigung, alle Zahlungsarten
- Versandarten-Berechnung — Stichproben mit verschiedenen Warenkörben
- Konfigurator (falls genutzt) — Auswahl, Preisberechnung, Lageranzeige
- Suche — Volltextsuche, Filterfunktionen
- Widerrufsbutton — ist er sichtbar? Führt er korrekt ins Widerrufsformular?
- Rechtstexte — Sind alle Rechtstexte korrekt eingebunden und aktuell?
- Garantielabels — erscheinen das Gewährleistungslabel und (bei befüllten Attributen) das Garantielabel?
- E-Mail-Versand — Testbestellung aufgeben, alle Mails prüfen
- Mobil — Responsive-Darstellung auf verschiedenen Bildschirmgrößen prüfen
- PageSpeed — Vorher-/Nachher-Vergleich (Google PageSpeed Insights)
Sollten Sie Darstellungsprobleme oder gar einen Error 500 haben, können sie den Debug Modus in der JTL-Shop.ini, weitere Hinweise gibt es im FAQ zu JTL SHop
Schritt 9: Garantielabel-Konfiguration in JTL Wawi
Befüllen Sie — noch im Staging-Stadium — die drei Garantielabel-Attribute in JTL Wawi für alle betroffenen Artikel:
| Attribut | Wert |
|---|---|
jtl_guarantee_years |
Anzahl Jahre (z. B. 3) |
jtl_guarantee_manufacturer |
Hersteller (z. B. Bosch) |
jtl_guarantee_model_identifier |
Modellbezeichnung (z. B. Herstellergarantie Serie 8) |
Führen Sie einen Wawi-Abgleich mit dem Staging-Shop durch und prüfen Sie, ob die Labels korrekt erscheinen.
Haben Sie viele betroffene Artikel? Nutzen Sie die JTL Ameise für einen Massen-Import der Attribute.
Alle Details zur Label-Konfiguration lesen Sie in: Garantielabel-Pflicht: Warum Sie 5.8.0 jetzt nicht aufschieben können.
Empfohlene Vorgehensweise für den Live-Rollout:
- Wartungsmodus aktivieren (kurze Downtime ist besser als ein fehlerhafter Live-Shop)
- Frisches Backup des Live-Shops
- Gleiches Update-Verfahren wie auf Staging
- Tests auf Live wiederholen (zumindest Checkout, Labels, E-Mails)
- Wartungsmodus deaktivieren
Was JTL Hosting-Kunden beachten müssen
Wenn Ihr Shop auf JTL Hosting läuft, beauftragen Sie das Versions-Update über ein Support-Ticket mit dem Stichwort „Versions-Update". Die Details dazu finden Sie im JTL Hosting FAQ.
Wichtig: JTL aktualisiert dabei den Shop-Core. Ihre Plugins und Template-Anpassungen müssen Sie trotzdem selbst prüfen und anpassen. Der Hosting-Service ersetzt nicht die in diesem Artikel beschriebene Vorbereitungsarbeit.
Was passiert, wenn beim Update etwas schiefgeht?
Die häufigsten Fehlerquellen
Plugin-Konflikt: Ein inkompatibles Plugin lädt eine veraltete PHP-Klasse oder überschreibt eine geänderte Core-Funktion. Symptom: weißer Bildschirm, 500-Fehler oder kaputte Darstellung. Lösung: Plugins nacheinander deaktivieren, bis der Fehler verschwindet.
Template-Konflikt: Eine geänderte Template-Variable existiert in Ihrer angepassten Template-Datei nicht mehr oder hat einen anderen Namen. Symptom: Smarty-Fehler, fehlende Elemente auf Produktseiten. Lösung: Diff-Datei nacharbeiten.
Datenbank-Migration nicht ausgeführt: Nach dem Core-Update zeigt das Backend einen Hinweis auf offene Migrationen. Werden diese nicht ausgeführt, fehlen Datenbankfelder — das führt zu Fehlern bei der Anzeige neuer Features wie den Labels.
Caching-Probleme: Browser-Cache oder Shop-seitiges Template-Caching zeigt noch die alte Version. Lösung: Browser-Cache leeren, Shop-Template-Cache im Backend zurücksetzen.
Fazit: Selbst machen oder beauftragen?
Das kommt auf Ihren Shop an.
Selbst machen ergibt Sinn, wenn:
- Sie das Standard-Nova-Template unverändert nutzen
- Sie wenige, gut gepflegte Plugins mit bekannter 5.8.0-Kompatibilität haben
- Sie eine Staging-Umgebung einrichten können
- Sie 4–16 Stunden Zeit haben und technisch erfahren sind
Beauftragen macht Sinn, wenn:
- Sie ein angepasstes Template oder ein Custom-Template nutzen
- Sie viele Plugins betreiben oder unsicher über deren Kompatibilität sind
- Sie keine Staging-Umgebung haben
- Die Zeit bis zum 27. September knapp wird
- Sie das Update gleichzeitig mit der Garantielabel-Konfiguration erledigen wollen
Als zertifizierter JTL Servicepartner übernehmen wir den kompletten Update-Prozess: Plugin-Kompatibilitätsprüfung, Template-Abgleich, Staging-Test, Live-Deployment — und die Garantielabel-Konfiguration in einem Schritt. So kommt Ihr Shop rechtssicher und stabil auf 5.8.0.
FAQ: Die häufigsten Fragen zum JTL Shop Update auf 5.8
Wie lange dauert ein JTL Shop Update auf 5.8?
Das hängt von Ihrem Shop ab. Standardshops mit unveränderten Templates und wenigen Plugins schaffen das in 2–4 Stunden. Shops mit angepassten Templates und vielen Plugins müssen mit mindestens 8–16 Stunden rechnen.
Muss ich alle Plugins vor dem Update deaktivieren?
Nicht zwingend, aber Sie müssen alle Plugins vorher auf 5.8.0-Kompatibilität geprüft haben. Inkompatible Plugins sollten Sie vor dem Update deaktivieren, um Fehler auf dem Staging zu vermeiden.
Kann ich das Update direkt auf dem Live-Shop einspielen?
Wir raten davon dringend ab. Spielen Sie das Update immer zuerst auf einer Staging-Umgebung ein und testen Sie ausgiebig, bevor Sie es auf den Live-Shop übertragen.
Was ist ein Template-Diff und muss ich den kennen?
Ein Template-Diff ist eine Datei, die zeigt, welche Template-Codezeilen sich zwischen zwei Versionen geändert haben. Wer das Standard-Nova-Template unverändert nutzt, muss ihn nicht aktiv bearbeiten. Wer das Template angepasst hat, muss ihn sichten und eigene Änderungen ggf. anpassen.
Mein Plugin ist nicht kompatibel mit 5.8.0 — was nun?
Zuerst: Beim Plugin-Hersteller nachfragen, wann eine kompatible Version erscheint. Falls die Deadline näher rückt: Das Plugin temporär deaktivieren und auf eine Alternativlösung umstellen. Als letzter Ausweg: Das Update auf 5.8.0 verschieben und bis dahin die Plugin-Lösung für die Garantielabels nutzen.
Gibt es ein Rollback, wenn das Update schiefläuft?
Nur wenn Sie vorher ein vollständiges Backup erstellt haben. Ohne Backup ist ein Zurücksetzen nicht möglich.
