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.
Beispiel
Abschnitt betitelt „Beispiel“Definieren Sie zwei Variablen:
| Key | Wert |
|---|---|
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
Wie tief geht die Verschachtelung
Abschnitt betitelt „Wie tief geht die Verschachtelung“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.
Muster, die gut funktionieren
Abschnitt betitelt „Muster, die gut funktionieren“- Footer-Komposition —
{footerSignature}={shopName} • {shopEmail} • {shopAddress} - Rechtliche Blöcke —
{legalFooter}=© {shopName} {currentYear}(currentYearjährlich manuell aktualisieren oder über einen eigenen Job) - Wiederverwendbare Hinweise —
{shippingDisclaimer}=Versand erfolgt durch {fulfillmentPartnerName}
Was zu vermeiden ist
Abschnitt betitelt „Was zu vermeiden ist“- 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.