File del tema
Ogni tema è composto da 8 file:
| File | Scopo |
|---|---|
home.liquid | Template della home page |
category.liquid | Pagina con l’elenco di una categoria |
post.liquid | Pagina del singolo articolo |
header.liquid | Partial condiviso dell’intestazione |
footer.liquid | Partial condiviso del piè di pagina |
shared.liquid | Componenti riutilizzabili |
styles.css | CSS personalizzato |
scripts.js | JavaScript personalizzato |
Template Liquid
I temi usano la sintassi dei template Liquid:
<h1>{{ workspace.blog_title }}</h1>
{% for post in posts %}
<article>
<h2>{{ post.title }}</h2>
<p>{{ post.excerpt }}</p>
</article>
{% endfor %}
Variabili disponibili
Globali (tutte le pagine)
{{ workspace.id }}
{{ workspace.name }}
{{ workspace.blog_title }}
{{ workspace.logo_url }}
{{ workspace.icon_url }}
{{ base_url }}
{{ current_year }}
{{ theme.version }}
Categorie
{% for category in categories %}
{{ category.id }}
{{ category.slug }}
{{ category.name }}
{{ category.description }}
{% endfor %}
Articoli (home page e pagine di categoria)
{% 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 %}
Singolo articolo (pagina dell’articolo)
{{ 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 }}
Paginazione
{{ pagination.current_page }}
{{ pagination.total_pages }}
{{ pagination.has_next }}
{{ pagination.has_previous }}
{{ pagination.total_count }}
{{ pagination.per_page }}
Liste della newsletter
{% for list in public_lists %}
{{ list.id }}
{{ list.name }}
{{ list.description }}
{% endfor %}
Filtri utili
| Filtro | Descrizione | Esempio |
|---|---|---|
date | Formatta le date | {{ post.published_at | date: "%B %d, %Y" }} |
truncate | Limita la lunghezza della stringa | {{ post.excerpt | truncate: 150 }} |
truncatewords | Limita il numero di parole | {{ post.excerpt | truncatewords: 25 }} |
upcase / downcase | Cambia maiuscole e minuscole | {{ category.name | upcase }} |
capitalize | Mette in maiuscolo la prima lettera | {{ author.name | capitalize }} |
strip_html | Rimuove i tag HTML | {{ post.content | strip_html }} |
escape | Esegue l’escape delle entità HTML | {{ post.title | escape }} |
url_encode | Codifica per gli URL | {{ post.title | url_encode }} |
default | Valore di riserva | {{ post.featured_image_url | default: "/images/placeholder.jpg" }} |
size | Lunghezza di un array o di una stringa | {{ posts | size }} |
first / last | Restituisce il primo o l’ultimo elemento | {{ categories | first }} |
sort | Ordina un array | {{ posts | sort: "published_at" }} |
reverse | Inverte un array | {{ posts | reverse }} |
where | Filtra un array | {{ posts | where: "category_id", "news" }} |
map | Estrae una proprietà | {{ posts | map: "title" }} |
join | Unisce gli elementi di un array | {{ post.tags | join: ", " }} |
split | Divide una stringa | {{ "a,b,c" | split: "," }} |
replace | Sostituisce del testo | {{ post.title | replace: "-", " " }} |
append / prepend | Aggiunge testo a una stringa | {{ post.slug | prepend: "/" }} |
plus / minus | Operazioni matematiche | {{ pagination.current_page | plus: 1 }} |
times / divided_by | Operazioni matematiche | {{ post.reading_time_minutes | times: 60 }} |
Partial
Include (condivide lo scope del genitore)
{% include 'header' %}
{% include 'footer' %}
Render (scope isolato)
{% render 'shared', widget: 'newsletter' %}
{% render 'shared', widget: 'categories' %}
Il nome del template va scritto tra virgolette: come in Shopify Liquid 5.11, {% render variable %} e {% snippet %} non sono supportati. Liquid nei temi si comporta come nei template email, con le stesse differenze rispetto a Shopify Liquid.
Versioni del tema
I temi hanno delle versioni:
- Si può pubblicare una sola versione alla volta
- Una versione pubblicata non cambia mai: se salvi delle modifiche, si crea una nuova versione in bozza
- Salvare una bozza aggiorna quella bozza
- Le versioni non pubblicate sono bozze
Modalità anteprima
Puoi vedere in anteprima i temi non pubblicati aggiungendo ?preview_theme_version=X a qualsiasi URL del blog:
https://blog.example.com/?preview_theme_version=5
https://blog.example.com/category/slug?preview_theme_version=5
L’anteprima ignora la cache e richiede l’autenticazione.
