Vai al contenuto principale
L’editor di codice ti dà il pieno controllo su un modello. I modelli sono HTML e CSS con Liquid, lo stesso linguaggio di modelli che usa Shopify: {{ order_name }} stampa il nome dell’ordine, {% for line_item in line_items %} si ripete per ogni articolo. Le variabili dell’ordine di Foliant seguono quelle di Shopify Order Printer, quindi i modelli scritti per quest’ultimo funzionano per lo più così come sono. L’editor di codice è disponibile in tutti i piani.

Apri l’editor di codice

Apri il modello nell’editor e fai clic sulla scheda Codice. I modelli in codice si aprono direttamente lì. Per un modello visivo, vedi prima il codice compilato; fai clic su Modifica il codice per cambiarlo. Consulta Passa da Visivo a Codice e viceversa. Il riquadro a sinistra ha tre schede: Il riquadro a destra è l’anteprima in tempo reale. Si aggiorna poco dopo che hai smesso di digitare.

Inserisci un campo

  1. Posiziona il cursore dove deve andare il campo.
  2. Fai clic su Inserisci campo.
  3. Cerca il campo (ad esempio “tracking” o “SKU”) in Cerca campi e fai clic su di esso.
Foliant inserisce il relativo Liquid nella posizione del cursore, ad esempio {{ shipping_address.city }}. I campi degli articoli, come {{ line_item.sku }}, funzionano solo all’interno del ciclo degli articoli: inserisci Articoli riga per il ciclo stesso.

Cerca nel codice

Fai clic sul pulsante di ricerca accanto a Inserisci campo (oppure premi ⌘F / Ctrl+F nel codice) per trovare del testo nel modello.

Errori nel codice

L’editor controlla il codice mentre digiti e segnala i problemi a margine:
  • Gli errori ti impediscono di salvare e mettono in pausa l’anteprima. Un {{ o {% non chiuso è un errore. Sono elencati in un banner Errori nel Codice sopra l’editor, ciascuno con Vai alla riga.
  • Gli avvisi segnalano cose che potrebbero essere sbagliate ma non ti impediscono di salvare, ad esempio un filtro, un tag o un oggetto Liquid sconosciuto, un tag HTML o una proprietà CSS sconosciuti, oppure un tag HTML non chiuso.
Quando salvi, Foliant controlla anche il modello: il Liquid deve essere leggibile, i tag HTML devono essere bilanciati e gli SVG inline possono contenere solo elementi di disegno. Se qualcosa non va, il salvataggio non riesce e un banner Impossibile aggiornare elenca fino a cinque problemi, con i relativi numeri di riga quando sono noti. Se il modello viene salvato ma l’anteprima non può essere generata, un banner mostra il messaggio di Liquid e la riga, quando è nota.

Scrivi modelli ben fatti

  • I valori in denaro sono espressi in centesimi: stampali sempre con un filtro money, come {{ total_price | money }}. Consulta Denaro e valuta nei modelli.
  • Usa | escape sul testo digitato dai clienti, come note e indirizzi: {{ note | escape }}.
  • Usa {{ 'subtotal' | t }} per i testi che seguono la lingua del documento. Consulta Date, lingue e traduzioni.
  • Usa gli snippet integrati di Foliant per l’IVA: {% include 'vat_breakdown' %} stampa la tabella di riepilogo IVA e {% include 'legal_notes' %} le note legali (inversione contabile, esportazione, IOSS…).

Buono a sapersi

  • Se un modello numerato (fattura, nota di credito o preventivo) non stampa document_number da nessuna parte, Foliant aggiunge una piccola riga con il numero alla fine del documento. Consulta Numeri dei documenti nei modelli.
  • I numeri di pagina e le intestazioni di tabella ripetute per i modelli in codice si trovano nella pagina delle impostazioni del modello, in Layout di pagina.
  • Per trasferire un modello da Shopify Order Printer o Order Printer Pro, usa Importa un modello nella pagina Modelli. Consulta Importa un modello da Order Printer.

Articoli correlati