Prima di iniziare
Apri Impostazioni → Filigrana PDF nell'admin di Alva. La filigrana è solo per piani a pagamento. L'editor del template ha due campi: il template del timbro (la grande sovrapposizione diagonale o posizionata) e il template del piè di pagina (testo più piccolo in fondo a ogni pagina). Entrambi accettano le stesse variabili.
Come viene renderizzato il template
Al momento della timbratura, Alva Digital Downloads analizza il template, trova ogni {token} e sostituisce i dati dell'acquirente. Qualsiasi cosa al di fuori delle parentesi graffe viene renderizzata esattamente come scritta. Il template del timbro e il template del piè di pagina condividono la stessa lista di token, quindi una variabile che funziona in un campo funziona nell'altro.
Variabili disponibili
Alva supporta dieci token raggruppati in quattro categorie. Usa qualsiasi combinazione di essi nei campi del timbro e del piè di pagina.
Cliente
{customer.full_name}— nome completo dell'acquirente da Shopify. Ripiega sull'email quando le parti del nome sono vuote (succede per gli ordini Shopify POS dove viene catturata solo l'email).{customer.first_name}— solo nome.{customer.last_name}— solo cognome.{customer.email}— indirizzo email dell'acquirente.
Ordine
{order.name}— nome dell'ordine Shopify, ad es.#1234.{order.id}— identificatore interno dell'ordine Shopify (numerico lungo).{order.date}— data di creazione dell'ordine nel fuso orario del tuo negozio.
Prodotto
{product.title}— titolo del prodotto Shopify a cui appartiene il PDF.{file.name}— nome del file originale del PDF.
Negozio
{shop.name}— nome del tuo negozio Shopify.
Aggiungi una variabile tramite il selettore
1. Clicca il campo che vuoi modificare
Clicca il campo del template del timbro o del template del piè di pagina per metterlo a fuoco. Il cursore atterra ovunque tu clicchi all'interno del testo esistente.
2. Clicca un pulsante variabile
Sotto il campo, clicca qualsiasi pulsante variabile — ad esempio, {customer.full_name}. Ogni token è esposto come un singolo click.
3. Alva aggiunge il token al campo
Alva aggiunge il token alla fine del testo corrente del campo. Trascina il cursore e riorganizza la riga a mano se hai bisogno del token in una posizione diversa.
4. Ripeti per ogni variabile
Ripeti per ogni variabile che vuoi mescolare nel template, poi salva la pagina impostazioni. Cliccare un pulsante variabile aggiunge alla fine del campo — non inserisce nella posizione del cursore.
Template di esempio
Tre template di esempio che funzionano bene come punto di partenza. Copia uno di essi in entrambi i campi e adatta il testo statico a piacere.
Marcatore di traccia minimale
Licensed to {customer.email} · Order {order.name}Riga amichevole rivolta all'acquirente
{customer.full_name} — purchased from {shop.name} on {order.date}Riga completa del piè di pagina
{product.title} · Order {order.name} · {customer.email} · {shop.name}Limiti e sicurezza
- Ogni campo del template è limitato a 1.000 caratteri.
- Interruzioni di riga, tabulazioni e altri caratteri di controllo nei dati cliente vengono ridotti a spazi prima del rendering — Alva Digital Downloads sanifica i token in modo che un acquirente non possa rompere il layout con dati di profilo creati ad arte.
- I valori vuoti (ad es. cliente senza cognome) vengono renderizzati come stringhe vuote, quindi
{customer.first_name} {customer.last_name}collassa pulitamente al solo nome senza spazio finale quando necessario. - I token sconosciuti (
{order.shipping_country}ecc.) vengono lasciati nell'output renderizzato letteralmente — Alva sostituisce solo i token che conosce.
Visualizza l'anteprima del tuo template
La pagina impostazioni mostra un'anteprima dal vivo usando dati di test finti — Test Customer, test@example.com, #1001. L'anteprima è un mock CSS, non un PDF effettivamente timbrato. Per verificare l'output reale, abilita un prodotto tramite , effettua un ordine di prova a te stesso e scarica il file.Abilita la filigrana PDF su un prodotto specifico
Domande frequenti
Sì — entrambi i campi accettano le stesse variabili. Molti negozi scrivono una singola breve riga di traccia nel piè di pagina e una riga più decorativa rivolta al cliente nel timbro diagonale. I due campi sono indipendenti, quindi puoi anche usarne solo uno lasciando l'altro vuoto.
Shopify POS cattura l'email del cliente al checkout ma raramente cattura nome e cognome. Quando entrambe le parti del nome sono vuote, Alva Digital Downloads ripiega sull'email del cliente in modo che la filigrana non legga mai "Licensed to ".
No. Solo i token documentati vengono sostituiti. Qualsiasi altra cosa viene lasciata letterale nel PDF renderizzato, il che rende visibili gli errori di battitura — un timbro che legge "Licensed to {customer.emial}" ti dice immediatamente che il template ha un refuso da correggere.
Vedi anche
È stato utile?
Ultimo aggiornamento 2026-05-28