JTL-Shop 5.1 ist im September 2021 erschienen und war das erste große Feature-Update nach 5.0: Suche in Merkmalfiltern, Blackline-Theme, eigene Länderverwaltung und native Unterstützung für JTL-Vouchers. Für Ihren deutschen Shop sind die neuen Texte nach dem Update sofort da. In jeder weiteren Sprache fehlen sie jedoch, und ausländische Kundinnen und Kunden sehen deutsche Platzhalter, Buttons oder leere Stellen. Dieser Artikel listet alle Texte auf, die sich mit 5.1 geändert haben, und zeigt, wie Sie sie übersetzen.
Was ist neu in JTL-Shop 5.1?
Laut JTL-Blog und offiziellem Release-Thread im JTL-Forum sind das die wichtigsten Neuerungen:
- PHP 8.0 und MySQL 8.0 werden unterstützt.
- Suche in Merkmalfiltern: Lange Filterlisten lassen sich per Suchfeld eingrenzen, standardmäßig ab 20 Merkmalwerten. Dafür braucht der Shop die neuen Texte
filterSearchPlaceholder(„Suchen in %s“) unddeleteFilter. - Blackline: ein neues, dunkles Theme für das NOVA-Template.
- Linke Sidebar im NOVA-Template lässt sich für alle Seitentypen aktivieren.
- Native Unterstützung für JTL-Vouchers (Gutscheinverwaltung). Passend dazu gibt es den Platzhalter
voucherFlexPlaceholder(„Gutscheinwert in %s“) auf der Artikelseite. - Änderungsprotokoll im Backend, das Änderungen an Shop-Einstellungen mit Zeitstempel festhält.
- Länderverwaltung im Shop, unabhängig von JTL-Wawi: Länder umbenennen, ergänzen und shopspezifische Regeln für Registrierung und Rechnungsadresse festlegen.
Dazu kamen Sicherheits- und Performance-Verbesserungen sowie zahlreiche Fehlerbehebungen. Viele der neuen Sprachvariablen gehören zu kleineren Frontend-Verbesserungen, etwa einem eigenen Coupon-Formular im Checkout, dem Button „Alle Artikel löschen“ in der Vergleichsliste oder der Angabe des Gesamtgewichts im Warenkorb.
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, Niederländisch, Polnisch & Co. gibt es nach dem Update keinen Eintrag. Geänderte deutsche Texte werden ebenfalls nur in den Standardsprachen angepasst, und wenn JTL E-Mail-Vorlagen überarbeitet, behalten Ihre Fremdsprachen den alten Stand.
Diese 17 Sprachvariablen sind in JTL-Shop 5.1 neu
Wir haben die offiziellen Installationsdatenbanken von JTL-Shop 5.0 und 5.1 verglichen. Diese Variablen brauchen in jeder Fremdsprache eine Übersetzung:
| Sektion | Variable | Deutscher Originaltext |
|---|---|---|
| global | deleteFilter | Diesen Filter entfernen |
| productOverview | filterSearchPlaceholder | Suchen in %s |
| productDetails | productMatrixDesc | (leer) |
| productDetails | productMatrixTitle | Warenkorbmatrix |
| productDetails | voucherFlexPlaceholder | Gutscheinwert in %s |
| checkout | couponCodePlaceholder | Coupon-Code eingeben |
| checkout | couponFormDesc | Kostenfrei ausgestellten Aktionscoupon/Werbecoupon einlösen. |
| checkout | couponSubmit | Coupon einlösen |
| checkout | couponUnavailable | Für den aktuellen Inhalt des Warenkorbs existiert kein verfügbarer Coupon. |
| login | passwordTooLong | Das Passwort ist zu lang. |
| comparelist | comparelistDeleteAll | Alle Artikel löschen |
| comparelist | hideLabels | Labels verstecken |
| comparelist | showLabels | Labels anzeigen |
| product rating | noReviewsInAllLang | Es gibt noch keine Bewertungen. |
| product rating | reviewsInAllLang | Alle Bewertungen: |
| basket | cartTotalWeight | Das Gesamtgewicht aller Artikel im Warenkorb beträgt %s kg. |
| wishlist | warningInvisibleItems | %s Artikel sind derzeit nicht verfügbar und werden deshalb nicht angezeigt. |
Hinweis: productMatrixDesc ist von JTL auch auf Deutsch und Englisch leer angelegt. Sie können dort optional einen Beschreibungstext für die Warenkorbmatrix hinterlegen. Achten Sie bei Texten mit %s darauf, den Platzhalter in der Übersetzung beizubehalten, denn dort setzt der Shop später z. B. den Filternamen, die Währung oder das Gewicht ein.
Diese deutschen Texte hat JTL geändert
Drei bestehende Variablen haben mit 5.1 einen neuen deutschen Text bekommen. Die wichtigste Änderung betrifft useCoupon: Weil es jetzt ein eigenes Coupon-Formular mit couponSubmit („Coupon einlösen“) gibt, heißt der bisherige Text nun „Aktionscoupon einlösen“. Prüfen Sie in Ihren Fremdsprachen, ob beide Buttons sinnvoll unterscheidbar übersetzt sind.
| Sektion | Variable | Bisher (5.0) | Neu (5.1) |
|---|---|---|---|
| checkout | useCoupon | Coupon einlösen | Aktionscoupon einlösen |
| errorMessages | audioTagNotSupported | Das HTML5 <audio> Tag wird von Ihrem Browser nicht unterstützt. | Das HTML5 audio-Tag wird von Ihrem Browser nicht unterstützt. |
| errorMessages | videoTagNotSupported | Das HTML5 <video> Tag wird von Ihrem Browser nicht unterstützt. | Das HTML5 video-Tag wird von Ihrem Browser nicht unterstützt. |
Entfernt wurden mit JTL-Shop 5.1 keine Sprachvariablen.
Diese E-Mail-Vorlagen haben sich geändert
Neue E-Mail-Vorlagen gibt es in 5.1 nicht. JTL hat aber sieben bestehende Vorlagen überarbeitet. Bei sechs davon blieb der Betreff gleich, geändert wurde der Inhalt. Die Checkbox-Vorlage an den Shopbetreiber hat erstmals einen Betreff bekommen:
| Vorlage | Modul-ID | Änderung |
|---|---|---|
| Kupon (Standard / Versandkupon) | core_jtl_kupon | Inhalt geändert |
| Bestellbestätigung | core_jtl_bestellbestaetigung | Inhalt geändert |
| Neukundenregistrierung | core_jtl_neukundenregistrierung | Inhalt geändert |
| Accounterstellung durch Shopbetreiber | core_jtl_accounterstellung_durch_betreiber | Inhalt geändert |
| Kunden werben Kunden Belohnung | core_jtl_kundenwerbenkundenboni | Inhalt geändert |
| Bestellung aktualisiert | core_jtl_bestellung_aktualisiert | Inhalt geändert |
| Checkbox Emailvorlage | core_jtl_checkbox_shopbetreiber | Neuer Betreff „Auswahl einer Checkboxoption“ (vorher leer) |
Besonders wichtig sind Bestellbestätigung und Bestellung aktualisiert, weil diese E-Mails jede Kundin und jeder Kunde erhält. Haben Sie Ihre Fremdsprachen-Vorlagen vor 5.1 übersetzt, basieren sie auf dem alten Stand. Vergleichen Sie diese Vorlagen am besten mit der aktuellen deutschen Version.
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, dabei
%sbeibehalten. - Die drei geänderten Variablen (
useCoupon,audioTagNotSupported,videoTagNotSupported) an den neuen deutschen Text anpassen. - Unter Administration › E-Mails › Vorlagen die sieben geänderten Vorlagen mit der deutschen Fassung vergleichen und in jeder Sprache nachziehen. Smarty-Variablen unverändert übernehmen.
- Template-Cache leeren und Merkmalfilter, Coupon-Formular, Vergleichsliste und Warenkorb im Frontend in jeder Sprache testen.
Variante 2: Sprachpaket einspielen
Unsere Sprachpakete für JTL-Shop 5 sind aktuell für JTL-Shop 5.8 und enthalten alle Sprachvariablen, die mit Version 5.1 hinzugekommen sind, in allen 20 Sprachen. Mit dem kostenlosen Plugin JTL Translate Pro spielen Sie die Sprachdatei im Modus „Vorhandene behalten, nur neue importieren“ ein. Ihre eigenen Anpassungen bleiben erhalten, vorher wird automatisch ein Backup angelegt. Wie die Installation Schritt für Schritt funktioniert, zeigt unsere Anleitung zur Installation der Sprachdateien.
Alle Texte bis JTL-Shop 5.8 in 20 Sprachen
Die Sprachpakete enthalten alle Sprachvariablen und E-Mail-Vorlagen bis JTL-Shop 5.8, inklusive der Neuerungen aus 5.1. Einmal kaufen, per kostenlosem Plugin einspielen.
Checkliste nach dem Update auf 5.1
- Merkmalfilter mit vielen Werten öffnen und Suchfeld und Platzhalter in jeder Sprache prüfen
- Coupon-Formular im Checkout in jeder Sprache testen, auch die Meldung „kein verfügbarer Coupon“
- Vergleichsliste aufrufen: „Alle Artikel löschen“ und „Labels anzeigen/verstecken“ prüfen
- Artikel ohne Bewertungen öffnen und den Hinweistext prüfen
- Warenkorb auf die Angabe des Gesamtgewichts prüfen
- Testbestellung in jeder Sprache auslösen und die Bestellbestätigung kontrollieren
Weiter geht es mit der Folgeversion: JTL-Shop 5.2 Update: neue Sprachvariablen. Die jüngsten Änderungen rund um Widerrufsbutton und Garantie-Label finden Sie im Artikel JTL-Shop 5.8: Widerrufsbutton, Gewährleistungs- & Garantie-Label übersetzen.