Theme-Dateien
Jedes Theme besteht aus 8 Dateien:
| Datei | Zweck |
|---|---|
home.liquid | Vorlage der Startseite |
category.liquid | Übersichtsseite einer Kategorie |
post.liquid | Seite eines einzelnen Beitrags |
header.liquid | Gemeinsamer Header als Partial |
footer.liquid | Gemeinsamer Footer als Partial |
shared.liquid | Wiederverwendbare Komponenten |
styles.css | Eigenes CSS |
scripts.js | Eigenes JavaScript |
Vorlagen mit Liquid
Themes verwenden die Vorlagensyntax von Liquid:
<h1>{{ workspace.blog_title }}</h1>
{% for post in posts %}
<article>
<h2>{{ post.title }}</h2>
<p>{{ post.excerpt }}</p>
</article>
{% endfor %}
Verfügbare Variablen
Global (alle Seiten)
{{ workspace.id }}
{{ workspace.name }}
{{ workspace.blog_title }}
{{ workspace.logo_url }}
{{ workspace.icon_url }}
{{ base_url }}
{{ current_year }}
{{ theme.version }}
Kategorien
{% for category in categories %}
{{ category.id }}
{{ category.slug }}
{{ category.name }}
{{ category.description }}
{% endfor %}
Beiträge (Startseite und Kategorieseiten)
{% for post in posts %}
{{ post.id }}
{{ post.slug }}
{{ post.category_slug }}
{{ post.title }}
{{ post.excerpt }}
{{ post.featured_image_url }}
{{ post.published_at }}
{{ post.reading_time_minutes }}
{% for author in post.authors %}
{{ author.name }}
{{ author.avatar_url }}
{% endfor %}
{% endfor %}
Einzelner Beitrag (Beitragsseite)
{{ post.title }}
{{ post.content }}
{{ post.excerpt }}
{{ post.featured_image_url }}
{{ post.published_at }}
{{ post.reading_time_minutes }}
{% for toc in post.table_of_contents %}
{{ toc.id }}
{{ toc.level }}
{{ toc.text }}
{% endfor %}
{{ category.name }}
{{ category.slug }}
Seitennummerierung
{{ pagination.current_page }}
{{ pagination.total_pages }}
{{ pagination.has_next }}
{{ pagination.has_previous }}
{{ pagination.total_count }}
{{ pagination.per_page }}
Newsletter-Listen
{% for list in public_lists %}
{{ list.id }}
{{ list.name }}
{{ list.description }}
{% endfor %}
Nützliche Filter
| Filter | Beschreibung | Beispiel |
|---|---|---|
date | Datum formatieren | {{ post.published_at | date: "%B %d, %Y" }} |
truncate | Länge einer Zeichenkette begrenzen | {{ post.excerpt | truncate: 150 }} |
truncatewords | Anzahl der Wörter begrenzen | {{ post.excerpt | truncatewords: 25 }} |
upcase / downcase | Groß- und Kleinschreibung ändern | {{ category.name | upcase }} |
capitalize | Ersten Buchstaben großschreiben | {{ author.name | capitalize }} |
strip_html | HTML-Tags entfernen | {{ post.content | strip_html }} |
escape | HTML-Entitäten maskieren | {{ post.title | escape }} |
url_encode | Für URLs kodieren | {{ post.title | url_encode }} |
default | Ersatzwert | {{ post.featured_image_url | default: "/images/placeholder.jpg" }} |
size | Länge eines Arrays oder einer Zeichenkette | {{ posts | size }} |
first / last | Erstes oder letztes Element | {{ categories | first }} |
sort | Array sortieren | {{ posts | sort: "published_at" }} |
reverse | Array umkehren | {{ posts | reverse }} |
where | Array filtern | {{ posts | where: "category_id", "news" }} |
map | Eigenschaft auslesen | {{ posts | map: "title" }} |
join | Array-Elemente verbinden | {{ post.tags | join: ", " }} |
split | Zeichenkette aufteilen | {{ "a,b,c" | split: "," }} |
replace | Text ersetzen | {{ post.title | replace: "-", " " }} |
append / prepend | An Zeichenkette anhängen oder voranstellen | {{ post.slug | prepend: "/" }} |
plus / minus | Rechenoperationen | {{ pagination.current_page | plus: 1 }} |
times / divided_by | Rechenoperationen | {{ post.reading_time_minutes | times: 60 }} |
Partials
Include (teilt den Gültigkeitsbereich der übergeordneten Vorlage)
{% include 'header' %}
{% include 'footer' %}
Render (isolierter Gültigkeitsbereich)
{% render 'shared', widget: 'newsletter' %}
{% render 'shared', widget: 'categories' %}
Der Name der Vorlage muss in Anführungszeichen stehen: Wie in Shopify Liquid 5.11 werden {% render variable %} und {% snippet %} nicht unterstützt. Liquid verhält sich in Themes wie in E-Mail-Vorlagen, mit denselben Unterschieden zu Shopify Liquid.
Theme-Versionen
Themes sind versioniert:
- Es kann immer nur eine Version veröffentlicht sein
- Eine veröffentlichte Version ändert sich nie: Wenn Sie Ihre Änderungen daran speichern, entsteht eine neue Entwurfsversion
- Das Speichern eines Entwurfs aktualisiert diesen Entwurf
- Nicht veröffentlichte Versionen sind Entwürfe
Vorschaumodus
Eine Vorschau nicht veröffentlichter Themes erhalten Sie, wenn Sie ?preview_theme_version=X an eine beliebige Blog-URL anhängen:
https://blog.example.com/?preview_theme_version=5
https://blog.example.com/category/slug?preview_theme_version=5
Die Vorschau umgeht den Cache und erfordert eine Anmeldung.
