Aller au contenu principal
— Tutoriel de configuration

Personnaliser votre modèle de filigrane avec des variables

Le modèle de filigrane est un morceau de texte qui passe par un remplaçeur de jetons pour chaque commande. Le texte statique reste tel quel ; les jetons entourés d'accolades sont remplacés par le nom, l'e-mail, le numéro de commande de l'acheteur et d'autres données de commande au moment du marquage.

Avant de commencer

Ouvrez Paramètres → PDF Watermarking dans l'admin Alva. Le filigrane est réservé aux forfaits payants. L'éditeur de modèle a deux champs : le modèle de marquage (la grande superposition en diagonale ou positionnée) et le modèle de pied de page (texte plus petit en bas de chaque page). Les deux acceptent les mêmes variables.

Comment le modèle est rendu

Au moment du marquage, Alva Digital Downloads analyse le modèle, trouve chaque {token} et substitue les données de l'acheteur. Tout ce qui est en dehors des accolades est rendu exactement tel qu'il est écrit. Le modèle de marquage et le modèle de pied de page partagent la même liste de jetons, donc une variable qui fonctionne dans un champ fonctionne dans l'autre.

Variables disponibles

Alva prend en charge dix jetons regroupés en quatre catégories. Utilisez n'importe quelle combinaison d'entre eux dans les champs de marquage et de pied de page.

Client

  • {customer.full_name} — nom complet de l'acheteur depuis Shopify. Revient à l'e-mail quand les parties du nom sont vides (cela arrive pour les commandes Shopify POS où seul l'e-mail est capturé).
  • {customer.first_name} — prénom uniquement.
  • {customer.last_name} — nom de famille uniquement.
  • {customer.email} — adresse e-mail de l'acheteur.

Commande

  • {order.name} — nom de la commande Shopify, par ex. #1234.
  • {order.id} — identifiant interne de la commande Shopify (long numérique).
  • {order.date} — date de création de la commande dans le fuseau horaire de votre boutique.

Produit

  • {product.title} — titre du produit Shopify auquel le PDF appartient.
  • {file.name} — nom de fichier original du PDF.

Boutique

  • {shop.name} — nom de votre boutique Shopify.

Ajouter une variable via le sélecteur

1. Cliquez sur le champ que vous voulez modifier

Cliquez sur le champ du modèle de marquage ou du modèle de pied de page pour le focaliser. Le curseur se place là où vous cliquez dans le texte existant.

2. Cliquez sur n'importe quel bouton de variable

Sous le champ, cliquez sur n'importe quel bouton de variable — par exemple, {customer.full_name}. Chaque jeton est exposé en un seul clic.

3. Alva ajoute le jeton au champ

Alva ajoute le jeton à la fin du texte actuel du champ. Faites glisser le curseur et réarrangez la ligne à la main si vous avez besoin du jeton à une position différente.

4. Répétez pour chaque variable

Répétez pour chaque variable que vous voulez mélanger dans le modèle, puis enregistrez la page des paramètres. Cliquer sur un bouton de variable ajoute à la fin du champ — cela ne s'insère pas à la position du curseur.

Exemples de modèles

Trois exemples de modèles qui fonctionnent bien comme points de départ. Copiez l'un d'entre eux dans l'un ou l'autre champ et ajustez le texte statique à votre goût.

Marqueur de trace minimal

Licensed to {customer.email} · Order {order.name}

Ligne amicale destinée à l'acheteur

{customer.full_name} — purchased from {shop.name} on {order.date}

Ligne de pied de page complète

{product.title} · Order {order.name} · {customer.email} · {shop.name}

Limites et sécurité

  • Chaque champ de modèle est limité à 1 000 caractères.
  • Les sauts de ligne, tabulations et autres caractères de contrôle dans les données client sont remplacés par des espaces avant le rendu — Alva Digital Downloads assainit les jetons afin qu'un acheteur ne puisse pas casser la mise en page avec des données de profil construites.
  • Les valeurs vides (par ex. client sans nom de famille) sont rendues comme des chaînes vides, donc {customer.first_name} {customer.last_name} se réduit proprement au prénom seul sans espace final lorsque nécessaire.
  • Les jetons inconnus ({order.shipping_country} etc.) sont laissés littéralement dans la sortie rendue — Alva ne substitue que les jetons qu'il connaît.

Prévisualisez votre modèle

La page des paramètres affiche un aperçu en direct utilisant de fausses données de test — Test Customer, test@example.com, #1001. L'aperçu est une maquette CSS, pas un PDF réellement marqué. Pour vérifier la sortie réelle, activez un produit via , passez une commande de test contre vous-même et téléchargez le fichier.Activer le filigrane PDF sur un produit spécifique

Questions fréquentes

Puis-je utiliser le même modèle pour la superposition de marquage et la ligne de pied de page ?

Oui — les deux champs acceptent les mêmes variables. De nombreuses boutiques écrivent une seule courte ligne de trace dans le pied de page et une ligne plus décorative destinée au client dans le marquage en diagonale. Les deux champs sont indépendants donc vous pouvez aussi n'utiliser qu'un seul d'entre eux en laissant l'autre vide.

Qu'apparaît dans {customer.full_name} pour une commande Shopify POS ?

Shopify POS capture l'e-mail du client au checkout mais capture rarement le prénom et le nom. Quand les deux parties du nom sont vides, Alva Digital Downloads revient à l'e-mail du client afin que le filigrane n'affiche jamais « Licensed to ».

Les jetons inconnus comme {customer.phone} sont-ils remplacés par quelque chose ?

Non. Seuls les jetons documentés sont substitués. Tout le reste est laissé littéral dans le PDF rendu, ce qui rend les fautes de frappe visibles — un marquage indiquant « Licensed to {customer.emial} » vous dit immédiatement que le modèle a une faute de frappe à corriger.

Voir aussi

Cet article vous a-t-il été utile ?

Toujours bloqué ? Écrivez-nous.

Dernière mise à jour 2026-05-28