Keys & Werte
Eine Variable besteht aus zwei Teilen:
- Einem Key — die eindeutige Kennung, die Sie aus Inhalten referenzieren (
{promotionText}). - Einem oder mehreren Werten — der eigentliche Inhalt, zu dem der Key aufgelöst wird.
Werte sind nicht ein einzelnes Feld. Jede Variable hat eine Liste von Wertzeilen, jede Zeile auf einen Verkaufskanal beschränkt (oder „global”, wenn kein Kanal gesetzt ist) und pro Sprache übersetzbar. Das Plugin wählt zur Render-Zeit die richtige Zeile anhand des Storefront-Kontexts.
| Eigenschaft | Regel |
|---|---|
| Format | Buchstaben, Ziffern, Unterstriche — Beginn mit einem Buchstaben. camelCase empfohlen. |
| Groß-/Kleinschreibung | Ja — {promoText} und {promotext} sind zwei verschiedene Platzhalter. |
| Reservierte Keys | Integrierte (shopName, shopEmail, shopAddress, shopBankAccount) können nicht als eigene Keys überschrieben werden. |
| Eindeutigkeit | Ein Key muss über alle benutzerdefinierten Variablen hinweg eindeutig sein. |
Gute Keys: promotionText, footerDisclaimer, legalShipping, usp1, usp2.
Zu vermeiden: text, value, info (zu generisch), oder Keys mit Leer- bzw. Bindestrichen (werden nicht erkannt).
Platzhalter-Syntax
Abschnitt betitelt „Platzhalter-Syntax“Tippen Sie den Key in geschweiften Klammern:
Erhalten Sie {promotionText} bei allen Bestellungen über {minOrderValue} EUR.Das Plugin gleicht alles zwischen { und } mit Ihrer Variablenliste ab. Unbekannte Keys bleiben unverändert — Tippfehler werden also wörtlich im Storefront gerendert, prüfen Sie also die Editor-Vorschau, bevor Sie veröffentlichen.
Leerzeichen innerhalb der Klammern sind nicht erlaubt: { promotionText } matcht nicht. Bleiben Sie bei {promotionText}.
Jede Wertzeile hat folgende Felder:
| Feld | Übersetzbar | Zweck |
|---|---|---|
| Verkaufskanal | — | Der Kanal, für den diese Zeile gilt. Leer = global / Standard für alle Kanäle. |
| Wert | ja | Der Ersetzungs-Inhalt. Unterstützt Rich-Text / HTML. |
| CSS | ja | Optionales CSS, das nur auf Seiten injiziert wird, die die Variable verwenden. |
| Skript | ja | Optionales JavaScript, das nur auf Seiten injiziert wird, die die Variable verwenden. |
Sie fügen eine Wertzeile mit Wert hinzufügen auf der Variablen-Detailseite hinzu. Fügen Sie so viele Zeilen hinzu, wie Sie brauchen:
- Eine globale Zeile (ohne Kanal) reicht für einfache Fälle.
- Fügen Sie darüber hinaus kanalspezifische Zeilen hinzu, um den globalen Wert pro Verkaufskanal zu überschreiben.
Aktiv-Schalter
Abschnitt betitelt „Aktiv-Schalter“Jede Variable hat einen Aktiv-Schalter. Wenn er aus ist, bleibt der Platzhalter unverändert — nützlich, um Inhalte vorzubereiten oder eine Kampagne vorübergehend zu deaktivieren, ohne die Variable zu löschen.