Fichiers du thème
Chaque thème se compose de 8 fichiers :
| Fichier | Rôle |
|---|---|
home.liquid | Modèle de la page d’accueil |
category.liquid | Page de liste d’une catégorie |
post.liquid | Page d’un article |
header.liquid | Partiel d’en-tête partagé |
footer.liquid | Partiel de pied de page partagé |
shared.liquid | Composants réutilisables |
styles.css | CSS personnalisé |
scripts.js | JavaScript 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
| Filtre | Description | Exemple |
|---|---|---|
date | Formater une date | {{ post.published_at | date: "%B %d, %Y" }} |
truncate | Limiter la longueur d’une chaîne | {{ post.excerpt | truncate: 150 }} |
truncatewords | Limiter le nombre de mots | {{ post.excerpt | truncatewords: 25 }} |
upcase / downcase | Changer la casse | {{ category.name | upcase }} |
capitalize | Mettre la première lettre en majuscule | {{ author.name | capitalize }} |
strip_html | Retirer les balises HTML | {{ post.content | strip_html }} |
escape | Échapper les entités HTML | {{ post.title | escape }} |
url_encode | Encoder pour une URL | {{ post.title | url_encode }} |
default | Valeur de repli | {{ post.featured_image_url | default: "/images/placeholder.jpg" }} |
size | Longueur d’un tableau ou d’une chaîne | {{ posts | size }} |
first / last | Premier ou dernier élément | {{ categories | first }} |
sort | Trier un tableau | {{ posts | sort: "published_at" }} |
reverse | Inverser un tableau | {{ posts | reverse }} |
where | Filtrer un tableau | {{ posts | where: "category_id", "news" }} |
map | Extraire une propriété | {{ posts | map: "title" }} |
join | Joindre les éléments d’un tableau | {{ post.tags | join: ", " }} |
split | Découper une chaîne | {{ "a,b,c" | split: "," }} |
replace | Remplacer du texte | {{ post.title | replace: "-", " " }} |
append / prepend | Ajouter à une chaîne | {{ post.slug | prepend: "/" }} |
plus / minus | Opérations mathématiques | {{ pagination.current_page | plus: 1 }} |
times / divided_by | Opé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 :
- 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é.
