⚠️ Avviso importante
Funzionalità dell’editor di codice
IntelliSense TypeScript
props disponibili mentre digiti. I suggerimenti sui tipi delle prop sono IntelliSense esclusivo dell’editor per aiutarti a scrivere i template — non sono qualcosa che scrivi nel template e non vengono mai eseguiti sul tuo negozio online.
Corpo del template modificabile
Sezione General
Header
Prop disponibili - Template completo

cartQuantity
-
Tipo:
string - Descrizione: il numero attuale di articoli nel carrello, formattato come stringa
- Utilizzo: mostra il conteggio degli articoli del carrello nel design personalizzato della tua intestazione
closeHandler
-
Tipo:
() => void - Descrizione: una funzione di callback che chiude il carrello quando viene attivata
- Utilizzo: collegala a pulsanti, icone o altri elementi interattivi per chiudere il carrello
titleComponent
-
Tipo:
React.ReactElement | null - Descrizione: un componente titolo pre-renderizzato per l’intestazione del carrello che include stili e traduzioni corretti
- Utilizzo: mostra il titolo del carrello in base alla configurazione delle impostazioni del tuo carrello
Sezione Body
Announcements
Prop disponibili - Template completo

announcementTemplate
-
Tipo:
string - Descrizione: il contenuto HTML del messaggio di annuncio
- Utilizzo: mostra il messaggio di annuncio nelle tue implementazioni personalizzate
timer
-
Tipo:
string - Descrizione: il valore attuale del timer formattato come stringa
- Utilizzo: mostra il conto alla rovescia nelle implementazioni personalizzate degli annunci
shouldUseTimer
-
Tipo:
boolean - Descrizione: indica se la funzionalità timer è abilitata per questo annuncio
- Utilizzo: renderizza in modo condizionale contenuti e controlli legati al timer
isTimerExpiredAndShouldHide
-
Tipo:
boolean - Descrizione: indica se il timer è scaduto e l’annuncio deve essere nascosto
- Utilizzo: controlla la visibilità dell’intero annuncio in base allo stato del timer
Tiered Rewards
Prop disponibili - Template completo

rewardsMessageHtml
-
Tipo:
string - Descrizione: il contenuto HTML del messaggio dei premi
- Utilizzo: mostra il messaggio dei premi con formattazione avanzata nelle implementazioni personalizzate
milestonesCompleted
-
Tipo:
number - Descrizione: il numero di traguardi completati
- Utilizzo: mostra il conteggio dei completamenti o calcola la percentuale di completamento
milestonesData
-
Tipo:
- Descrizione: configurazione completa dei traguardi e dati di avanzamento per il sistema dei premi
- Utilizzo: accedi alle informazioni sui traguardi, alla percentuale di avanzamento e alle impostazioni di visualizzazione
-
Proprietà:
milestonesToRender: array di oggetti traguardo con stato di completamento e posizionamentoprogressPercent: avanzamento attuale come percentuale (0-100)showMilestones: se mostrare gli indicatori dei traguardisettings: configurazione visiva per la visualizzazione dei traguardi
Discounts
TRIGGERED_REWARDS, per retrocompatibilità con il codice dei template personalizzati esistenti.
Prop disponibili - Template completo
rules
-
Tipo:
- Descrizione: array delle regole di sconto attualmente abilitate
- Utilizzo: mostra i premi disponibili, i loro titoli, le descrizioni e se le condizioni di ciascuna regola sono state soddisfatte
-
Proprietà:
id: identificatore univoco della regola del premiotitle: titolo della regola di scontodescription: descrizione della regola del premioconditionsMet: se le condizioni della regola sono attualmente soddisfatte dal carrello. Usala per costruire pattern UX del tipo “hai sbloccato X” vs “spendi altri $Y per sbloccare X”
showSection
-
Tipo:
boolean - Descrizione: indica se la sezione Discounts deve essere mostrata
- Utilizzo: controlla la visibilità dell’intero modulo Discounts
onToggleSection
-
Tipo:
() => void - Descrizione: una funzione di callback che attiva/disattiva lo stato di visibilità della sezione Discounts
- Utilizzo: collegala a pulsanti o elementi interattivi per consentire agli utenti di mostrare/nascondere la sezione dei premi
Recommendations
Prop disponibili - Template tile raccomandazione

Cart Items
Mostrare un indicatore di caricamento durante l’aggiunta al carrello o gli aggiornamenti del carrello: il modulo Cart Items standard non espone uno spinner “aggiunta al carrello” integrato. Se vuoi mostrare uno stato di caricamento mentre un articolo viene aggiunto o un’operazione sul carrello è in corso, usa il template Product tile e leggi le prop
isLoading e loadingOperation (documentate qui sotto) per renderizzare in modo condizionale uno spinner o un overlay. I template personalizzati richiedono esperienza da sviluppatore — vedi l’avviso in cima a questa pagina.Prop disponibili - Template Product tile
Se vuoi usare codice personalizzato in uno di quei template, devi disattivare il template Product Tile.

title
-
Tipo:
string - Descrizione: il titolo/nome del prodotto
- Utilizzo: mostra il nome principale del prodotto negli articoli del carrello
variant
-
Tipo:
React.ReactNode - Descrizione: componente pre-renderizzato con le informazioni sulla variante
- Utilizzo: mostra i dettagli della variante come componente React
properties
-
Tipo:
React.ReactNode - Descrizione: componente pre-renderizzato con le proprietà del prodotto
- Utilizzo: mostra le proprietà del prodotto e le informazioni sull’abbonamento come componente React
bundle
-
Tipo:
React.ReactNode - Descrizione: componente pre-renderizzato con i dettagli del bundle
- Utilizzo: mostra le informazioni sul bundle come componente React
compareAtPrice
-
Tipo:
string | undefined - Descrizione: prezzo confrontato formattato (prezzo originale)
- Utilizzo: mostra il prezzo originale per gli articoli in saldo
price
-
Tipo:
string - Descrizione: prezzo attuale formattato
- Utilizzo: mostra il prezzo attuale dell’articolo
savings
-
Tipo:
string | undefined - Descrizione: importo del risparmio formattato
- Utilizzo: mostra quanto risparmia il cliente
imageUrl
-
Tipo:
string | undefined - Descrizione: URL dell’immagine del prodotto
- Utilizzo: mostra l’immagine del prodotto
productUrl
-
Tipo:
string | undefined - Descrizione: URL della pagina del prodotto
- Utilizzo: collega alla pagina di dettaglio del prodotto
quantity
-
Tipo:
number - Descrizione: quantità attuale dell’articolo nel carrello
- Utilizzo: mostra e gestisci la quantità dell’articolo
showQuantitySelector
-
Tipo:
boolean - Descrizione: se mostrare i controlli della quantità
- Utilizzo: mostra in modo condizionale il selettore di quantità
discountCodes
-
Tipo:
string[] | undefined - Descrizione: array dei codici sconto applicati a questo articolo
- Utilizzo: mostra gli sconti specifici dell’articolo
subscription
-
Tipo:
- Descrizione: oggetto completo di gestione dell’abbonamento con dati di upgrade, piani di vendita e funzioni handler
- Utilizzo: gestisci la funzionalità di abbonamento
-
L’oggetto subscription contiene:
-
subscriptionUpgradeData: informazioni sull’upgrade (null se non è disponibile alcun upgrade)
buttonText: testo del pulsante di upgradedefaultSellingPlanId: ID del piano di vendita predefinito per gli upgrade
-
sellingPlansData: opzioni dei piani di vendita disponibili (null se non ci sono piani)
sellingPlanGroups: array di gruppi di piani con i rispettivi piani di venditaactiveSellingPlanId: ID del piano di vendita attualmente selezionatooneTimePurchaseText: testo per l’opzione di acquisto una tantum (null se non disponibile)
- upgradeSellingPlan: funzione per passare a un piano di vendita specifico
- changeSellingPlan: funzione per cambiare il piano di vendita attuale
- getSellingPlanGroupText: funzione di utilità per formattare il testo di visualizzazione del piano di vendita
-
subscriptionUpgradeData: informazioni sull’upgrade (null se non è disponibile alcun upgrade)
onIncrease
-
Tipo:
() => void - Descrizione: funzione per aumentare la quantità dell’articolo
- Utilizzo: gestisci le azioni di aumento della quantità
onDecrease
-
Tipo:
() => void - Descrizione: funzione per diminuire la quantità dell’articolo
- Utilizzo: gestisci le azioni di diminuzione della quantità
onDeleteProduct
-
Tipo:
() => void - Descrizione: funzione per rimuovere l’articolo dal carrello
- Utilizzo: gestisci la rimozione dell’articolo
onQuantityChange
-
Tipo:
(quantity: string) => void - Descrizione: funzione per gestire l’inserimento diretto della quantità
- Utilizzo: gestisci le modifiche manuali della quantità
handleInputChange
-
Tipo:
(e: React.ChangeEvent<HTMLInputElement>) => void - Descrizione: handler di modifica dell’input per il campo quantità
- Utilizzo: gestisci le modifiche del campo di input della quantità
replaceItemWithVariant
-
Tipo:
(variantId: string) => Promise<{ success: boolean }> - Descrizione: funzione per sostituire l’articolo con una variante diversa
- Utilizzo: gestisci il cambio di variante
isLoading
-
Tipo:
boolean - Descrizione: stato di caricamento per le operazioni sul carrello
- Utilizzo: mostra indicatori di caricamento
loadingOperation
-
Tipo:
'increase' | 'decrease' | 'inputChange' | 'remove' | 'subscription' | undefined - Descrizione: operazione specifica attualmente in caricamento
- Utilizzo: mostra stati di caricamento specifici per operazione
setLoadingOperation
-
Tipo:
(op: "increase" | "decrease" | "inputChange" | "remove" | "subscription" | undefined) => void - Descrizione: funzione per impostare lo stato dell’operazione in caricamento
- Utilizzo: gestisci gli stati di caricamento per le diverse operazioni
rawItem
-
Tipo:
CartItem(fai riferimento al tipoCartItemqui sotto) - Descrizione: dati grezzi dell’articolo del carrello contenenti tutte le informazioni
Prop disponibili - Template Variant

item
-
Tipo:
CartItem(fai riferimento al tipoCartItemqui sotto) - Descrizione: dati grezzi dell’articolo del carrello contenenti le informazioni sulla variante
- Utilizzo: accedi ai dettagli della variante dall’articolo del carrello
Prop disponibili - Template Properties

productProperties
-
Tipo:
{ key: string; value: string; isUrl?: boolean; }[] - Descrizione: array delle proprietà del prodotto (campi personalizzati, proprietà della riga d’ordine)
subscriptionLabel
-
Tipo:
string | undefined - Descrizione: etichetta per le informazioni sull’abbonamento
Prop disponibili - Template Bundle

getSizedImageUrl
-
Tipo:
getSizedImageUrl: ({ src, width, height }: SizedImageParams) => string - Descrizione: funzione di utilità per ottenere URL di immagini nella dimensione corretta
item
-
Tipo:
-
Descrizione: informazioni sull’articolo bundle, componenti inclusi.
itemComponentsè un array di oggetti componente — iteralo con map per renderizzare ogni componente del bundle.
showDetailsText
-
Tipo:
string | undefined - Descrizione: testo per l’azione “mostra dettagli”
- Utilizzo: mostra il testo del pulsante di espansione
hideDetailsText
-
Tipo:
string | undefined - Descrizione: testo per l’azione “nascondi dettagli”
isExpanded
-
Tipo:
boolean - Descrizione: se i dettagli del bundle sono espansi
toggleCollapsible
-
Tipo:
() => void - Descrizione: funzione per attivare/disattivare la visibilità dei dettagli del bundle
- Utilizzo: gestisci le azioni di espansione/compressione
chevronDownIconComponent
-
Tipo:
React.ReactElement - Descrizione: icona chevron pre-renderizzata per l’espansione/compressione
- Utilizzo: mostra un indicatore di espansione/compressione coerente
Prop disponibili - Template Price

compareAtPrice
-
Tipo:
string | undefined - Descrizione: prezzo confrontato formattato (prezzo originale)
- Utilizzo: mostra il prezzo originale per gli articoli in saldo
price
-
Tipo:
string - Descrizione: prezzo attuale formattato
- Utilizzo: mostra il prezzo attuale dell’articolo
savings
-
Tipo:
string | undefined - Descrizione: importo del risparmio formattato
- Utilizzo: mostra quanto risparmia il cliente
Proprietà dell’oggetto CartItem
CartItem contiene tutte le informazioni dettagliate su una riga del carrello. Questo oggetto è disponibile come props.rawItem nel template Product Tile e come props.item nel template Variant.
Identificazione principale
-
key (string)- Identificatore univoco di questo articolo del carrello. -
id (number)- ID della variante (campo legacy, usa invece variant_id) -
variant_id (number)- L’ID della variante Shopify per questo articolo -
product_id (number)- L’ID del prodotto Shopify -
lineIdxFrom1 (number)- Indice (a partire da 1) di questo articolo nel carrello originale prima delle modifiche
Informazioni sul prodotto
-
title (string)- Il titolo della riga d’ordine (di solito il titolo della variante) -
product_title (string)- Il titolo principale del prodotto -
handle (string)- Handle dell’URL del prodotto (ad es. “camp-stool”) -
vendor (string)- Nome del fornitore/brand del prodotto -
product_type (string)- Categoria/tipo di prodotto a fini fiscali -
sku (string)- Identificatore SKU (Stock Keeping Unit) -
product_description (string)- Descrizione completa del prodotto -
product_has_only_default_variant (boolean)- Se il prodotto ha una sola variante
Prezzi (tutti i prezzi in centesimi)
-
quantity (number)- Numero di questo articolo nel carrello -
price (number)- Prezzo unitario prima degli sconti -
original_price (number)- Uguale a price -
discounted_price (number)- Prezzo unitario dopo gli sconti a livello di prodotto -
compare_at_price (number | null)- Prezzo confrontato (MSRP). Nota: questo campo è aggiunto da Upcart, non fornito dall’API del carrello di Shopify -
final_line_price (number)- Prezzo totale dopo gli sconti a livello di prodotto (quantity × discounted_price) -
original_line_price (number)- Prezzo totale prima degli sconti (quantity × price) -
line_price (number)- Prezzo totale dopo tutti gli sconti -
final_price (number)- Deprecato - Prezzo unitario dopo gli sconti sul prodotto (non tiene conto della quantità) -
total_discount (number)- Uguale a line_level_total_discount -
line_level_total_discount (number)- Importo totale dello sconto applicato a questa riga
Media e URL
-
image (string)- URL dell’immagine principale del prodotto -
url (string)- Percorso URL relativo alla pagina del prodotto (ad es. “/products/camp-stool?variant=42789611372803”) -
featured_image (object | null)- Dettagli dell’immagine in evidenza:alt (string)- Testo alternativo dell’immagineaspect_ratio (number)- Proporzioni dell’immagineheight (number)- Altezza dell’immagine in pixelurl (string)- URL dell’immaginewidth (number)- Larghezza dell’immagine in pixel
Varianti e opzioni
-
variant_title (string | null)- Titolo della variante (ad es. “Large / Red”) -
variant_options (string[])- Array dei valori delle opzioni della variante -
options_with_values (Array)- Informazioni dettagliate sulle opzioni:name (string)- Nome dell’opzione (ad es. “Size”)value (string)- Valore dell’opzione (ad es. “Large”)
-
untranslated_product_title (string | undefined)- Titolo originale del prodotto prima della traduzione (solo nelle risposte di mutazione del carrello) -
untranslated_variant_title (string | undefined)- Titolo originale della variante prima della traduzione (solo nelle risposte di mutazione del carrello)
Proprietà personalizzate e metadati
-
properties (Record<string, any> | null)- Proprietà personalizzate della riga d’ordine, oppurenullquando la riga non ne ha — verifica prima di leggere una chiave. Le proprietà le cui chiavi iniziano con__sono sempre nascoste ai clienti; anche le chiavi che iniziano con un singolo_sono nascoste quando l’impostazione del carrello Hide properties starting with single underscore ”_” è attiva. -
gift_card (boolean)- Se questo articolo è una carta regalo -
taxable (boolean)- Se questo articolo è soggetto a tasse -
requires_shipping (boolean)- Se questo articolo richiede la spedizione -
grams (number)- Peso dell’articolo in grammi
Sconti e promozioni
-
discounts (Array)- Informazioni semplificate sugli sconti:amount (number)- Importo dello sconto in centesimititle (string)- Titolo/nome dello sconto
-
line_level_discount_allocations (Array)- Informazioni dettagliate sull’allocazione degli sconti:-
amount (number)- Importo dello sconto in centesimi -
discount_application (object)- Dettagli completi dell’applicazione dello sconto:allocation_method (string)- Come viene allocato lo scontocreated_at (string)- Quando è stato creato lo scontodescription (string | null)- Descrizione dello scontokey (string)- Identificatore chiave dello scontotarget_selection (string)- Cosa prende di mira lo scontotarget_type (string)- Tipo di destinazionetitle (string)- Titolo dello scontototal_allocated_amount (number)- Importo totale allocatotype ('discount_code' | '')- Tipo di sconto (stringa vuota per gli sconti automatici)value (string)- Valore dello scontovalue_type (string)- Come viene applicato il valore
-
Prodotti bundle
-
has_components (boolean | undefined)- Se questo articolo è un bundle contenente altri prodotti (solo nelle risposte GET del carrello) -
item_components (Array | null | undefined)- Dettagli dei componenti del bundle:-
quantity (number)- Quantità di questo componente -
image (object)- Immagine del componente:url (string)- URL dell’immagineheight (number | null)- Altezza dell’immaginewidth (number | null)- Larghezza dell’immaginealt (string)- Testo alternativo
-
-
product (object)- Informazioni sul prodotto componente:title (string)- Titolo del prodottohas_only_default_variant (boolean)- Se il prodotto ha solo la variante predefinita
-
variantTitle (string)- Titolo della variante del componente
Regole di business
-
quantity_rule (object | undefined)- Vincoli di quantità (solo nelle risposte GET del carrello):min (number)- Quantità minima consentitamax (number | null)- Quantità massima consentita (null = nessun limite)increment (number)- Passo di incremento della quantità
Informazioni sull’abbonamento
-
selling_plan_allocation (object | undefined)- Dettagli dell’abbonamento/piano di vendita:-
price (number)- Prezzo dell’abbonamento in centesimi -
compare_at_price (number | null)- Prezzo confrontato dell’abbonamento -
per_delivery_price (number)- Prezzo per consegna -
selling_plan (object)- Dettagli del piano di vendita:-
id (number)- ID del piano di vendita -
name (string)- Nome del piano -
description (string)- Descrizione del piano -
options (Array)- Opzioni del piano:name (string)- Nome dell’opzioneposition (number)- Posizione dell’opzionevalue (string)- Valore dell’opzione
-
recurring_deliveries (boolean)- Se il piano prevede consegne ricorrenti
-
-
Metadati di integrazione
-
__appIntegrated (object | undefined)- Dati di integrazione con app di terze parti:app ('stay.ai')- Identificatore dell’app integratabundleRole ('parent' | 'child')- Ruolo nella struttura del bundle
Upsells
Prop disponibili - Template tile upsell

itemUrl
-
Tipo:
string - Descrizione: l’URL della pagina del prodotto
- Utilizzo: crea link alla pagina di dettaglio del prodotto per una migliore navigazione dell’utente
imageUrl
-
Tipo:
string | undefined - Descrizione: l’URL dell’immagine del prodotto
- Utilizzo: mostra le immagini dei prodotti nelle implementazioni di upsell personalizzate
- Fallback: gestisci con eleganza i valori undefined con immagini segnaposto
description
-
Tipo:
string - Descrizione: la descrizione del prodotto
- Utilizzo: mostra la descrizione del prodotto nelle implementazioni di upsell personalizzate
altText
-
Tipo:
string - Descrizione: testo alternativo per l’immagine del prodotto ai fini dell’accessibilità
- Utilizzo: fornisci supporto agli screen reader e migliora la conformità in materia di accessibilità
productId
-
Tipo:
string - Descrizione: l’identificatore univoco del prodotto
- Utilizzo: traccia i prodotti, implementa analytics o usalo nella funzionalità di aggiunta al carrello
productTitle
-
Tipo:
string - Descrizione: il titolo/nome del prodotto
- Utilizzo: mostra il nome del prodotto nelle implementazioni di upsell personalizzate
oldPrice & newPrice
-
Tipo:
string | null(oldPrice),string(newPrice) - Descrizione: prezzo confrontato e prezzo attuale formattati
- Utilizzo: mostra le informazioni sui prezzi con indicatori di saldo
isSingleVariant
-
Tipo:
boolean - Descrizione: indica se il prodotto ha una sola variante
- Utilizzo: renderizza in modo condizionale gli elementi UI di selezione delle varianti
productOptions
-
Tipo:
{ name: string; position: 1 | 2 | 3; values: string[]; }[] - Descrizione: configurazione completa delle opzioni del prodotto, incluse tutte le scelte disponibili
- Utilizzo: accedi alle informazioni dettagliate sulle opzioni del prodotto per interfacce avanzate di selezione delle varianti
variantOptions
-
Tipo:
{ label: string; value: string }[] - Descrizione: opzioni di variante disponibili per il prodotto
- Utilizzo: crea menu a tendina o pulsanti per la selezione delle varianti
- Struttura: ogni opzione contiene un’etichetta di visualizzazione e un identificatore di valore univoco
selectedVariantId & selectedVariantLabel
- Tipo: string (selectedVariantId), string | undefined (selectedVariantLabel)
- Descrizione: ID della variante attualmente selezionata e la sua etichetta di visualizzazione
- Utilizzo: traccia e mostra le informazioni sulla variante selezionata
onVariantChange
-
Tipo:
(variantId: string) => void - Descrizione: funzione per gestire i cambi di selezione della variante
- Utilizzo: aggiorna la variante selezionata quando l’utente effettua una selezione
onAddClick
-
Tipo:
(productId: string, variantId?: string) => void - Descrizione: funzione per gestire l’aggiunta del prodotto al carrello
- Utilizzo: implementa la funzionalità di aggiunta al carrello con la corretta identificazione di prodotto e variante
rating & reviewCount
-
Tipo:
number | undefined(rating),string | undefined(reviewCount) - Descrizione: valutazione del prodotto e testo formattato del conteggio delle recensioni
- Utilizzo: mostra riprova sociale e indicatori di qualità del prodotto
addLoading & addButtonText
-
Tipo:
boolean(addLoading),string(addButtonText) - Descrizione: stato di caricamento per l’azione di aggiunta al carrello e testo del pulsante
- Utilizzo: fornisci feedback all’utente durante le operazioni sul carrello e personalizza il testo del pulsante
cartItemsCount
-
Tipo:
number - Descrizione: il numero attuale di articoli nel carrello
- Utilizzo: mostra lo stato del carrello o implementa logiche basate sul carrello
Additional Notes
Prop disponibili - Template completo

cartNote
-
Tipo:
string - Descrizione: il contenuto attuale della nota del carrello inserita dal cliente
- Utilizzo: mostra e gestisci il testo della nota del carrello nelle implementazioni personalizzate
notesPlaceholder
-
Tipo:
string - Descrizione: testo segnaposto per il campo di input delle note
- Utilizzo: fornisci ai clienti indicazioni su cosa includere nelle loro note
notesTitle
-
Tipo:
string - Descrizione: il testo del titolo/intestazione della sezione delle note
- Utilizzo: mostra il titolo della sezione nelle implementazioni personalizzate delle note
chevronDownIconComponent
-
Tipo:
React.ReactElement - Descrizione: componente icona chevron pre-renderizzato per la funzionalità di espansione/compressione
- Utilizzo: mostra indicatori di espansione/compressione coerenti nelle implementazioni personalizzate
loadingIndicatorComponent
-
Tipo:
React.ReactElement | null - Descrizione: componente indicatore di caricamento pre-renderizzato per le operazioni asincrone
- Utilizzo: mostra stati di caricamento durante le operazioni di salvataggio delle note
handleCartNoteChange
-
Tipo:
(newCartNote: string) => void - Descrizione: funzione per gestire le modifiche al contenuto della nota del carrello
- Utilizzo: aggiorna la nota del carrello quando l’utente modifica il testo
isExpanded
-
Tipo:
boolean - Descrizione: indica se la sezione delle note è attualmente espansa
- Utilizzo: controlla la visibilità dell’area di input delle note
toggleCollapsible
-
Tipo:
() => void - Descrizione: funzione per alternare lo stato espanso/compresso della sezione delle note
- Utilizzo: collegala a pulsanti o elementi interattivi per controllare la visibilità della sezione
Add-ons
Prop disponibili - Template completo

addonProduct
-
Tipo:
- Descrizione: informazioni complete sul prodotto add-on, inclusi dettagli del prodotto, prezzo della variante e dati dell’immagine
- Utilizzo: accedi a tutte le informazioni sul prodotto necessarie per mostrare i prodotti add-on
-
Struttura: contiene oggetti annidati product, variant e image con dati completi sul prodotto
-
Proprietà dell’oggetto Product
addonProduct.product- id: identificatore numerico univoco del prodotto
- title: nome visualizzato del prodotto add-on
- description: contenuto HTML della descrizione del prodotto
-
Proprietà dell’oggetto Variant
- id: identificatore numerico univoco della variante
- price: prezzo attuale in centesimi
- compare_at_price: prezzo originale in centesimi (null se non c’è prezzo di confronto)
-
Proprietà dell’oggetto Image
- src: URL dell’immagine del prodotto
- alt: testo alternativo dell’immagine (per l’accessibilità)
-
Proprietà dell’oggetto Product
toggle
-
Tipo:
- Descrizione: stato del controllo di attivazione e handler per abilitare/disabilitare l’add-on
- Utilizzo: implementa la funzionalità interattiva dell’interruttore per la selezione dell’add-on
- Stati: tre stati possibili - enabled, disabled e loading
- Handler: funzioni separate per le azioni di abilitazione e disabilitazione
moneyFormat
-
Tipo:
string - Descrizione: la stringa di formato valuta usata per la formattazione dei prezzi
- Utilizzo: passala alla funzione formatMoney per una visualizzazione coerente della valuta
formatMoney
-
Tipo:
- Descrizione: funzione di utilità per formattare i valori di valuta
- Utilizzo: formatta i prezzi in modo coerente con le impostazioni di valuta del negozio
- Parametri: accetta il valore in centesimi, una stringa di formato opzionale e un’opzione per la rimozione dell’HTML
Discount Codes
Prop disponibili - Template completo

indicator
-
Tipo:
'validating' | 'invalid' | 'none' - Descrizione: stato di validazione attuale dell’input del codice sconto
- Utilizzo: mostra il feedback UI appropriato in base allo stato di validazione
-
Stati:
validating: il codice è in fase di elaborazione/validazioneinvalid: la validazione del codice è fallitanone: nessuno stato di validazione (predefinito/inattivo)
discountCodeInput
-
Tipo:
string - Descrizione: valore attuale del campo di input del codice sconto
- Utilizzo: mostra e gestisci il testo del codice sconto inserito dall’utente
discountCodePlaceholder
-
Tipo:
string - Descrizione: testo segnaposto per il campo di input del codice sconto
- Utilizzo: fornisci indicazioni agli utenti su cosa inserire nel campo
discountCodeButtonText
-
Tipo:
string - Descrizione: testo da mostrare sul pulsante di applicazione/invio
- Utilizzo: personalizza il testo del pulsante per l’invio del codice sconto
setDiscountCodeInput
-
Tipo:
(value: string | ((prev: string) => string)) => void - Descrizione: funzione per aggiornare il valore dell’input del codice sconto
- Utilizzo: gestisci le modifiche dell’input dell’utente nel campo del codice sconto
handleSubmit
-
Tipo:
(e: React.FormEvent<HTMLFormElement>) => void - Descrizione: funzione per gestire l’invio del modulo per l’applicazione del codice sconto
- Utilizzo: elabora la validazione e l’applicazione del codice sconto
- Evento: gestisce gli eventi di invio del modulo
Cart Summary
Prop disponibili - Template completo

totalSavingsText
-
Tipo:
string - Descrizione: etichetta di testo per la sezione del risparmio totale
- Utilizzo: mostra l’etichetta del risparmio nelle implementazioni personalizzate del riepilogo del carrello
discountApplications
-
Tipo:
- Descrizione: array dei codici sconto applicati e degli sconti automatici
- Utilizzo: mostra tutti gli sconti attivi con i loro titoli e tipi
- Struttura: ogni sconto contiene una chiave univoca, un titolo di visualizzazione e un identificatore di tipo
cartTotalDiscount
-
Tipo:
number - Descrizione: l’importo totale dello sconto in centesimi
- Utilizzo: accedi al valore grezzo dello sconto per calcoli o formattazione personalizzata
showCartTotalDiscount
-
Tipo:
boolean -
Descrizione: indica se lo sconto totale deve essere mostrato. Contrassegnata come deprecata a favore di
showTotalSavings, ma vedi la nota qui sotto — all’interno di un template personalizzato è ancora questa la prop a tua disposizione. - Utilizzo: renderizza in modo condizionale le informazioni sullo sconto in base alle impostazioni
formattedCartTotalDiscount
-
Tipo:
string -
Descrizione: stringa HTML pre-formattata dell’importo totale dello sconto. Contrassegnata come deprecata a favore di
formattedTotalSavings, ma vedi la nota qui sotto. - Utilizzo: mostra l’importo dello sconto correttamente formattato con i simboli di valuta
isRemovingDiscount
-
Tipo:
boolean - Descrizione: indica se è in corso un’operazione di rimozione di uno sconto
- Utilizzo: mostra stati di caricamento durante la rimozione degli sconti
handleRemoveDiscount
-
Tipo:
() => Promise<void> - Descrizione: funzione per gestire la rimozione del codice sconto
- Utilizzo: rimuovi i codici sconto applicati dal carrello
totalCompareAtPrice
-
Tipo:
number - Descrizione: somma dei prezzi confrontati totali (tutti gli articoli nel carrello)
- Utilizzo: calcola e mostra il risparmio o le informazioni sui prezzi originali
totalAfterAllDiscounts
-
Tipo:
number - Descrizione: totale finale del carrello in centesimi dopo l’applicazione di tutti gli sconti
- Utilizzo: mostra il prezzo finale che i clienti pagheranno
originalTotalPrice
-
Tipo:
number - Descrizione: totale originale del carrello in centesimi prima di qualsiasi sconto
- Utilizzo: mostra il prezzo originale per trasparenza e per il calcolo del risparmio
cartItemCount
-
Tipo:
number - Descrizione: numero totale di articoli nel carrello
- Utilizzo: mostra le informazioni sul conteggio degli articoli nei riepiloghi del carrello
Trust Badges
Prop disponibili - Template completo
showBadge
-
Tipo:
boolean - Descrizione: indica se il badge di fiducia deve essere mostrato
- Utilizzo: controlla la visibilità dei badge di fiducia in base alle impostazioni del modulo
badgeUrl
-
Tipo:
string - Descrizione: l’URL dell’immagine del badge di fiducia da mostrare
- Utilizzo: URL sorgente per l’immagine del badge di fiducia nelle implementazioni personalizzate