Theme-Entwicklung
Die Liquid-Vorlagensprache, Abschnitte, Einstellungen und Objekte — für Agenturen und Entwickler.
Referenz
Alle 91 Variablen eines Themes
restaurant, settings, section und die übrigen — mit Typ, Beschreibung und der Angabe, wo sie verfügbar sind. Gegen den Code abgeglichen, nicht von Hand gepflegt.
Liquid
Wie ein Theme aufgebaut ist
Die Verzeichnisse eines Themes, die vier Pflichtdateien und was passiert, wenn eine davon fehlt.
Für EntwicklerDie Liquid-Umgebung: wie streng sie ist
Unbekannte Variablen und Filter sind still, unbekannte Tags brechen ab — und ausgegeben wird ohne Maskierung.
Für EntwicklerLiquid von vorn: Ausgabe, Bedingungen, Schleifen, Zuweisungen
Die vier Bausteine, aus denen jede Vorlage besteht — und die Stellen, an denen diese Engine sich anders verhält als das Liquid anderer Anbieter.
Für EntwicklerDie eigenen Liquid-Filter
Sieben Filter kommen von TacticTable dazu — alle übrigen sind die von LiquidJS.
Für EntwicklerWelche Liquid-Tags es gibt — und welche abbrechen
Genau ein eigenes Tag, dazu die von LiquidJS. Fünf Tags aus anderen Liquid-Welten brechen hier die Seite ab.
Für EntwicklerTexte übersetzen: Sprachdateien und der t-Filter
Wie die Sprachdateien aufgebaut sind, wie sie ausgewählt werden — und warum derzeit immer die Standardsprache gewinnt.
Für EntwicklerTheme-Dateien schreiben: Ablage, Zweige und Grenzen
Wo die Dateien liegen, wie das Live-Theme davon getrennt bleibt und welche Grenzen beim Speichern gelten.
Für EntwicklerTipps und Kniffe aus der Praxis
Die Handgriffe, die ein Theme robust machen: Standardwerte, sicheres Verketten, leere Listen, Bilder, Adressen und Beträge.
Für EntwicklerHäufige Fehler und woran man sie erkennt
Was passiert bei einem unbekannten Abschnitt, bei einer fehlenden Einstellung, bei einer Schleife über nichts — und welche Fehler die Seite wirklich abbrechen.
Für Entwickler
Abschnitte
Das Layout: layout/theme.liquid
Die Hülle um jede Seite — mit content_for_layout und den fest eingebauten Abschnitten.
Für EntwicklerEinen eigenen Abschnitt bauen
Zwei Dateien genügen: die Vorlage und ihr Schema — danach steht der Abschnitt im Theme-Editor zur Auswahl.
Für EntwicklerDas Schema eines Abschnitts
Aufbau der schema.json, die Felder eines Einstellungseintrags und die Falle mit den Vorgabewerten.
Für EntwicklerBlöcke innerhalb eines Abschnitts
Wiederholbare Einheiten — einzelne Gerichte, Bilder, Stimmen — samt der drei Kurzformen, die TacticTable dazulegt.
Für EntwicklerSeitenvorlagen: templates/*.json
Welche Abschnitte auf welcher Seite stehen, in welcher Reihenfolge — und wie man Liquid in einen Einstellungswert schreibt.
Für EntwicklerTeilstücke: render und include
Wiederverwendbares Markup aus snippets/ — und der eine Unterschied zwischen render und include, an dem die meisten Übersetzungen scheitern.
Für Entwickler
Objekte
Alle Objekte, die eine Vorlage bekommt
Die vollständige Liste — was nicht darin steht, ist im Template leer, ohne Fehlermeldung.
Für EntwicklerDie Objekte restaurant, brand, widget und analytics
Stammdaten, Markenwerte, Buchungs-Widget und Reichweitenmessung — Feld für Feld.
Für EntwicklerSpeisekarte, Navigation und Öffnungszeiten im Template
Die vier Inhaltsobjekte, die aus der Verwaltung kommen — jeweils als Liste und als Nachschlagewerk.
Für EntwicklerDas Objekt section und seine zwei Gesichter
Was innerhalb eines Abschnitts zur Verfügung steht — und der eine Unterschied zwischen Rumpf und Layout.
Für Entwickler
Einstellungen
Theme-Einstellungen: Schema, Werte und ihre Rangfolge
Wie aus Schema, gespeicherten Werten und dem Branding des Betriebs das Objekt settings entsteht.
Für EntwicklerWelche Einstellungstypen es gibt
Zwölf Typen, die der Editor darstellt — alles andere erscheint stillschweigend gar nicht.
Für EntwicklerDie Schlüssel mit Sonderrolle
Acht Kennungen binden ein Theme an das Branding des Betriebs, zwölf erscheinen sofort in der Vorschau — wer sie anders benennt, verliert beides.
Für Entwickler