Aller au contenu

Fonctionnalités

Thème

Personnalisez l'apparence de votre blog avec des modèles Liquid.

L'éditeur de thème du blog, avec les fichiers du thème, le code et un aperçu en direct

Fichiers du thème

Chaque thème se compose de 8 fichiers :

FichierRôle
home.liquidModèle de la page d’accueil
category.liquidPage de liste d’une catégorie
post.liquidPage d’un article
header.liquidPartiel d’en-tête partagé
footer.liquidPartiel de pied de page partagé
shared.liquidComposants réutilisables
styles.cssCSS personnalisé
scripts.jsJavaScript personnalisé

Gabarits Liquid

Les thèmes utilisent la syntaxe de Liquid :

<h1>{{ workspace.blog_title }}</h1>

{% for post in posts %}
  <article>
    <h2>{{ post.title }}</h2>
    <p>{{ post.excerpt }}</p>
  </article>
{% endfor %}

Variables disponibles

Globales (toutes les pages)

{{ workspace.id }}
{{ workspace.name }}
{{ workspace.blog_title }}
{{ workspace.logo_url }}
{{ workspace.icon_url }}
{{ base_url }}
{{ current_year }}
{{ theme.version }}

Catégories

{% for category in categories %}
  {{ category.id }}
  {{ category.slug }}
  {{ category.name }}
  {{ category.description }}
{% endfor %}

Articles (page d’accueil et pages de catégorie)

{% 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 %}

Article seul (page d’article)

{{ 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 }}

Pagination

{{ pagination.current_page }}
{{ pagination.total_pages }}
{{ pagination.has_next }}
{{ pagination.has_previous }}
{{ pagination.total_count }}
{{ pagination.per_page }}

Listes de newsletter

{% for list in public_lists %}
  {{ list.id }}
  {{ list.name }}
  {{ list.description }}
{% endfor %}

Filtres utiles

FiltreDescriptionExemple
dateFormater une date{{ post.published_at | date: "%B %d, %Y" }}
truncateLimiter la longueur d’une chaîne{{ post.excerpt | truncate: 150 }}
truncatewordsLimiter le nombre de mots{{ post.excerpt | truncatewords: 25 }}
upcase / downcaseChanger la casse{{ category.name | upcase }}
capitalizeMettre la première lettre en majuscule{{ author.name | capitalize }}
strip_htmlRetirer les balises HTML{{ post.content | strip_html }}
escapeÉchapper les entités HTML{{ post.title | escape }}
url_encodeEncoder pour une URL{{ post.title | url_encode }}
defaultValeur de repli{{ post.featured_image_url | default: "/images/placeholder.jpg" }}
sizeLongueur d’un tableau ou d’une chaîne{{ posts | size }}
first / lastPremier ou dernier élément{{ categories | first }}
sortTrier un tableau{{ posts | sort: "published_at" }}
reverseInverser un tableau{{ posts | reverse }}
whereFiltrer un tableau{{ posts | where: "category_id", "news" }}
mapExtraire une propriété{{ posts | map: "title" }}
joinJoindre les éléments d’un tableau{{ post.tags | join: ", " }}
splitDécouper une chaîne{{ "a,b,c" | split: "," }}
replaceRemplacer du texte{{ post.title | replace: "-", " " }}
append / prependAjouter à une chaîne{{ post.slug | prepend: "/" }}
plus / minusOpérations mathématiques{{ pagination.current_page | plus: 1 }}
times / divided_byOpérations mathématiques{{ post.reading_time_minutes | times: 60 }}

Partiels

Include (partage la portée du parent)

{% include 'header' %}
{% include 'footer' %}

Render (portée isolée)

{% render 'shared', widget: 'newsletter' %}
{% render 'shared', widget: 'categories' %}

Le nom du modèle doit être entre guillemets : comme dans Shopify Liquid 5.11, {% render variable %} et {% snippet %} ne sont pas pris en charge. Liquid se comporte dans les thèmes comme dans les modèles d’email, avec les mêmes différences avec Shopify Liquid.

Versions du thème

Les thèmes sont versionnés :

Versions du thème du blog : un brouillon v2 créé à partir du thème par défaut, et la v1 en ligne
  • Une seule version peut être publiée à la fois
  • Une version publiée ne change jamais : enregistrer vos modifications sur elle crée une nouvelle version brouillon
  • Enregistrer un brouillon met à jour ce brouillon
  • Les versions non publiées sont des brouillons

Mode aperçu

Prévisualisez un thème non publié en ajoutant ?preview_theme_version=X à n’importe quelle URL du blog :

https://blog.example.com/?preview_theme_version=5
https://blog.example.com/category/slug?preview_theme_version=5

L’aperçu contourne le cache et exige d’être connecté.