JTL-Shop 5.7 Plugin-Fehler: Was hinter SHOP-9550, SHOP-9548 und SHOP-9564 steckt — und wie du sie behebst

Auf einen Blick

• ✓JTL-Shop 5.7.0 enthielt vier dokumentierte Plugin-Fehler (SHOP-9550, SHOP-9548, SHOP-9564, SHOP-9566) — alle vier sind mit dem Update auf 5.7.1 vom 7. Mai 2026 behoben.
• ✓Die gefährlichsten Fehler: SHOP-9564 konnte über Multi-Select-Dropdowns in Plugin-Einstellungen einen Fatal Error auslösen und den Shop lahmlegen — SHOP-9566 blockierte still den kompletten Wawi-Abgleich.
• ✓Wer noch auf 5.7.0 läuft, sollte vor dem Update unbedingt ein vollständiges Backup anlegen und alle Plugins auf 5.7-Kompatibilität prüfen — die Vlarom E-Commerce Agentur übernimmt diesen Schritt auf Wunsch.

Nach einem Major-Update ist der erste Blick ins Plugin-Verzeichnis Pflicht. Bei JTL-Shop 5.7.0 galt das mehr als sonst. Nicht wegen der neuen Features, sondern wegen der Bugs, die still im Hintergrund Schaden anrichten konnten. Im JTL-Forum diskutierten innerhalb weniger Tage nach dem 5.7.0-Release Dutzende Händler und Entwickler über die Checkbox-Sperre und den fehlenden Widerrufsbutton. Die Vlarom E-Commerce Agentur als JTL Service Partner Gold in Ahrensfelde bei Berlin sieht solche Wellen früh. Für diese vier Probleme haben wir klare Diagnose-Wege.

Die Fehler in 5.7.0 trafen unterschiedliche Bereiche: Plugin-Konfiguration, Rechtspflichten, Shop-Stabilität und Wawi-Synchronisation. Wir gehen die vier Issuetracker-Tickets durch, konkret und ohne Umwege.

primary

SHOP-9550 — Checkboxen in Plugin-Einstellungen lassen sich nicht deaktivieren

In JTL-Shop 5.7.0 konnten Händler Plugin-Einstellungen nicht mehr vollständig konfigurieren: Checkboxen, die man abwählen wollte, blieben nach dem Speichern aktiv. Ein JTL-Entwickler im Forum formulierte es direkt: „5.7 gehört wegen dieses Bugs zurückgezogen.“ Das Symptom trat bei praktisch allen Drittanbieter-Plugins auf, die Boolean-Werte über das Standard-Plugin-Framework speichern.

Betroffen waren zum Beispiel Versand-Plugins, Zahlungsarten-Konfigurationen und SEO-Erweiterungen: überall dort, wo Checkboxen als An/Aus-Schalter für bestimmte Funktionen genutzt werden. Die Einstellung schien gespeichert, war es aber nicht. Das führte in der Praxis zu unerwartetem Verhalten, das schwer zu diagnostizieren war. Vlarom empfiehlt, bei verdächtigen Plugin-Einstellungen nach dem Update auf 5.7.1 jeden Wert einmal manuell zu prüfen — nicht blind auf den gespeicherten Status zu vertrauen.

highlight

SHOP-9548 — Widerrufsbutton starr an Linkgruppe ‚Fuss' gebunden

Der Widerrufsbutton ist ab dem 19. Juni 2026 für B2C-Shops Pflicht. Die EU-Richtlinie 2019/2161 (Omnibus-Richtlinie, umgesetzt in §§ 356 ff. BGB) schreibt vor, dass Verbraucher ihren Widerruf über eine klar zugängliche elektronische Schaltfläche erklären können müssen. JTL hat den Button in 5.7 implementiert, aber in 5.7.0 war die Anzeige starr an die Linkgruppe mit dem Template-Namen ‚Fuss' gekoppelt. Wer keine Linkgruppe dieses Namens hatte, sah den Button schlicht nicht.

Die Bedingung `` im Template `box_linkgroups.tpl` war der Kern des Problems. Shops mit anderem Linkgruppen-Setup, mit mehrsprachigen Fußzeilen oder mit stark angepassten Themes waren besonders anfällig. Ein Händler im JTL-Forum: „Online-Widerrufsformular existiert nirgends — die Seite leer und ich finde auch nichts wo man da ein Formular konfigurieren könnte." Für B2C-Händler bedeutete dieser Bug: rechtliche Compliance-Lücke kurz vor der Deadline. Laut Vlarom-Projekterfahrung war dieser Fehler bei Shops mit angepassten NOVAChild-Templates am häufigsten — weil diese oft vom Standard-Linkgruppen-Namen abweichen.

warning

SHOP-9564 — Multi-Select-Dropdowns in Plugins lösen Fatal Error aus

Dieser Fehler war der schwerwiegendste: Wenn ein Plugin eine Mehrfachauswahl-Liste (Multi-Select-Dropdown) in seinen Einstellungen anbot und kein Wert ausgewählt war, konnte das in JTL-Shop 5.7.0 zu einem Fatal Error führen. Der Shop-Adminbereich war dann nicht mehr nutzbar. Technisch steckte dahinter ein `unserialize()` TypeError, der auftrat, wenn ein dynamisches Select-Feld keinen gespeicherten Wert hatte.

In der Praxis betraf das vor allem frisch installierte Plugins, die ihre Einstellungen noch nicht vollständig gesetzt hatten, sowie Plugins nach einem Update auf eine neue Version. Der Fehler war reproduzierbar und trat nicht immer sofort auf, was die Diagnose erschwerte. Wer ihn erwischte, stand vor einem stummen weißen Adminbereich ohne hilfreiche Fehlermeldung. Die Vlarom E-Commerce Agentur hat diesen Fehler bei zwei Kundenshops diagnostiziert — in beiden Fällen war ein frisch installiertes Zahlungsarten-Plugin der Auslöser.

muted

SHOP-9566 — Automatische Weiterleitungen blockieren den Wawi-Abgleich

Wenn Produkt-URLs in JTL-Shop geändert werden, legt das System automatisch Weiterleitungen an. In 5.7.0 konnte eine zirkuläre Weiterleitung die URL-Verfügbarkeitsprüfung triggern, die dann eine undefined function `__()` rief und damit den gesamten Wawi-Sync abbrachte. Der Abgleich zwischen JTL-Wawi und Shop lief scheinbar normal, lieferte aber keine Daten mehr.

Das Tückische: Der Fehler war im Frontend nicht sichtbar. Bestellungen kamen noch rein, aber Lagerbestände und Produktdaten wurden nicht mehr korrekt übertragen. Erst ein Blick in die Wawi-Sync-Logs oder in die PHP-Fehlerprotokolle zeigte das Problem. Wer eben viele URL-Änderungen durch laufende SEO-Optimierungen hatte, trug ein besonders hohes Risiko. Vlarom rät: nach jedem Major-Update einen manuellen Sync-Testlauf anstoßen und die Logs aktiv prüfen — stumme Sync-Fehler sind die gefährlichste Kategorie.

Ob du noch auf 5.7.0 läufst oder nach dem Update auf 5.7.1 prüfen willst ob alles sauber ist: dieser Plan führt dich durch. Laut JTL-Dokumentation sollte jeder Schritt zuerst auf einem Staging-System getestet werden, bevor er im Live-Shop angewandt wird. Mehr zum Update-Prozess selbst findest du in unserem Artikel zur JTL-Shop 5.7 Update-Anleitung.

Vor jedem Schritt an einem Produktiv-Shop: vollständiges Backup der Datenbank und aller Shop-Dateien. Das gilt auch wenn du nur die Version prüfst. Im JTL-Shop-Backend unter Systemeinstellungen die aktuelle Versionsnummer notieren. Läuft dein Shop noch auf 5.7.0, ist das Update auf 5.7.1 der nächste Schritt. Aber erst nach dem Backup. Wir haben in Kundenprojekten erlebt, dass Shops nach abgebrochenen Updates in einem inkonsistenten Zustand landeten, aus dem nur ein sauberes Backup herausführte. Verweise auf die offizielle Update-Dokumentation: guide.jtl-software.com — JTL-Shop updaten.

JTL-Shop 5.7.1 ist am 7. Mai 2026 erschienen und behebt alle vier Fehler (SHOP-9550, SHOP-9548, SHOP-9564, SHOP-9566). Das Update wird über den Extension-Store oder via Lizenz-Download eingespielt. Vor dem Update: JTL-Worker stoppen, Objekt-Cache leeren, Plugins temporär deaktivieren. Wichtig: PHP-Version prüfen — 5.7 setzt PHP 8.2 als Minimum, 8.5 wird unterstützt, PHP 8.1 und älter führen nach dem Update zu 500er-Fehlern.

Nach dem Update auf 5.7.1 jeden Plugin reaktivieren und die Einstellungsseite öffnen. Checkboxen setzen und wieder entfernen, speichern, Seite neu laden, Wert prüfen. Bei Multi-Select-Feldern mindestens einen Wert auswählen, dann auf keinen Wert zurücksetzen und speichern. Wenn dabei ein Fatal Error oder eine weiße Seite erscheint: Plugin-Anbieter informieren und auf eine 5.7-kompatible Version warten. Das alte JTL-PayPal-Plugin (nicht PayPal Commerce Platform) macht auf PHP 8.1+ bekannte Probleme. Unbedingt vor dem Update aus dem `/plugins`-Verzeichnis entfernen.

Im JTL-Shop-Backend unter Eigene Inhalte, Eigene Seiten prüfen ob die Spezialseite „Online-Widerrufsformular“ existiert. Falls nicht: manuell anlegen. Dann in den Linkgruppen-Einstellungen sicherstellen, dass die Fußzeile-Linkgruppe den Template-Namen „Fuss“ trägt. Alternativ lässt sich nach dem Update auf 5.7.1 der Button über die überarbeitete Konfiguration einrichten, die nicht mehr starr an den Linkgruppen-Namen gebunden ist. Detaillierte Konfigurations-Hinweise gibt die offizielle JTL-Dokumentation: guide.jtl-software.com — Rechtliches im JTL-Shop. Hintergrund zur Widerrufsbutton-Pflicht ab 19.06.2026 erklärt auch der JTL-Blog.

Nach dem Update auf 5.7.1 einen manuellen Wawi-Abgleich anstoßen und die Sync-Logs auf Fehler prüfen. Falls SHOP-9566 aktiv war, können zirkuläre Weiterleitungen noch in der Datenbank stehen. Im JTL-Shop-Backend unter SEO, Weiterleitungen alle Weiterleitungen auf Zirkelverweise prüfen: A → B → A ist ein Zirkel. Solche Einträge löschen. Ein vollständiger Test-Sync nach dem Bereinigen bestätigt, ob der Abgleich wieder sauber läuft. Bei anhaltenden Sync-Problemen hilft ein Blick in die PHP-Fehlerprotokolle auf dem Server.

Autor

Alexander Luft

JTL Service Partner Gold · Vlarom E-Commerce Agentur · Ahrensfelde bei Berlin