Zum Inhalt springen

Funktionen

Theme

Gestalten Sie das Aussehen Ihres Blogs mit Liquid-Vorlagen.

Der Theme-Editor des Blogs mit den Theme-Dateien, dem Code und einer Live-Vorschau

Theme-Dateien

Jedes Theme besteht aus 8 Dateien:

DateiZweck
home.liquidVorlage der Startseite
category.liquidÜbersichtsseite einer Kategorie
post.liquidSeite eines einzelnen Beitrags
header.liquidGemeinsamer Header als Partial
footer.liquidGemeinsamer Footer als Partial
shared.liquidWiederverwendbare Komponenten
styles.cssEigenes CSS
scripts.jsEigenes 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

FilterBeschreibungBeispiel
dateDatum formatieren{{ post.published_at | date: "%B %d, %Y" }}
truncateLänge einer Zeichenkette begrenzen{{ post.excerpt | truncate: 150 }}
truncatewordsAnzahl der Wörter begrenzen{{ post.excerpt | truncatewords: 25 }}
upcase / downcaseGroß- und Kleinschreibung ändern{{ category.name | upcase }}
capitalizeErsten Buchstaben großschreiben{{ author.name | capitalize }}
strip_htmlHTML-Tags entfernen{{ post.content | strip_html }}
escapeHTML-Entitäten maskieren{{ post.title | escape }}
url_encodeFür URLs kodieren{{ post.title | url_encode }}
defaultErsatzwert{{ post.featured_image_url | default: "/images/placeholder.jpg" }}
sizeLänge eines Arrays oder einer Zeichenkette{{ posts | size }}
first / lastErstes oder letztes Element{{ categories | first }}
sortArray sortieren{{ posts | sort: "published_at" }}
reverseArray umkehren{{ posts | reverse }}
whereArray filtern{{ posts | where: "category_id", "news" }}
mapEigenschaft auslesen{{ posts | map: "title" }}
joinArray-Elemente verbinden{{ post.tags | join: ", " }}
splitZeichenkette aufteilen{{ "a,b,c" | split: "," }}
replaceText ersetzen{{ post.title | replace: "-", " " }}
append / prependAn Zeichenkette anhängen oder voranstellen{{ post.slug | prepend: "/" }}
plus / minusRechenoperationen{{ pagination.current_page | plus: 1 }}
times / divided_byRechenoperationen{{ 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:

Versionen eines Blog-Themes: ein Entwurf v2, aus dem Standard-Theme erstellt, und v1 live
  • 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.