Pular para o conteúdo

Recursos

Tema

Personalize a aparência do seu blog com templates Liquid.

O editor de temas do blog, com os arquivos do tema, o código e uma pré-visualização ao vivo

Arquivos do tema

Cada tema tem 8 arquivos:

ArquivoFunção
home.liquidTemplate da página inicial
category.liquidPágina de listagem de uma categoria
post.liquidPágina de um post
header.liquidPartial do cabeçalho compartilhado
footer.liquidPartial do rodapé compartilhado
shared.liquidComponentes reutilizáveis
styles.cssCSS personalizado
scripts.jsJavaScript personalizado

Templates Liquid

Os temas usam a sintaxe de templates Liquid:

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

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

Variáveis disponíveis

Globais (todas as páginas)

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

Categorias

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

Posts (página inicial e páginas de 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 %}

Post individual (página do post)

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

Paginação

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

Listas de newsletter

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

Filtros úteis

FiltroDescriçãoExemplo
dateFormata datas{{ post.published_at | date: "%B %d, %Y" }}
truncateLimita o tamanho do texto{{ post.excerpt | truncate: 150 }}
truncatewordsLimita o número de palavras{{ post.excerpt | truncatewords: 25 }}
upcase / downcaseMuda maiúsculas e minúsculas{{ category.name | upcase }}
capitalizeColoca a primeira letra em maiúscula{{ author.name | capitalize }}
strip_htmlRemove as tags HTML{{ post.content | strip_html }}
escapeEscapa as entidades HTML{{ post.title | escape }}
url_encodeCodifica para URLs{{ post.title | url_encode }}
defaultValor de reserva{{ post.featured_image_url | default: "/images/placeholder.jpg" }}
sizeTamanho de um array ou texto{{ posts | size }}
first / lastPega o primeiro ou o último item{{ categories | first }}
sortOrdena um array{{ posts | sort: "published_at" }}
reverseInverte um array{{ posts | reverse }}
whereFiltra um array{{ posts | where: "category_id", "news" }}
mapExtrai uma propriedade{{ posts | map: "title" }}
joinJunta os itens de um array{{ post.tags | join: ", " }}
splitDivide um texto{{ "a,b,c" | split: "," }}
replaceSubstitui texto{{ post.title | replace: "-", " " }}
append / prependAcrescenta ao texto{{ post.slug | prepend: "/" }}
plus / minusOperações matemáticas{{ pagination.current_page | plus: 1 }}
times / divided_byOperações matemáticas{{ post.reading_time_minutes | times: 60 }}

Partials

Include (compartilha o escopo pai)

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

Render (escopo isolado)

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

O nome do template precisa estar entre aspas: como no Shopify Liquid 5.11, {% render variable %} e {% snippet %} não são suportados. O Liquid nos temas funciona como nos templates de email, com as mesmas diferenças em relação ao Shopify Liquid.

Versões do tema

Os temas têm versões:

Versões do tema do blog: um rascunho v2 criado a partir do tema padrão e a v1 no ar
  • Só uma versão pode estar publicada por vez
  • Uma versão publicada nunca muda: salvar suas edições nela cria uma nova versão de rascunho
  • Salvar um rascunho atualiza esse rascunho
  • As versões não publicadas são rascunhos

Modo de pré-visualização

Pré-visualize temas não publicados adicionando ?preview_theme_version=X a qualquer URL do blog:

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

A pré-visualização ignora o cache e exige autenticação.