Filtros Liquid

Os filtros mudam a forma como um valor é impresso. Você os adiciona depois de um valor com uma barra vertical: {{ total_price | money }}. Você pode encadeá-los: {{ note | escape | newline_to_br }}. O Foliant é compatível com os filtros padrão do Liquid (como escape, default, upcase, date, plus, minus, split, join, newline_to_br) e adiciona os filtros abaixo.

Valores monetários

Filtro	Exemplo	O que faz
`money`	`{{ total_price \| money }}`	Um valor em centavos, na moeda do pedido
`money_with_currency`	`{{ total_price \| money_with_currency }}`	O mesmo, com o código da moeda (`$1.00 USD`)
`money_without_currency`	`{{ total_price \| money_without_currency }}`	Só o número (`1.00`)
`money_without_trailing_zeros`	`{{ 10000 \| money_without_trailing_zeros }}`	Omite o `.00` (`$100`)
`money_in`	`{{ amount \| money_in: 'EUR' }}`	Um valor na moeda que você indicar

Consulte Valores e moedas nos modelos.

Datas e textos

Filtro	Exemplo	O que faz
`date`	`{{ created_at \| date: '%d %B %Y' }}`	Formata uma data, com os nomes dos meses e dias no idioma do documento. Adicione um idioma para substituí-lo: `date: '%B', customer_locale`.
`t` (também `translate`, `label`)	`{{ 'subtotal' \| t }}`	Os textos do Foliant no idioma do documento
`t_both`	`{{ 'titles.invoice' \| t_both }}`	O texto no idioma do documento e no segundo idioma (“Rechnung / Invoice”)
`labelled`	`{{ shop.vat_number \| labelled: 'vat_number', ' · ' }}`	Um valor depois do seu rótulo (” · Número de IVA NL…”); nada quando o valor está vazio

Consulte Datas, idiomas e traduções.

Endereços, imagens e links

Filtro	Exemplo	O que faz
`format_address`	`{{ shipping_address \| format_address }}`	Um endereço distribuído em linhas, como a Shopify faz
`img_url`	`{{ line_item.image \| img_url: '120x120' }}`	Uma imagem da Shopify em um tamanho: `'thumb'`, `'small'`, `'medium'`, `'large'` ou `'120x120'`
`img_tag`	`{{ line_item.image \| img_url: 'thumb' \| img_tag }}`	Uma tag `<img>` para o endereço de uma imagem. Texto alternativo e classe opcionais: `img_tag: 'Logo', 'logo'`
`link_to`	`{{ 'Track your order' \| link_to: order_status_url }}`	Um link

Códigos de barras e QR codes

Filtro	Exemplo	O que faz
`barcode`	`{{ line_item.sku \| barcode }}`	Um código de barras (Code 128, a menos que você indique um tipo, como `'ean13'`)
`qr`	`{{ order_status_url \| qr }}`	Um QR code

Consulte Códigos de barras e QR codes.

Números e texto

Filtro	Exemplo	O que faz
`weight_with_unit`	`{{ line_item.grams \| weight_with_unit }}`	Um peso em gramas com a unidade: gramas, ou quilos a partir de 1.000 g. Indique uma unidade para converter: `weight_with_unit: 'lb'` (`kg`, `g`, `lb` ou `oz`)
`format_number`	`{{ 1234.5 \| format_number: 2 }}`	Um número com os separadores do idioma do documento (`1.234,50` em alemão)
`number_with_precision`	`{{ 1.2345 \| number_with_precision: 2 }}`	Um número com essa quantidade de casas decimais (`1.23`)
`pluralize`	`{{ item_count \| pluralize: 'item', 'items' }}`	A palavra no singular ou no plural, conforme a quantidade
`handleize`	`{{ 'Hello World!' \| handleize }}`	`hello-world`
`strip_html`	`{{ product.description \| strip_html }}`	Remove as tags HTML
`truncate_words`	`{{ product.description \| truncate_words: 20 }}`	Encurta o texto para um número de palavras
`default_value`	`{{ po_number \| default_value: 'N/A' }}`	Um valor alternativo quando o valor está vazio
`json`	`{{ shipping_address \| json }}`	O valor como dados, para você ver o conteúdo enquanto cria um modelo

Cores

Filtro	Exemplo	O que faz
`color_mix`	`{{ shop_accent_color \| color_mix: '#ffffff', 20 }}`	Mistura duas cores: 20% da primeira
`color_contrast`	`{{ shop_accent_color \| color_contrast: '#ffffff' }}`	A taxa de contraste entre duas cores (1–21)

Snippets

Dois snippets integrados imprimem seções padrão de IVA:

{% include 'vat_breakdown' %}: a tabela de detalhamento do IVA, por alíquota.
{% include 'legal_notes' %}: as notas legais de IVA (autoliquidação, exportação, IOSS…).

Consulte Impostos e questões legais.

Bom saber

O editor de código marca com um aviso os filtros que não reconhece. Confira a pré-visualização sempre que vir um.
Alguns filtros dos temas de loja virtual da Shopify não existem nos documentos. Use apenas os filtros acima e os filtros padrão do Liquid.

Boas-vindas

Primeiros passos

Impressão

Modelos

Editor de modelos

Designs

Envio de PDFs

Modelos de e-mail

Contas de clientes

Exportações

Faturas e numeração

Impostos e jurídico

Integrações

Cobrança e planos

Configurações

Solução de problemas

Jurídico