Filtros Liquid

Os filtros alteram a forma como um valor é impresso. Adicione-os a seguir a um valor, com uma barra vertical: {{ total_price | money }}. Pode encadeá-los: {{ note | escape | newline_to_br }}. O Foliant suporta os filtros padrão do Liquid (como escape, default, upcase, date, plus, minus, split, join, newline_to_br) e acrescenta os filtros abaixo.

Valores monetários

Filtro	Exemplo	O que faz
`money`	`{{ total_price \| money }}`	Um montante em cêntimos, na moeda da encomenda
`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 }}`	Apenas o número (`1.00`)
`money_without_trailing_zeros`	`{{ 10000 \| money_without_trailing_zeros }}`	Omite `.00` (`$100`)
`money_in`	`{{ amount \| money_in: 'EUR' }}`	Um montante na moeda que indicar

Consulte Valores monetários e moeda 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 dos dias no idioma do documento. Para usar outro idioma, indique-o: `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 seu segundo idioma (“Rechnung / Invoice”)
`labelled`	`{{ shop.vat_number \| labelled: 'vat_number', ' · ' }}`	Um valor a seguir à sua etiqueta (” · NIF NL…”); nada quando o valor está vazio

Consulte Datas, idiomas e traduções.

Moradas, imagens e ligações

Filtro	Exemplo	O que faz
`format_address`	`{{ shipping_address \| format_address }}`	Uma morada disposta em linhas, tal como o Shopify faz
`img_url`	`{{ line_item.image \| img_url: '120x120' }}`	Uma imagem do Shopify num tamanho: `'thumb'`, `'small'`, `'medium'`, `'large'` ou `'120x120'`
`img_tag`	`{{ line_item.image \| img_url: 'thumb' \| img_tag }}`	Uma etiqueta `<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 }}`	Uma ligação

Códigos de barras e códigos QR

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

Consulte Códigos de barras e códigos QR.

Números e texto

Filtro	Exemplo	O que faz
`weight_with_unit`	`{{ line_item.grams \| weight_with_unit }}`	Um peso em gramas com a respetiva unidade: gramas, ou quilogramas a partir de 1000 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 esse número de casas decimais (`1.23`)
`pluralize`	`{{ item_count \| pluralize: 'item', 'items' }}`	A palavra no singular ou no plural, consoante a quantidade
`handleize`	`{{ 'Hello World!' \| handleize }}`	`hello-world`
`strip_html`	`{{ product.description \| strip_html }}`	Remove as etiquetas 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 em forma de dados, para ver o que contém 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 relação de contraste entre duas cores (1–21)

Snippets

Dois snippets incluídos imprimem as secções de IVA padrão:

{% include 'vat_breakdown' %}: a tabela de discriminação do IVA, por taxa.
{% include 'legal_notes' %}: as menções legais do IVA (autoliquidação, exportação, IOSS…).

Consulte Impostos e questões legais.

Bom saber

O editor de código assinala com um aviso os filtros que não conhece. Verifique a pré-visualização sempre que vir um.
Alguns filtros dos temas da loja online do Shopify não existem nos documentos. Utilize apenas os filtros acima e os filtros padrão do Liquid.

Boas-vindas

Primeiros passos

Impressão

Modelos

Editor de modelos

Designs

Envio de PDF

Modelos de email

Contas de cliente

Exportações

Faturas e numeração

Impostos e jurídico

Integrações

Faturação e planos

Definições

Resolução de problemas

Jurídico