1. Update oder Upgrade?
JTL nutzt Versionsnummern im Format MAJOR.MINOR.PATCH. Ein Update geht innerhalb einer Major-Version auf die nächste Minor-Version, etwa von 5.2 auf 5.3, und bringt in der Regel Bugfixes und oft neue Funktionen. Ein Upgrade geht auf die nächste Major-Version, etwa von 4 auf 5, und kann inkompatible Änderungen an Templates und Plugin-Schnittstellen mitbringen.
Voraussetzung für ein Update ist eine gebuchte Edition mit JTL-Shop und gültigem Abonnement sowie mindestens JTL-Shop 5.0.0. Lies vorher die Systemvoraussetzungen und die Releaseposts im JTL-Forum, auch die der Versionen, die du überspringst.
2. Vorbereitung: Wartungsmodus, Sicherung, Abgleich pausieren
Nutzt du ein individuell angepasstes Template, lass es laut JTL vorher von deinem Servicepartner oder Entwickler für die neue Version vorbereiten. Prüfe außerdem, ob deine Plugins mit der neuen Version kompatibel sind oder ob es kompatible Versionen gibt.
- Im Backend unter Darstellung > Einstellungen > Global den Wartungsmodus auf Ja stellen.
- Alle Shop-Dateien sichern, besonders den Ordner /templates/ und die Datei /includes/config.JTL-Shop.ini.php.
- Ab jetzt keinen Abgleich mit JTL-Wawi mehr durchführen: JTL-Worker beenden oder den Onlineshop-Abgleich abschalten, oder den Shop in JTL-Wawi unter Plattformen > Verkaufskanäle für den Abgleich sperren.
- Objekt-Cache unter Administration > System > Cache mit „Gesamten Objekt-Cache leeren“ deaktivieren.
- Plugins, die du nicht mehr brauchst, deinstallieren und ihre Dateien aus /includes/plugins bzw. /plugins entfernen. Alle Plugins, die du weiter nutzt, deaktivieren.
- Die Datenbank sichern oder von deinem Hoster sichern lassen.
3. Dateien aktualisieren
Das Installationspaket lädst du im JTL-Kundencenter unter Bestellungen & Lizenzen > Onlineshop > Shop Editionen über Aktionen > Downloads herunter. Im entpackten Paket löschst du den Ordner install und die Datei shopinfo.xml, sie werden beim Update nicht gebraucht.
Hast du .htaccess, admin/.htaccess oder robots.txt angepasst, übertrage deine Änderungen in die neuen Dateien. Überschreibe die neuen .htaccess-Dateien nicht mit den alten, denn neue Versionen können dort Änderungen enthalten. Liegt dein angepasstes Template in einem Standardordner, benenne die neuen Ordner /templates/NOVA bzw. /templates/Evo vorher um, sonst werden sie überschrieben.
Lade dann die Dateien per FTP über die bestehenden Shop-Dateien und stelle das FTP-Programm auf binäre Übertragung. Prüfe, ob alle Dateien angekommen sind.
4. Datenbank-Update und danach
Beim nächsten Login ins Backend leitet dich der Shop zum Update-Menü, sonst findest du es unter Administration > System > Aktualisieren. JTL empfiehlt, sich dafür im abgesicherten Modus anzumelden (im Anmeldefenster unter Erweitert). Lege dort über Sicherungskopie noch einmal ein Backup der Datenbank an und starte dann das Datenbank-Update.
Gibt es dabei einen Fehler, dokumentiere ihn und wende dich an den JTL-Shop-Support oder deinen Servicepartner. Willst du abbrechen, reicht es laut JTL nicht, nur die Shop-Dateien auf den alten Stand zu bringen. Danach löschst du verwaiste Dateien unter Administration > Fehlerbehebung > Diagnose > Dateistruktur > Details. JTL nennt das sicherheitsrelevant, weil alte Dateien Sicherheitslücken enthalten können.
Zum Schluss prüfst du den Shop mit den Prüfmethoden unter Administration > Fehlerbehebung > Diagnose und im Frontend. Teste dabei auch die Suche mit ein paar typischen Begriffen.
Das Grumeria-Plugin aktualisierst du getrennt davon wie jedes Plugin im Backend. Fällt Grumeria aus oder ist das Plugin deaktiviert, bleibt die normale JTL-Suche aktiv.