Due modi per catturare la personalizzazione
Shopify possiede lo storefront e il checkout, quindi l'input viene aggiunto tramite meccanismi nativi Shopify. Scegli un percorso.
- Line-item property — un campo personalizzato sulla pagina prodotto. Funziona su ogni piano Shopify. Richiede una piccola modifica al tema.
- Estensione UI checkout — un blocco personalizzato renderizzato dentro al checkout. Solo Shopify Plus. Nessuna modifica al tema, ma uno sviluppatore distribuisce un'app personalizzata.
Entrambi i metodi producono lo stesso risultato: una proprietà collegata alla line item. Finché si chiama Customization Request, Alva estrae il valore automaticamente.
Metodo 1 — Line item property
1. Apri il template prodotto
Nell'admin Shopify, vai a Online Store → Temi, clicca Modifica codice e apri sections/main-product.liquid (o product-template.liquid sui temi più vecchi).
Editor di codice del tema Shopify. Mostra l'albero dei file a sinistra con main-product.liquid evidenziato e il file Liquid aperto a destra fatto scorrere fino al blocco del form prodotto. Nessun dato shop reale visibile.
2. Aggiungi l'input dentro al form prodotto
All'interno del blocco {% form 'product' %}, aggiungi una label e un input testo. L'attributo name deve usare la sintassi a parentesi properties[Customization Request] — questo dice a Shopify di collegare il valore alla line item.
<label for="customization">Personalisation request</label>
<input type="text"
id="customization"
name="properties[Customization Request]"
maxlength="200"
required>3. Imposta vincoli di obbligatorietà e lunghezza
Aggiungi required così i clienti non possono lasciarlo vuoto, e maxlength="200" così non possono incollare un paragrafo. Mantieni la label concreta — Nome da ricamare batte Personalizzazione.
4. Salva ed effettua un ordine di test
Salva il template, visualizza il prodotto sullo storefront, riempi l'input ed effettua un ordine di test. Il valore appare in Shopify sotto Ordine → Line items e dentro Alva nella pagina di dettaglio ordine personalizzato.
Una pagina prodotto sullo storefront con l'input di personalizzazione renderizzato sopra al pulsante Aggiungi al carrello. Campo etichettato "Nome da ricamare" con un esempio segnaposto. Nessun branding shop reale richiesto.
Metodo 2 — Estensione UI checkout
I merchant Plus possono renderizzare l'input dentro al checkout stesso. Alva Digital Downloads non spedisce questa estensione — costruirla è un compito da sviluppatore Shopify. Vedi la reference delle estensioni UI checkout di Shopify per l'API attuale.
1. Genera lo scaffold di un'estensione
Da un'app Shopify personalizzata, esegui shopify app generate extension e scegli Estensione UI checkout. Scegli il target purchase.checkout.block.render.
2. Scrivi la line-item property
Usa l'API line-item property da @shopify/ui-extensions-react/checkout per collegare il valore alla line item sotto la chiave Customization Request.
3. Distribuisci e posiziona il blocco
Esegui shopify app deploy, poi in Impostazioni → Checkout → Personalizza, trascina il nuovo blocco nel layout ed effettua un ordine di test.
Dove appare il valore in Alva
Quando Shopify attiva il webhook orders/paid, Alva legge qualsiasi line-item property chiamata esattamente Customization Request e la memorizza contro l'acquisto. La pagina di dettaglio ordine personalizzato renderizza il valore sopra al caricatore di file, e lo stesso testo è incluso nell'email di notifica del merchant.
FAQ
Posso rendere obbligatorio il campo di personalizzazione?
Sì. Aggiungi l'attributo HTML required. Shopify blocca Aggiungi al carrello finché il campo non ha un valore. Il metodo dell'estensione UI checkout espone un'opzione required nelle impostazioni dell'estensione.
Posso catturare più di un input per prodotto?
Sì, ma Alva estrae automaticamente solo la proprietà chiamata Customization Request. Altre line-item properties appaiono comunque sull'ordine Shopify e sono visibili dentro Alva nella pagina di dettaglio ordine.
Il cliente può modificare l'input dopo che l'ordine è pagato?
No. Le line-item properties sono immutabili una volta che l'ordine è effettuato. Se serve una correzione, chiedi al cliente di inviarla via email e aggiorna le note dell'ordine manualmente prima di caricare il file.
Vedi anche
È stato utile?
Last updated 2026-05-06