Dynamische Variablen | Mehrsprachige & Multi-Channel Inhaltsplatzhalter für CMS

Installation

1. Laden Sie das Plugin über den Plugin Manager hoch oder installieren Sie es via Composer
2. Aktivieren Sie das Plugin im Plugin Manager
3. Leeren Sie den Cache

Plugin-Einstellungen

Navigieren Sie zu Einstellungen → Plugins → Dynamische Variablen um folgendes zu konfigurieren:

• CMS-Seiten aktivieren (Standard: an) — Variablen in CMS-Seiteninhalten ersetzen
• CMS-Vorschau aktivieren (Standard: an) — Live-Variablenvorschau im CMS-Texteditor anzeigen
• Produkte aktivieren (Standard: aus) — Variablen in Produktnamen, Beschreibungen und Meta-Feldern ersetzen
• Kategorien aktivieren (Standard: aus) — Variablen in Kategorienamen, Beschreibungen, Meta-Feldern und Breadcrumbs ersetzen

Variable erstellen

1. Gehen Sie zu Einstellungen → Inhalte → Dynamische Variablen in der Admin-Seitenleiste
2. Klicken Sie auf Variable hinzufügen
3. Füllen Sie die Pflichtfelder aus:
   • Schlüssel — Eindeutiger Bezeichner als Platzhalter, z.B. promotionText (verwendet als {promotionText} im Inhalt)
   • Aktiv — Variable aktivieren oder deaktivieren
4. Optional Geltungsbereiche festlegen:
   • Leer lassen, damit die Variable überall funktioniert
   • CMS-Seite, Produkt und/oder Kategorie auswählen, um einzuschränken, wo die Variable ersetzt wird
5. Werte hinzufügen:
   • Klicken Sie auf Wert hinzufügen um einen neuen Werteintrag zu erstellen
   • Verkaufskanal — Leer lassen für einen globalen Wert oder einen bestimmten Kanal auswählen
   • Wert — Der Ersetzungsinhalt (unterstützt Rich Text / HTML, übersetzbar pro Sprache)
   • CSS — Optionales benutzerdefiniertes CSS, das injiziert wird wenn diese Variable verwendet wird (übersetzbar)
   • Script — Optionales JavaScript, das injiziert wird wenn diese Variable verwendet wird (übersetzbar)
6. Variable speichern

Variablen in Inhalten verwenden

Methode 1: Variablen-Picker (Empfohlen)

1. Öffnen Sie einen CMS-Texteditor (z.B. Textblock, HTML-Block)
2. Klicken Sie auf den Dynamische Variablen-Button in der Editor-Toolbar
3. Durchsuchen Sie die verfügbaren Variablen
4. Klicken Sie auf eine Variable, um sie an der Cursorposition einzufügen

Methode 2: Manuelle Eingabe

Geben Sie einfach den Variablenschlüssel in geschweiften Klammern ein: {variableName}

In Produkten und Kategorien

Verwenden Sie die gleiche {variableName}-Syntax direkt in Produkt- oder Kategoriefeldern (Name, Beschreibung, Meta-Felder). Stellen Sie sicher, dass der entsprechende Geltungsbereich in den Plugin-Einstellungen und bei der Variable selbst aktiviert ist.

Integrierte Variablen

Diese Variablen sind sofort ohne Konfiguration verfügbar:

• {shopName} — Shopname aus Einstellungen → Stammdaten
• {shopEmail} — Shop-E-Mail aus Einstellungen → Stammdaten
• {shopAddress} — Shopadresse aus Einstellungen → Stammdaten
• {shopBankAccount} — Bankverbindung aus Einstellungen → Stammdaten

Multi-Channel-Einrichtung

Um unterschiedliche Inhalte pro Verkaufskanal anzuzeigen:

1. Fügen Sie einen Wert ohne ausgewählten Verkaufskanal hinzu — dies ist der globale Fallback
2. Fügen Sie zusätzliche Werte mit bestimmten Verkaufskanälen hinzu
3. Das Plugin verwendet den kanalspezifischen Wert wenn verfügbar, andernfalls den globalen Wert

Mehrsprachige Einrichtung

Variablenwerte sind übersetzbar. Wechseln Sie die Sprache im Admin-Bereich und geben Sie unterschiedliche Inhalte für jede Sprache ein. Das Plugin zeigt automatisch den Wert an, der zur aktuellen Storefront-Sprache passt.

Verschachtelte Variablen

Variablen können andere Variablen in ihren Werten referenzieren. Zum Beispiel: Wenn Sie eine Variable {companyInfo} mit dem Wert {shopName} - {shopAddress} haben, werden beide inneren Variablen aufgelöst. Verschachtelung funktioniert eine Ebene tief, um Zirkelbezüge zu vermeiden.

Tipps

• Nutzen Sie die Live-Vorschau im CMS-Editor, um die Variablenersetzung vor der Veröffentlichung zu überprüfen
• Beginnen Sie mit den integrierten Variablen, um die Funktion zu testen, bevor Sie eigene erstellen
• Halten Sie Variablenschlüssel kurz und aussagekräftig (z.B. promoText, footerDisclaimer)
• Verwenden Sie Geltungsbereiche, um Variablen auf relevante Inhaltstypen zu beschränken und die Performance zu verbessern
• Hängen Sie CSS/JS nur bei Bedarf an — sie werden nur auf Seiten injiziert, auf denen die Variable tatsächlich verwendet wird