Pular para o conteúdo principal
Tags ficam entre {% %}. Apenas as tags desta página existem — qualquer outra é erro e a página não renderiza.

Controle de fluxo

if, elsif, else, unless, case/when, for, tablerow, cycle, break, continue, assign, capture, increment, decrement, echo, liquid, comment, # (comentário de linha) e raw. Ver exemplos em Sintaxe.

render: componentes

Inclui um componente, com variáveis próprias:
Com um nome simples, a busca é: raiz do tema → snippets/ → components/. O componente enxerga as variáveis globais, os resultados de {% load %} e os parâmetros que você passar. Variáveis criadas na página com assign/capture não chegam ao componente — passe como parâmetro. {% include %} também existe e compartilha todas as variáveis da página.

layout e block

A página declara o layout na primeira linha; o resto dela entra no {% block %} do layout. Parâmetros depois da vírgula viram variáveis dentro do layout:
layouts/layout.liquid
pages/index.liquid
Blocos com nome ({% block conteudo %}) só funcionam se o layout declarar um bloco com o mesmo nome. Ver também o layout automático layouts/base.liquid em Páginas.

section: blocos de layout

Renderiza sections/<nome>. O nome usa letras minúsculas, números, _ e -. Profundidade máxima de aninhamento: 6.
Se o tema não tiver o arquivo, a AllBay usa a seção da plataforma de mesmo nome, quando existe: hero, product-grid, benefits, announcement, category_carousel, category_with_products. Uma seção que não existe ou que falha não aparece (sem erro).

tailwindcss

Insere o <link> do CSS do Tailwind gerado a partir do tailwind.config.json do tema:

load: dados dinâmicos

Carrega dados da loja direto no template. O resultado vira uma variável com o nome da entidade, ou com o nome dado por as:
  • O as vem logo depois do nome da entidade: {% load "product" as produto, slug: "x" %}.
  • Ids são texto: escreva category_id: "123..." (entre aspas). Um número faz o load falhar.
  • Os parâmetros são separados por vírgula — um texto com vírgula não funciona como valor.
Comportamento:
  • Se o load falhar (parâmetro inválido, tempo esgotado), a variável não é alterada.
  • product e post não encontrados viram uma lista vazia [], que é verdadeira em {% if %} — teste um campo: {% if produto.name %}.
  • Até 20 load por página, contando o layout declarado com {% layout %} (só o layouts/base.liquid tem os seus próprios 20). Os excedentes são ignorados.
  • O resultado vale na página, no layout, em {% section %} e dentro de {% render %}.

Entidades disponíveis

Em packages, size e total contam os itens desta página; o total do catálogo está em meta.total. package_feedbacks e feedbacks criam variáveis com nomes fixos e ignoram o as.
orders (pedidos do cliente) não é carregado por load — é preenchido pela AllBay nas páginas /account/*. Um {% load "orders" %} não altera esse valor.