Filtres Liquid

Les filtres modifient la façon dont une valeur s’imprime. Vous les ajoutez après une valeur avec une barre verticale : {{ total_price | money }}. Vous pouvez les enchaîner : {{ note | escape | newline_to_br }}. Foliant prend en charge les filtres standard de Liquid (comme escape, default, upcase, date, plus, minus, split, join, newline_to_br) et ajoute ceux ci-dessous.

Montants

Filtre	Exemple	Ce qu’il fait
`money`	`{{ total_price \| money }}`	Un montant en centimes, dans la devise de la commande
`money_with_currency`	`{{ total_price \| money_with_currency }}`	La même chose, avec le code de la devise (`$1.00 USD`)
`money_without_currency`	`{{ total_price \| money_without_currency }}`	Le nombre seul (`1.00`)
`money_without_trailing_zeros`	`{{ 10000 \| money_without_trailing_zeros }}`	Omet `.00` (`$100`)
`money_in`	`{{ amount \| money_in: 'EUR' }}`	Un montant dans la devise que vous indiquez

Consultez Montants et devises dans les modèles.

Dates et libellés

Filtre	Exemple	Ce qu’il fait
`date`	`{{ created_at \| date: '%d %B %Y' }}`	Met en forme une date, avec les noms des mois et des jours dans la langue du document. Ajoutez une langue pour la remplacer : `date: '%B', customer_locale`.
`t` (ou `translate`, `label`)	`{{ 'subtotal' \| t }}`	Le libellé de Foliant dans la langue du document
`t_both`	`{{ 'titles.invoice' \| t_both }}`	Le libellé dans la langue du document et dans sa deuxième langue (« Rechnung / Invoice »)
`labelled`	`{{ shop.vat_number \| labelled: 'vat_number', ' · ' }}`	Une valeur après son libellé (« · Numéro de TVA NL… ») ; rien si la valeur est vide

Consultez Dates, langues et traductions.

Adresses, images et liens

Filtre	Exemple	Ce qu’il fait
`format_address`	`{{ shipping_address \| format_address }}`	Une adresse disposée sur plusieurs lignes, comme le fait Shopify
`img_url`	`{{ line_item.image \| img_url: '120x120' }}`	Une image Shopify à une taille donnée : `'thumb'`, `'small'`, `'medium'`, `'large'` ou `'120x120'`
`img_tag`	`{{ line_item.image \| img_url: 'thumb' \| img_tag }}`	Une balise `<img>` pour l’adresse d’une image. Texte alternatif et classe facultatifs : `img_tag: 'Logo', 'logo'`
`link_to`	`{{ 'Track your order' \| link_to: order_status_url }}`	Un lien

Codes-barres et codes QR

Filtre	Exemple	Ce qu’il fait
`barcode`	`{{ line_item.sku \| barcode }}`	Un code-barres (Code 128, sauf si vous indiquez un type, comme `'ean13'`)
`qr`	`{{ order_status_url \| qr }}`	Un code QR

Consultez Codes-barres et codes QR.

Nombres et texte

Filtre	Exemple	Ce qu’il fait
`weight_with_unit`	`{{ line_item.grams \| weight_with_unit }}`	Un poids en grammes avec son unité : grammes, ou kilogrammes à partir de 1 000 g. Indiquez une unité pour convertir : `weight_with_unit: 'lb'` (`kg`, `g`, `lb` ou `oz`)
`format_number`	`{{ 1234.5 \| format_number: 2 }}`	Un nombre avec les séparateurs de la langue du document (`1.234,50` en allemand)
`number_with_precision`	`{{ 1.2345 \| number_with_precision: 2 }}`	Un nombre avec ce nombre de décimales (`1.23`)
`pluralize`	`{{ item_count \| pluralize: 'item', 'items' }}`	Le mot au singulier ou au pluriel selon un nombre
`handleize`	`{{ 'Hello World!' \| handleize }}`	`hello-world`
`strip_html`	`{{ product.description \| strip_html }}`	Supprime les balises HTML
`truncate_words`	`{{ product.description \| truncate_words: 20 }}`	Raccourcit un texte à un nombre de mots
`default_value`	`{{ po_number \| default_value: 'N/A' }}`	Une valeur de repli quand la valeur est vide
`json`	`{{ shipping_address \| json }}`	La valeur sous forme de données, pour voir son contenu pendant que vous créez un modèle

Couleurs

Filtre	Exemple	Ce qu’il fait
`color_mix`	`{{ shop_accent_color \| color_mix: '#ffffff', 20 }}`	Mélange deux couleurs : 20 % de la première
`color_contrast`	`{{ shop_accent_color \| color_contrast: '#ffffff' }}`	Le rapport de contraste entre deux couleurs (1–21)

Snippets

Deux snippets intégrés impriment les sections de TVA standard :

{% include 'vat_breakdown' %} : le tableau de ventilation de la TVA, par taux.
{% include 'legal_notes' %} : les mentions légales de TVA (autoliquidation, exportation, IOSS…).

Consultez Taxes et mentions légales.

Bon à savoir

L’éditeur de code signale par un avertissement les filtres qu’il ne connaît pas. Vérifiez l’aperçu chaque fois que vous en voyez un.
Certains filtres des thèmes de boutique Shopify n’existent pas dans les documents. Tenez-vous-en aux filtres ci-dessus et aux filtres standard de Liquid.

Bienvenue

Premiers pas

Impression

Modèles

Éditeur de modèles

Designs

Envoi des PDF

Modèles d'e-mail

Comptes clients

Exportations

Factures et numérotation

Taxes et mentions légales

Intégrations

Facturation et forfaits

Paramètres

Dépannage

Mentions légales