Arquivos do tema
Cada tema tem 8 arquivos:
| Arquivo | Função |
|---|---|
home.liquid | Template da página inicial |
category.liquid | Página de listagem de uma categoria |
post.liquid | Página de um post |
header.liquid | Partial do cabeçalho compartilhado |
footer.liquid | Partial do rodapé compartilhado |
shared.liquid | Componentes reutilizáveis |
styles.css | CSS personalizado |
scripts.js | JavaScript 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
| Filtro | Descrição | Exemplo |
|---|---|---|
date | Formata datas | {{ post.published_at | date: "%B %d, %Y" }} |
truncate | Limita o tamanho do texto | {{ post.excerpt | truncate: 150 }} |
truncatewords | Limita o número de palavras | {{ post.excerpt | truncatewords: 25 }} |
upcase / downcase | Muda maiúsculas e minúsculas | {{ category.name | upcase }} |
capitalize | Coloca a primeira letra em maiúscula | {{ author.name | capitalize }} |
strip_html | Remove as tags HTML | {{ post.content | strip_html }} |
escape | Escapa as entidades HTML | {{ post.title | escape }} |
url_encode | Codifica para URLs | {{ post.title | url_encode }} |
default | Valor de reserva | {{ post.featured_image_url | default: "/images/placeholder.jpg" }} |
size | Tamanho de um array ou texto | {{ posts | size }} |
first / last | Pega o primeiro ou o último item | {{ categories | first }} |
sort | Ordena um array | {{ posts | sort: "published_at" }} |
reverse | Inverte um array | {{ posts | reverse }} |
where | Filtra um array | {{ posts | where: "category_id", "news" }} |
map | Extrai uma propriedade | {{ posts | map: "title" }} |
join | Junta os itens de um array | {{ post.tags | join: ", " }} |
split | Divide um texto | {{ "a,b,c" | split: "," }} |
replace | Substitui texto | {{ post.title | replace: "-", " " }} |
append / prepend | Acrescenta ao texto | {{ post.slug | prepend: "/" }} |
plus / minus | Operações matemáticas | {{ pagination.current_page | plus: 1 }} |
times / divided_by | Operaçõ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:
- 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.
