Zum Inhalt springen

Verschachtelte Variablen

Sie können {andereVariable} in den Wert einer Variable schreiben. Wenn das Plugin die äußere Variable auflöst, löst es auch alle inneren Referenzen darin auf.

Definieren Sie zwei Variablen:

KeyWert
shopName(integriert: z. B. Acme Store)
shopAddress(integriert: z. B. Street 1, 00-001 NY)
companyInfo{shopName} — {shopAddress}

Wenn Sie nun {companyInfo} auf einer CMS-Seite verwenden, rendert es:

Acme Store — Street 1, 00-001 NY

Eine Ebene. Beim Ersetzen von {companyInfo} löst das Plugin die {shopName}- und {shopAddress}-Referenzen darin auf. Falls diese Werte selbst weitere {...}-Referenzen enthielten, würden diese nicht aufgelöst — sie würden als wörtlicher Text gerendert.

Die Einebenen-Grenze ist beabsichtigt — sie verhindert zirkuläre Referenzen und unkontrolliertes Aufblähen. Wenn Sie tiefere Komposition brauchen, gestalten Sie Ihre Variablen so um, dass jede Ebene explizit ist.

  • Footer-Komposition{footerSignature} = {shopName} • {shopEmail} • {shopAddress}
  • Rechtliche Blöcke{legalFooter} = © {shopName} {currentYear} (currentYear jährlich manuell aktualisieren oder über einen eigenen Job)
  • Wiederverwendbare Hinweise{shippingDisclaimer} = Versand erfolgt durch {fulfillmentPartnerName}
  • Selbst-Referenz. Wenn promotionText {promotionText} enthält, wird der wörtliche Platzhalter gerendert — die innere Referenz wird kein zweites Mal aufgelöst, aber es kann Redakteure verwirren. Nicht machen.
  • Kanalübergreifende Überraschungen. Ein verschachtelter Key wird im Kanalkontext der äußeren Variable aufgelöst. Wenn {companyInfo} global konfiguriert ist und {shopName} kanalspezifische Überschreibungen hat, wird trotzdem der kanalspezifische Name verwendet — denn der Kanal kommt aus dem Storefront-Request, nicht aus der äußeren Variable.