Funcionamento básico

Conceitos básicos do funcionamento do Liquid em sua loja Vnda.

O Liquid usa uma combinação de tags, objetos e filtros para carregar o conteúdo dinâmico da loja. Cada uma dessas construções possui um uso específico, como descrito na tabela abaixo:

ConstructUsoExemplo
Tags Lógica de exibição e controle de dados. O texto que cercam as tags não produz um resultado visível quando a página é renderizada no navegador, no entanto permite acessar objetos da plataforma e criar condições e repetições sem que código Liquid fique visível na vitrine da loja.
Para identificar tags utilize os delimitadores {% %} .
Controle de exibição de um conteúdo diferente na página de produtos em promoção:

{% if product.on_sale %} De: {{ product.price | money_format }} Por: {{ product.sale_price | money_format }} {% else %} Preço: {{ product.price | money_format }} {% endif %}

Nesse exemplo:
- Se o produto estiver em promoção, será exibido:
De: R$ 99,90
Por: R$ 79,90

- Se o produto não estiver em promoção, será exibido:
Preço: R$ 99,90

Saiba mais sobre o uso de tags na seção Tags.
ObjetosExibe partes de informações do Admin da sua loja.
Para identificar objetos utilize os delimitadores {{ }} .
Renderização das páginas de produto com os produtos cadastrados no Admin.
Se utilizamos um
{{ product.name }}, o resultado seria Camiseta de verão, por exemplo.

Nesse exemplo product é o objeto, e name é um atributo desse objeto.
Cada objeto tem uma lista de propriedades associadas a ele. Saiba mais na seção Objetos.
FiltrosFiltros são usados para modificar a exibição de números, strings, objetos e variáveis.
Eles são colocados em objetos {{ }}, e são separados por uma barra vertical (|).
- Modificar uma string com capitalização na primeira letra:
{{ "olá, mundo!" | capitalize }}
Resultado: Olá mundo

- Combinação de filtros em um mesmo elemento para capitalizar e retirar uma palavra:
{{ "olá, mundo!" | capitalize | remove: "mundo" }}
Resultado: Olá, !

Na combinação de filtros a ordem de priorização é feita da esquerda para a direita:

Veja mais como utilizar os filtros em Filtros.

A forma em que esses componentes da tabela são utilizados na sua loja estão descritos na seção Templates de Páginas. A princípio é importante saber que o uso de tags, objetos e filtros dependem das páginas da sua loja, e os arquivos que compõe os Templates de Páginas são os arquivos que possuem as principais definições e conteúdo das páginas sua loja.

📘

Liquid na pasta do projeto

Os arquivos Liquid estão dentro da pasta liquids do seu projeto. Saiba mais em Pasta Liquids.