Sprachvariablen

Übersicht

In diesem Tab kannst du alle Sprachvariablen zentral an einem Ort verwalten. Sprachvariablen sind Platzhalter für Texte, die anpassbar sind und entweder von JTL oder von uns (wenn es um Plugins geht) vorkonfiguriert wurden. Dazu gehören beispielsweise Texte für Buttons, Hinweise oder Fehlermeldungen. Diese Sprachvariablen lassen sich in verschiedenen Sprachen anpassen. Außerdem kannst du hier neue Sprachvariablen anlegen und den Inhalt nach Belieben anpassen.

Was sind Sprachvariablen?Sprachvariablen (auch Language Variables oder Lang Vars) sind Platzhalter im Code, die zur Laufzeit durch tatsächliche Texte ersetzt werden. Der Vorteil: Texte können einfach angepasst und in mehreren Sprachen gepflegt werden, ohne den Code zu ändern.

Features

Zentrale Verwaltung

Verwalte alle Sprachvariablen (sowohl aus Plugins als auch alle JTL-Sprachvariablen) zentral an einem Ort.

Import & Export

Exportiere und importiere Sprachvariablen als JSON - ideal für Backups und Massenbearbeitung.

Neue Variablen anlegen

Erstelle eigene Sprachvariablen schnell und einfach über das Tool.

Mehrsprachig

Verwalte alle Sprachen deines Shops gleichzeitig - perfekt für internationale Shops.

Plugin-Sprachvariablen

Hier findest du alle Sprachvariablen, die aus Plugins kommen - sowohl von DZM als auch von anderen Plugin-Entwicklern.

Beispiel: Die Nachricht des Tab-Away Notification-Widgets aus OPC Conversion Booster wird über die Sprachvariable dzm_tab_away_message in der Sektion custom gesteuert. Bleibt sie leer, zeigt das Widget automatisch den Standardtext “❤️ Wir vermissen dich!” an.

Interface-Bedienung

Sprache wählen
Suche
Bearbeitung
Aktionen

select

Wähle die Sprache der Sprachvariablen, die du bearbeiten möchtest.Verfügbare Sprachen:

Deutsch (Standard)
Englisch
Weitere Sprachen (abhängig von deiner Wawi-Konfiguration)

Die verfügbaren Sprachen werden in der JTL-Wawi definiert und dann in den Shop übertragen. Neue Sprachen müssen zuerst in der Wawi aktiviert werden.

Workflow für mehrsprachige Shops:

Deutsch bearbeiten

Beginne immer mit der Hauptsprache (meist Deutsch) und pflege alle Texte.

Andere Sprachen

Wechsle dann zur zweiten Sprache und übersetze/passe die Texte an.

Konsistenz prüfen

Stelle sicher, dass alle Sprachen vollständig gepflegt sind.

text

Durchsuche Sprachvariablen nach Namen, Werten, Standardwerten oder Beschreibungen.Suchstrategien:

Nach Variablen-Namen: btn_submit
Nach Inhalt: “Jetzt kaufen”
Nach Plugin: dzm_
Nach Funktion: “error”, “success”, “button”

Die Suche ist case-insensitive und durchsucht alle Felder gleichzeitig. Du musst nicht wissen, ob ein Text im Namen oder Wert steht.

Beispiel-Suchen:

"in den warenkorb" → Findet alle Warenkorb-Buttons
"dzm_resources" → Findet alle Resources-Plugin-Variablen
"error" → Findet alle Fehlermeldungen

Sprachvariablen ändern:

Variable finden

Nutze die Suche oder scrolle durch die Liste.

Wert bearbeiten

Klicke in das Textfeld unter “Wert” und ändere den Text.

Der “Standardwert” zeigt dir den Original-Text - ändere nur den “Wert”, nicht den Standard!

Speichern

Klicke auf “Speichern” um alle Änderungen zu übernehmen.

Änderungen werden erst nach dem Speichern übernommen!

Cache leeren

Leere den Shop-Cache damit die Änderungen im Frontend sichtbar werden.Weg: Backend → System → Cache → Cache leeren

Formatierung beachten:

HTML ist erlaubt: <strong>Text</strong>
Platzhalter erhalten: {0}, {1}, etc.
Sonderzeichen escapen wenn nötig

Wichtiger Hinweis zum Cache

Sprachvariablen-Änderungen nicht sichtbar?Manchmal werden Änderungen der Sprachvariablen im Frontend nicht sofort sichtbar, da diese noch im Shop-Cache hängen.Lösung: Leere deinen Shop-Cache im Backend unter System → Cache → Cache leeren.

Shop Sprachvariablen

Hier findest du alle Sprachvariablen, die aus dem JTL-Shop Core kommen - also alle Standard-Texte des Shops.

Funktionsweise

Die Bedienung ist identisch zu den Plugin-Sprachvariablen:

Sprache wählen

Wähle die zu bearbeitende Sprache aus dem Dropdown.Tipp: Bearbeite zuerst die Hauptsprache komplett, bevor du zu anderen Sprachen wechselst.

Suchen & Filtern

Nutze die Suchfunktion um spezifische Variablen zu finden.Häufige Suchbegriffe:

“add to cart” → Warenkorb-Buttons
“checkout” → Checkout-Prozess-Texte
“shipping” → Versand-bezogene Texte
“error” → Fehlermeldungen
“success” → Erfolgsmeldungen

Bearbeiten & Speichern

Ändere Werte und klicke auf “Speichern”.

JTL-Sprachvariablen beeinflussen das Core-Verhalten des Shops. Sei vorsichtig bei Änderungen!

Export & Import

Exportiere für Backups oder zum Übertragen auf andere Shops.

Für vollständige Backups: Exportiere sowohl Plugin- als auch JTL-Sprachvariablen!

Best Practices für JTL-Variablen

Was du ändern kannst
Vorsicht bei
Nach Updates

Unbedenklich:

Button-Beschriftungen anpassen
Hinweistexte optimieren
Fehlermeldungen kundiger formulieren
Marketing-Texte personalisieren

Beispiele:

"In den Warenkorb" → "Jetzt kaufen"
"Zur Kasse" → "Zur sicheren Kasse"
"Weiter einkaufen" → "Weiterstöbern"

Kritische Texte:

Rechtliche Hinweise (Widerruf, AGB, etc.)
System-Meldungen
Variablen mit Platzhaltern
Technical Labels

Änderungen an rechtlichen Texten sollten immer mit einem Anwalt abgestimmt werden!

Platzhalter erhalten:

❌ Falsch: "Hallo Max" (hart codiert)
✅ Richtig: "Hallo {0}" (Platzhalter bleibt)

Neue Sprachvariablen anlegen

Erstelle eigene Sprachvariablen für Custom-Entwicklungen oder individuelle Texte.

Schritt für Schritt

Namen vergeben

string

required

Vergebe einen eindeutigen Namen für die Sprachvariable.Naming Conventions:

Kleinbuchstaben verwenden
Wörter mit Unterstrichen trennen
Aussagekräftig benennen
Präfix nutzen (z.B. custom_, dzm_)

Beispiele:

✅ dzm_custom_banner_text
✅ custom_checkout_note
✅ my_shop_welcome_message

❌ Banner1 (nicht aussagekräftig)
❌ CUSTOM TEXT (Leerzeichen, Großbuchstaben)
❌ customBannerText (CamelCase vermeiden)

Sektion wählen

select

Wähle eine Sektion zur Gruppierung und schnelleren Auffindbarkeit.Verfügbare Sektionen:

custom (empfohlen für eigene Variablen)
global
checkout
product
account
… (weitere system-spezifische Sektionen)

In der Regel ist “custom” die richtige Wahl für neue benutzerdefinierte Sprachvariablen.

Texte eintragen

object

Trage den Text in allen verfügbaren Sprachen ein.Deutsch: Hauptsprache, sollte immer gepflegt werdenEnglisch: Fallback für internationale KundenWeitere Sprachen: Je nach Shop-Konfiguration

Wenn du eine Sprache nicht ausfüllst, bleibt das Feld leer oder zeigt den Variablen-Namen an.

Variable hinzufügen

Klicke auf “Variable hinzufügen”, um die neue Sprachvariable zu speichern.

Die Variable ist ab sofort in Templates, Plugins und Scripts verwendbar!

Verwendung in Templates

Nach dem Anlegen kannst du die Variable in Smarty-Templates verwenden:

{* In .tpl Dateien *}
{lang key="dzm_custom_banner_text" section="custom"}

{* Mit Fallback *}
{lang key="dzm_custom_banner_text" section="custom" default="Fallback Text"}

{* Mit Platzhaltern *}
{lang key="dzm_welcome_user" section="custom" printf=$userName}

Verwendung in PHP

In PHP-Code kannst du Sprachvariablen so nutzen:

// Einfache Verwendung
$text = Shop::Lang()->get('dzm_custom_banner_text', 'custom');

// Mit Platzhaltern
$text = Shop::Lang()->get('dzm_welcome_user', 'custom');
$text = sprintf($text, $userName);

// In der aktuellen Sprache
$currentLang = Shop::getLanguageID();
$text = Shop::Lang()->get('dzm_custom_banner_text', 'custom', $currentLang);

Export & Import

Backup erstellen

Plugin-Variablen exportieren

Gehe zum Tab “Plugin Sprachvariablen” → Klicke “Exportieren”Dateiname: plugin_langvars_de_2024-02-06.json

JTL-Variablen exportieren

Gehe zum Tab “JTL-Sprachvariablen” → Klicke “Exportieren”Dateiname: jtl_langvars_de_2024-02-06.json

Alle Sprachen wiederholen

Wiederhole für jede aktive Sprache (EN, FR, etc.)

Backup sicher aufbewahren

Speichere alle JSON-Dateien an einem sicheren Ort:

Cloud-Speicher (Dropbox, Google Drive)
Lokale Backup-Festplatte
Versionskontrolle (Git)

Vollständiges Backup:Wenn du alle Sprachvariablen als Backup sichern möchtest, achte unbedingt darauf sowohl die Plugin-Sprachvariablen als auch die JTL-Sprachvariablen zu exportieren!

Import durchführen

Backup-Datei vorbereiten

Stelle sicher, dass du die richtige JSON-Datei hast:

Richtige Sprache?
Richtiger Tab (Plugin vs. JTL)?
Aktuelles Backup?

Import starten

Klicke auf “Select Files” und wähle die JSON-Datei aus.

Import bestätigen

Bestätige, dass bestehende Werte überschrieben werden sollen.

Der Import überschreibt alle Werte in der JSON-Datei - aktuelle Änderungen gehen verloren!

Ergebnis prüfen

Prüfe stichprobenartig ob der Import erfolgreich war.Leere anschließend den Cache.

JSON-Datei-Struktur

Für Massenbearbeitung kannst du die JSON-Datei manuell bearbeiten:

{
  "dzm_custom_banner_text": {
    "name": "dzm_custom_banner_text",
    "section": "custom",
    "value": "Willkommen in unserem Shop!",
    "default": "Welcome to our shop!",
    "description": "Banner text on homepage"
  },
  "dzm_another_variable": {
    ...
  }
}

Nutze einen JSON-Editor oder VS Code mit JSON-Plugin für komfortables Bearbeiten großer Dateien.

Best Practices

Konsistente Benennung

Naming Convention festlegen:

[prefix]_[bereich]_[funktion]_[typ]

Beispiele:
custom_checkout_button_continue
custom_product_label_sale
custom_error_msg_invalid_email
dzm_banner_text_homepage

Vorteile:

Schnelles Auffinden
Klare Zuordnung
Keine Konflikte
Team-freundlich

Dokumentation pflegen

Externe Dokumentation führen:Erstelle eine Tabelle mit allen Custom-Variablen:

Variable	Verwendung	Geändert am	Geändert von
custom_banner_text	Homepage Banner	2024-02-06	Max M.
custom_checkout_note	Checkout Hinweis	2024-01-15	Lisa S.

Oder nutze Kommentare im Code:

{* Custom Variable für Sommer-Aktion 2024 
   Angelegt: 2024-02-06
   Kontakt: marketing@firma.de *}
{lang key="custom_summer_banner" section="custom"}

Regelmäßige Backups

Backup-Routine etablieren:Vor wichtigen Änderungen:

Immer ein Backup erstellen
Datiert und versioniert speichern
An sicheren Ort ablegen

Regelmäßig (monatlich):

Vollständiger Export aller Sprachen
Beide Tabs (Plugin + JTL)
Zusammen mit anderen Shop-Backups speichern

Nach großen Anpassungen:

Sofort neues Backup
Mit Changelog dokumentieren
Team informieren

Testing vor Live-Gang

Änderungen immer testen:

Staging-System nutzen

Teste Änderungen zuerst auf Test-/Staging-System

Alle Sprachen prüfen

Stelle sicher dass alle Sprachen korrekt sind

Frontend checken

Prüfe alle Stellen wo die Variable verwendet wird

Mobile testen

Teste auch auf mobilen Geräten

Nach Go-Live überwachen

Prüfe nach Live-Schaltung nochmal alle Stellen

Häufige Anwendungsfälle

Marketing-Texte
Kundenkommunikation
Mehrsprachigkeit
Template-Anpassungen

Saisonale Anpassungen:

custom_banner_winter_sale
→ "❄️ Winter-Sale: Bis zu 50% Rabatt!"

custom_banner_summer_sale  
→ "☀️ Sommer-Aktion: Jetzt zugreifen!"

A/B-Testing:

Teste verschiedene Button-Texte
Optimiere Call-to-Actions
Verbessere Conversion

Vorteil: Schnelles Ändern ohne Code-Deployment

Personalisierte Ansprache:

custom_greeting_registered
→ "Willkommen zurück, {0}!"

custom_greeting_guest
→ "Herzlich willkommen! Schön, dass Sie da sind."

Service-Hinweise:

custom_shipping_info
→ "Versandkostenfrei ab 50€"

custom_return_policy
→ "100 Tage Rückgaberecht"

Professionelle Übersetzungen:

DE: "In den Warenkorb legen"
EN: "Add to cart"
FR: "Ajouter au panier"
ES: "Añadir al carrito"

Lokalisierung:

DE: "Versandkosten: 4,99 €"
EN: "Shipping: £4.99"
FR: "Frais de port: 4,99 €"

Nutze professionelle Übersetzer für wichtige Texte - maschinelle Übersetzungen reichen oft nicht aus!

Custom Template Texte:

{* Im Template *}
<div class="custom-banner">
  <h2>{lang key="custom_banner_title" section="custom"}</h2>
  <p>{lang key="custom_banner_text" section="custom"}</p>
  <a href="#">{lang key="custom_banner_cta" section="custom"}</a>
</div>

Vorteil:

Texte zentral änderbar
Mehrsprachig ohne Template-Änderung
Wartungsfreundlich

Troubleshooting

Änderungen nicht sichtbar

Problem: Sprachvariablen-Änderungen erscheinen nicht im FrontendLösung:

Cache leeren

Backend → System → Cache → Cache leeren

Hard Reload

Im Browser: Strg + Shift + R (Windows) oder Cmd + Shift + R (Mac)

Template-Cache

Lösche Template-Cache im Dateisystem: /templates_c/ Ordner leeren

Browser-Cache

Leere Browser-Cache oder teste im Incognito-Modus

Variable wird nicht gefunden

Symptom: Variable zeigt Schlüssel statt Text: custom_my_variableUrsachen:

Variable wurde nicht gespeichert
Falsche Sektion angegeben
Schreibfehler im Variablen-Namen
Cache-Problem

Überprüfen:

{* Mit Fallback testen *}
{lang key="custom_my_variable" section="custom" default="Fallback Text"}

{* Wenn Fallback erscheint → Variable existiert nicht *}
{* Wenn Variablen-Name erscheint → Cache Problem *}

Import schlägt fehl

Mögliche Fehler:

Falsche Dateiformat (muss JSON sein)
Korrupte JSON-Struktur
Falsche Sprache gewählt
Datei zu groß

Debugging:

JSON-Datei in Validator prüfen: jsonlint.com
Datei in Text-Editor öffnen und Struktur prüfen
Kleinere Test-Datei versuchen
Browser-Console auf Fehler prüfen

JSON validieren:

# Mit Node.js
node -e "JSON.parse(require('fs').readFileSync('file.json', 'utf8'))"

Platzhalter funktionieren nicht

Problem: {0}, {1} werden nicht ersetztIn Smarty:

{* Falsch *}
{lang key="welcome_user" section="custom"}

{* Richtig *}
{lang key="welcome_user" section="custom" printf=$userName}

{* Mehrere Platzhalter *}
{lang key="order_confirmation" section="custom" 
      printf=$orderNumber|cat:"|":$orderDate}

In PHP:

// Falsch
$text = Shop::Lang()->get('welcome_user', 'custom');

// Richtig
$text = Shop::Lang()->get('welcome_user', 'custom');
$text = sprintf($text, $userName);

Erweiterte Tipps

Performance-Optimierung

Zu viele Variablen vermeiden:

Gruppiere ähnliche Texte
Nutze Platzhalter statt separate Variablen
Lösche ungenutzte Custom-Variablen

Cache-Strategie:

Ändere Sprachvariablen in Batches
Leere Cache nur einmal am Ende
Plane Änderungen für wartungsarme Zeiten

SEO-Optimierung

Meta-Texte als Sprachvariablen:

custom_meta_title_home
custom_meta_description_home
custom_meta_keywords_category

Vorteile:

Schnelle A/B-Tests
Einfache Mehrsprachigkeit
Zentrale Verwaltung

Aber beachte: Individuelle Produkt-/Kategorie-Texte sollten besser in den Stammdaten gepflegt werden!

Entwickler-Workflows

Versionskontrolle für Variablen:

Exportiere regelmäßig als JSON
Commite in Git-Repository
Tracke Änderungen über Git
Deploy mit CI/CD-Pipeline

Git-Workflow:

# Export
php -r "/* Export-Script */" > langvars.json

# Commit
git add langvars.json
git commit -m "Update language variables"

# Deploy
git push origin main

Erfolg! Du hast jetzt volle Kontrolle über alle Texte in deinem Shop. Nutze Sprachvariablen für professionelle, wartungsfreundliche und mehrsprachige Shop-Texte.

Weiterführende Ressourcen

Smarty Template Engine

Offizielle Smarty-Dokumentation für Template-Entwicklung

JTL-Shop Entwickler-Doku

JTL-Shop Guide für Entwickler und Template-Designer

i18n Best Practices

W3C Internationalisierung Best Practices

JSON Validator

Online Tool zum Validieren von JSON-Dateien

Quickstart

Updates & Changelog

Einstellungen

Weitere

Übersicht

Features

Zentrale Verwaltung

Import & Export

Neue Variablen anlegen

Mehrsprachig

Plugin-Sprachvariablen

Interface-Bedienung

Wichtiger Hinweis zum Cache

Shop Sprachvariablen

Funktionsweise

Best Practices für JTL-Variablen

Neue Sprachvariablen anlegen

Schritt für Schritt

Verwendung in Templates

Verwendung in PHP

Export & Import

Backup erstellen

Import durchführen

JSON-Datei-Struktur

Best Practices

Häufige Anwendungsfälle

Troubleshooting

Erweiterte Tipps

Weiterführende Ressourcen

Smarty Template Engine

JTL-Shop Entwickler-Doku

i18n Best Practices

JSON Validator

​Übersicht

​Features

Zentrale Verwaltung

Import & Export

Neue Variablen anlegen

Mehrsprachig

​Plugin-Sprachvariablen

​Interface-Bedienung

​Wichtiger Hinweis zum Cache

​Shop Sprachvariablen

​Funktionsweise

​Best Practices für JTL-Variablen

​Neue Sprachvariablen anlegen

​Schritt für Schritt

​Verwendung in Templates

​Verwendung in PHP

​Export & Import

​Backup erstellen

​Import durchführen

​JSON-Datei-Struktur

​Best Practices

​Häufige Anwendungsfälle

​Troubleshooting

​Erweiterte Tipps

​Weiterführende Ressourcen

Smarty Template Engine

JTL-Shop Entwickler-Doku

i18n Best Practices

JSON Validator

Übersicht

Features

Plugin-Sprachvariablen

Interface-Bedienung

Wichtiger Hinweis zum Cache

Shop Sprachvariablen

Funktionsweise

Best Practices für JTL-Variablen

Neue Sprachvariablen anlegen

Schritt für Schritt

Verwendung in Templates

Verwendung in PHP

Export & Import

Backup erstellen

Import durchführen

JSON-Datei-Struktur

Best Practices

Häufige Anwendungsfälle

Troubleshooting

Erweiterte Tipps

Weiterführende Ressourcen