JTL-Shop 5.4 ist im Oktober 2024 erschienen und hat zwei Funktionen ins Frontend gebracht, die Ihre Kundinnen und Kunden direkt sehen: die 2-Faktor-Authentifizierung im Kundenkonto und überarbeitete Gratisgeschenke im Warenkorb. Dafür hat JTL 46 neue Sprachvariablen angelegt, zwei bestehende Texte geändert, eine Variable entfernt und die E-Mail-Vorlage „Bestellung aktualisiert“ angepasst. Im deutschen und englischen Shop ist das nach dem Update erledigt – in jeder weiteren Sprache nicht.
Was ist neu in JTL-Shop 5.4?
- 2-Faktor-Authentifizierung für Kunden: Shopkunden können ihr Kundenkonto zusätzlich mit einer Authenticator-App absichern, inklusive QR-Code und Notfall-Codes.
- Gratisgeschenke überarbeitet: umfassendes Refactoring mit Verbesserungen in der Benutzerfreundlichkeit.
- ConsentManager: Die Akzeptanzquote wird im Backend gemessen und visualisiert.
- „Kunden kauften auch“: Die Empfehlungslogik wurde überarbeitet.
- Weiterleitungen und Logbuch: Weiterleitungen wurden überarbeitet, das Logbuch erweitert.
- Code-Qualität: PSR-12-Standard, mehr Unit-Tests und PHPStan-Prüfungen; seit 5.2.0 als veraltet markierte Funktionen wurden entfernt – relevant für ältere Plugins und Templates.
Für die Übersetzung zählen vor allem die ersten beiden Punkte: Sie sind für den Großteil der neuen Texte verantwortlich.
Warum die Übersetzungen nach dem Update fehlen
JTL legt neue Sprachvariablen per Datenbank-Migration an – aber nur für Deutsch und Englisch. Für Französisch, Italienisch, Polnisch & Co. gibt es nach dem Update keinen Eintrag, der Shop zeigt den deutschen Text oder eine leere Stelle. Geänderte deutsche Texte und angepasste E-Mail-Vorlagen werden in den Fremdsprachen ebenfalls nicht nachgezogen.
Die neuen Sprachvariablen im Überblick
Die 46 neuen Variablen verteilen sich auf drei Funktionsbereiche:
- 2-Faktor-Authentifizierung (Sektion
account datasowie einige inglobalundlogin): Einrichtungsanleitung, QR-Code, Notfall-Codes, Warnhinweise und Fehlermeldungen wie „Ungültiger Code.“ - Gratisgeschenke (Sektionen
basket,productDetails,errorMessages): Hinweis im Warenkorb, fehlender Betrag bis zum nächsten Geschenk, Hinweis auf der Artikelseite. - Kontosicherheit: Hinweise zum automatischen Logout nach Passwort- oder 2FA-Änderung sowie ein Hinweis, wenn ein Kunde in die Standardkundengruppe verschoben wurde.
Alle 46 neuen Sprachvariablen in JTL-Shop 5.4
Grundlage ist der Vergleich der offiziellen JTL-Installationsdatenbanken 5.3 und 5.4. Diese Variablen brauchen in jeder Fremdsprache eine Übersetzung:
| Sektion | Variable | Deutscher Originaltext |
|---|---|---|
| global | accountInvalidGroup | <b>Sie wurden zur Standardkundengruppe hinzugefügt</b><br>Aufgrund von Unstimmigkeiten bei Ihrer vorherigen Kundengruppe wurden Sie in die Standardkundengruppe verschoben. Bitte setzen Sie sich mit dem Shopbetreiber in Verbindung, um den Grund dafür zu klären. Die Verschiebung kann beispielsweise dazu führen, dass Ihnen andere Preise als zuvor angezeigt werden. |
| global | accountInvalidTwoFA | Ungültiger Code. |
| global | accountSetTwoFA | Zum Einloggen ist ein zweiter Faktor erforderlich. |
| global | han | HAN |
| productDetails | productAvailableAsFreeGift | Dieses Produkt steht Ihnen als Gratisgeschenk zur Verfügung. Bitte fügen Sie es direkt in Ihrem Warenkorb hinzu. |
| account data | account | Konto |
| account data | clickHereToCreateQR | Um einen neuen QR-Code zu erzeugen, klicken Sie bitte hier: |
| account data | close | Schließen |
| account data | codeCreate | Neuen Code erzeugen |
| account data | codeCreateAgain | Neue Codes erzeugen |
| account data | emergencyCodeCreate | Neue Notfall-Codes erzeugen |
| account data | emergencyCodes | Notfall-Codes |
| account data | enableTwoFA | 2-Faktor-Authentifizierung aktivieren |
| account data | enableTwoFAwarning | Bitte beachten Sie, dass Sie nach dem Speichern mit diesem Benutzerkonto keine Möglichkeit mehr haben, sich einzuloggen, falls Sie keinen Zugriff mehr auf die Authenticator App auf Ihrem Mobilgerät haben sollten! |
| account data | infoScanQR | Scannen Sie den hier abgebildeten QR-Code mit der Authenticator App auf Ihrem Handy. |
| account data | manageTwoFA | 2-Faktor-Authentifizierung bearbeiten |
| account data | manageTwoFADesc | Hier können Sie die 2-Faktor-Authentifizierung aktivieren, deaktivieren und bearbeiten. |
| account data | ||
| account data | save | Speichern |
| account data | shop | Shop |
| account data | shopEmergencyCodes | Notfall-Codes für Ihr Kundenkonto |
| account data | twoFAAppWarning | Für die 2-Faktor-Authentifizierung müssen Sie eine Authenticator App Ihrer Wahl auf Ihrem Smartphone installieren, z. B. die Google Authenticator App. |
| account data | twoFAAuthCodeTooltip | Wo finde ich den Authentifizierungs-Code? |
| account data | twoFAAuthCodeTooltipDescription | Der Authentifizierungs-Code wird Ihnen in der Authenticator App angezeigt. |
| account data | twoFactorAuthCode | Authentifizierungs-Code/Notfall-Code |
| account data | twoFactorAuthentication | 2-Faktor-Authentifizierung |
| account data | twoFAEmergencyCodeDescription | Mithilfe von Notfall-Codes können Sie sich auch ohne 2-Faktor-Authentifizierung in Ihrem Kundenkonto anmelden, obwohl Sie diese aktiviert haben. Dies ist z. B. notwendig, wenn Sie Ihr Smartphone verloren haben oder versehentlich die Authenticator App von Ihrem Smartphone gelöscht haben. |
| account data | twoFAEmergencyCodesNotice | Hinweis: Drucken Sie die Notfall-Codes direkt aus oder speichern Sie sie digital. Die Notfall-Codes können nur einmal in Ihrem Kundenkonto eingesehen und jeder Code kann nur einmal verwendet werden. |
| account data | twoFAEmergencyCodeTooltip | Was sind Notfall-Codes? |
| account data | twoFAEnableConfirmMessage | Wenn Sie die 2-Faktor-Authentifizierung aktivieren, können Sie sich nur noch mithilfe Ihres Smartphones anmelden. |
| account data | twoFAEnableConfirmTitle | Wollen Sie wirklich die 2-Faktor-Authentifizierung aktivieren? |
| account data | twoFAEnableWarning | Wenn Sie die 2-Faktor-Authentifizierung aktivieren, können Sie sich nur noch mithilfe Ihres Smartphones anmelden. |
| account data | twoFAtutorialStep1 | Öffnen Sie die Authenticator App Ihrer Wahl. |
| account data | twoFAtutorialStep2 | Scannen Sie mit der Authenticator App den unten stehenden QR-Code. |
| account data | twoFAtutorialStep3 | Sie haben die Authenticator App erfolgreich mit Ihrem Kundenkonto verbunden. |
| account data | twoFAtutorialTitle | Kundenkonto mit der Authenticator App verbinden |
| account data | warningAuthSecretOverwrite | Der bisherige zweite Faktor und die Notfallcodes werden ersetzt. Möchten Sie fortfahren? |
| login | loggedOutDueTo2FAChange | Sie wurden automatisch ausgeloggt, weil Einstellungen Ihrer 2-Faktor-Authentifizierung geändert wurden. |
| login | loggedOutDueToPasswordChange | Sie wurden automatisch ausgeloggt, weil Ihr Passwort geändert wurde. Falls Sie nicht selbst Ihr Passwort geändert haben, setzen Sie Ihr Passwort über die "Passwort vergessen"-Funktion zurück oder wenden Sie sich an den Shopbetreiber. |
| basket | chooseFreeGiftNow | Jetzt auswählen |
| basket | freeGiftsAvailable | Gratisgeschenk erhältlich |
| basket | freeGiftsAvailableText | Ihnen steht mindestens ein Gratisgeschenk zur Verfügung. |
| basket | freeGiftsSeeAll | Alle Gratisgeschenke anzeigen |
| basket | freeGiftsStillMissingAmount | Es fehlen noch %s |
| basket | freeGiftsStillMissingAmountForNextFreeGift | Es fehlen noch %s, um aus weiteren Gratisgeschenken wählen zu können. |
| errorMessages | freegiftsNotAvailable | Das Gratisgeschenk ist leider nicht verfügbar. |
Achten Sie beim Übersetzen auf die Platzhalter: %s in den Gratisgeschenk-Texten wird durch den fehlenden Betrag ersetzt, und HTML-Tags wie <b> und <br> in accountInvalidGroup müssen erhalten bleiben.
Geänderte Sprachvariablen
Bei zwei bestehenden Variablen hat JTL den deutschen Text angepasst:
| Sektion | Variable | Bisher (5.3) | Neu (5.4) |
|---|---|---|---|
| login | changePasswordDesc | Füllen Sie bitte das Formular aus, um Ihr Passwort zu ändern. | Bitte beachten Sie, dass Sie aus allen aktiven Sessions automatisch ausgeloggt werden, nachdem Sie das Passwort geändert haben. |
| newsletter | newsletterInformedConsent | Bitte senden Sie mir entsprechend Ihrer Datenschutzerklärung regelmäßig und jederzeit widerruflich Informationen zu Ihrem Produktsortiment per E-Mail zu. (mit führendem Zeilenumbruch/Leerraum) | Gleicher Wortlaut, führender Zeilenumbruch/Leerraum entfernt |
Inhaltlich relevant ist changePasswordDesc: Der Text weist jetzt darauf hin, dass eine Passwortänderung alle aktiven Sessions beendet. In Fremdsprachen steht dort nach dem Update weiterhin die alte Aufforderung, das Formular auszufüllen – der Hinweis auf den Logout fehlt. Bei newsletterInformedConsent wurde nur Leerraum am Anfang entfernt; hier besteht kein Handlungsbedarf.
Entfernte Sprachvariable
Die Variable cityNotNumeric (Sektion account data, „Der Ort darf keine Zahlen enthalten.“) ist in 5.4 nicht mehr enthalten. Vorhandene Übersetzungen können Sie ignorieren.
Geänderte E-Mail-Vorlage: „Bestellung aktualisiert“
Neue E-Mail-Vorlagen gibt es in JTL-Shop 5.4 nicht. Geändert hat JTL die Vorlage Bestellung aktualisiert (core_jtl_bestellung_aktualisiert). Der Betreff „Ihre Bestellung bei #firma.name# wurde aktualisiert“ ist gleich geblieben, der Inhalt der Vorlage wurde angepasst. Wer die Vorlage in Fremdsprachen aus einer älteren Version übernommen hat, sollte sie mit der deutschen 5.4-Fassung vergleichen und die Änderungen nachziehen.
So übersetzen Sie die neuen Texte
Variante 1: manuell im Shop-Backend
- Unter Administration › Sprachvariablen die Fremdsprache auswählen.
- Nach den Variablennamen aus der Tabelle oben suchen und jeweils eine Übersetzung eintragen.
- Den geänderten Text von
changePasswordDescin jeder Sprache aktualisieren. - Unter Administration › E-Mails › Vorlagen die Vorlage „Bestellung aktualisiert“ öffnen und die Fremdsprachen an die deutsche Fassung angleichen. Smarty-Variablen und Platzhalter wie
#firma.name#unverändert übernehmen. - Template-Cache leeren und die 2FA-Einrichtung im Kundenkonto in jeder Sprache testen.
Bei 46 Variablen pro Sprache ist das spürbar Arbeit – vor allem die längeren Erklärtexte zu Notfall-Codes und Authenticator-App wollen sauber formuliert sein.
Variante 2: Sprachpaket aktualisieren
Unsere Sprachpakete für JTL-Shop 5 sind aktuell für JTL-Shop 5.8 und enthalten alle Sprachvariablen der Version 5.4 in allen 20 Sprachen. Mit dem kostenlosen Plugin JTL Translate Pro spielen Sie das Paket im Modus „Vorhandene behalten, nur neue importieren“ ein – Ihre eigenen Anpassungen bleiben erhalten, vorher wird automatisch ein Backup angelegt.
Alle 5.4-Texte in 20 Sprachen – aktuell für JTL-Shop 5.8
Sprachdatei inklusive aller neuen Variablen für 2-Faktor-Authentifizierung und Gratisgeschenke. Einfach per kostenlosem Plugin JTL Translate Pro einspielen, ab 39 € netto pro Sprache.
Checkliste nach dem Update auf 5.4
- 2-Faktor-Authentifizierung in einem Testkonto in jeder Shop-Sprache einrichten
- Notfall-Codes-Ansicht und Druckfunktion in jeder Sprache prüfen
- Warenkorb mit Gratisgeschenk-Hinweis in jeder Sprache aufrufen
- Passwort in einem Testkonto ändern und den Logout-Hinweis prüfen
- E-Mail „Bestellung aktualisiert“ in jeder Sprache testweise auslösen