> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Filtros Liquid

> Os filtros Liquid que o Foliant acrescenta para valores monetários, datas, textos, moradas, imagens, códigos de barras, números e cores.

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](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-money-and-currency.md).

## 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](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-dates-and-languages.md).

## 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](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-barcodes-and-qr-codes.md).

## 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](https://foliant-help.iforiti.com/pt-PT/tax-and-legal.md).

## 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.

## Artigos relacionados

* [Valores monetários e moeda nos modelos](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-money-and-currency.md)
* [Datas, idiomas e traduções](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-dates-and-languages.md)
* [Códigos de barras e códigos QR](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-barcodes-and-qr-codes.md)
* [O objeto da encomenda e variáveis comuns](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-order-variables.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.