Vai al contenuto

Funzionalità

Tema

Personalizza l'aspetto del tuo blog con i template Liquid.

L'editor del tema del blog, con i file del tema, il codice e un'anteprima dal vivo

File del tema

Ogni tema è composto da 8 file:

FileScopo
home.liquidTemplate della home page
category.liquidPagina con l’elenco di una categoria
post.liquidPagina del singolo articolo
header.liquidPartial condiviso dell’intestazione
footer.liquidPartial condiviso del piè di pagina
shared.liquidComponenti riutilizzabili
styles.cssCSS personalizzato
scripts.jsJavaScript 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

FiltroDescrizioneEsempio
dateFormatta le date{{ post.published_at | date: "%B %d, %Y" }}
truncateLimita la lunghezza della stringa{{ post.excerpt | truncate: 150 }}
truncatewordsLimita il numero di parole{{ post.excerpt | truncatewords: 25 }}
upcase / downcaseCambia maiuscole e minuscole{{ category.name | upcase }}
capitalizeMette in maiuscolo la prima lettera{{ author.name | capitalize }}
strip_htmlRimuove i tag HTML{{ post.content | strip_html }}
escapeEsegue l’escape delle entità HTML{{ post.title | escape }}
url_encodeCodifica per gli URL{{ post.title | url_encode }}
defaultValore di riserva{{ post.featured_image_url | default: "/images/placeholder.jpg" }}
sizeLunghezza di un array o di una stringa{{ posts | size }}
first / lastRestituisce il primo o l’ultimo elemento{{ categories | first }}
sortOrdina un array{{ posts | sort: "published_at" }}
reverseInverte un array{{ posts | reverse }}
whereFiltra un array{{ posts | where: "category_id", "news" }}
mapEstrae una proprietà{{ posts | map: "title" }}
joinUnisce gli elementi di un array{{ post.tags | join: ", " }}
splitDivide una stringa{{ "a,b,c" | split: "," }}
replaceSostituisce del testo{{ post.title | replace: "-", " " }}
append / prependAggiunge testo a una stringa{{ post.slug | prepend: "/" }}
plus / minusOperazioni matematiche{{ pagination.current_page | plus: 1 }}
times / divided_byOperazioni 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:

Versioni del tema del blog: una bozza v2 creata dal tema predefinito, e la v1 online
  • 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.