Skip to main content

⚠️ Avviso importante

I template personalizzati richiedono conoscenze tecniche avanzate di HTML, CSS, JavaScript e React. Assicurati di avere sufficiente esperienza di sviluppo o accesso a uno sviluppatore Shopify qualificato prima di procedere. Il nostro team di supporto non fornirà assistenza per lo sviluppo, il debug o la risoluzione di problemi dei template personalizzati. Le domande tecniche vanno rivolte a uno Shopify Expert o a uno sviluppatore qualificato.

Funzionalità dell’editor di codice

L’editor di codice dei template personalizzati include strumenti integrati per aiutarti a scrivere template validi più facilmente.

IntelliSense TypeScript

L’editor comprende TypeScript, quindi ottieni suggerimenti di completamento automatico, controllo dei tipi e documentazione inline per tutte le 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

L’editor espone solo il corpo JSX modificabile del tuo template — non ci sono righe bloccate. Il wrapper di funzione circostante viene aggiunto automaticamente in fase di build e non viene mai mostrato nell’editor. Usa Reset to default in qualsiasi momento per ripristinare il template originale se le tue modifiche compromettono la struttura del template.

Sezione General

Il modulo Header ti consente di personalizzare l’intestazione del carrello con il tuo design mantenendo le funzionalità essenziali del carrello, come la visualizzazione del numero di articoli e il pulsante di chiusura.

Prop disponibili - Template completo

Intestazione del cart drawer con il titolo Cart, il conteggio degli articoli e il pulsante di chiusura 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

Il modulo Announcements ti consente di personalizzare la visualizzazione degli annunci con il tuo design mantenendo le funzionalità essenziali degli annunci, come i controlli del timer e la visibilità condizionale.

Prop disponibili - Template completo

Barra degli annunci del carrello con un timer per il conto alla rovescia che riserva i prodotti del cliente 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

Il modulo Rewards ti consente di personalizzare la visualizzazione dell’avanzamento dei premi con il tuo design mantenendo le funzionalità essenziali dei premi, come il tracciamento dei traguardi, la visualizzazione dell’avanzamento e i messaggi dei premi.

Prop disponibili - Template completo

Barra di avanzamento dei premi a livelli con le icone dei traguardi di spedizione gratuita e prodotto 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 posizionamento
    • progressPercent: avanzamento attuale come percentuale (0-100)
    • showMilestones: se mostrare gli indicatori dei traguardi
    • settings: configurazione visiva per la visualizzazione dei traguardi

Discounts

Il modulo Discounts supporta i template personalizzati, così puoi progettare la tua visualizzazione mantenendo le funzionalità essenziali come la gestione delle regole, la visibilità della sezione e la presentazione dei premi. L’identificatore interno del tipo di modulo per i template personalizzati è 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 premio
    • title: titolo della regola di sconto
    • description: descrizione della regola del premio
    • conditionsMet: 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

Il modulo Recommendation ti consente di personalizzare la visualizzazione dei prodotti in upsell con il tuo design mantenendo le funzionalità e-commerce essenziali come la selezione delle varianti, le azioni di aggiunta al carrello e la visualizzazione delle informazioni sul prodotto.

Prop disponibili - Template tile raccomandazione

Tile di raccomandazione che mostra uno snowboard con prezzo e pulsante Add Il template del tile di raccomandazione condivide la stessa interfaccia di prop del template del tile di upsell nel modulo Upsells. Tutte le prop disponibili, i tipi e gli esempi d’uso sono documentati nella sezione del modulo Upsells qui sotto.

Cart Items

Il modulo Cart Items ti consente di personalizzare la visualizzazione degli articoli del carrello con il tuo design mantenendo le funzionalità e-commerce essenziali. Questo modulo fornisce diversi tipi di template, ciascuno con le proprie prop specifiche per i vari aspetti della visualizzazione degli articoli del carrello.
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

Nota: abilitare il template Product Tile sovrascriverà tutti gli altri template di questo modulo, inclusi Variant template, Properties template, Bundle template e Price template.
Se vuoi usare codice personalizzato in uno di quei template, devi disattivare il template Product Tile.
Tile di prodotto del carrello con immagine, variante, prezzo scontato, selettore di quantità e pulsante di abbonamento 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 upgrade
      • defaultSellingPlanId: 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 vendita
      • activeSellingPlanId: ID del piano di vendita attualmente selezionato
      • oneTimePurchaseText: 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
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 tipo CartItem qui sotto)
  • Descrizione: dati grezzi dell’articolo del carrello contenenti tutte le informazioni

Prop disponibili - Template Variant

Riga della variante dell'articolo del carrello che mostra la taglia Medium selezionata item
  • Tipo: CartItem (fai riferimento al tipo CartItem qui 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

Riga delle proprietà dell'articolo del carrello che mostra una nota con messaggio regalo 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

Bundle espanso che elenca tre prodotti componenti inclusi con le varianti 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

Prezzo del carrello con il prezzo originale barrato, il prezzo scontato e il risparmio 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

L’oggetto 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’immagine
    • aspect_ratio (number) - Proporzioni dell’immagine
    • height (number) - Altezza dell’immagine in pixel
    • url (string) - URL dell’immagine
    • width (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, oppure null quando 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 centesimi
    • title (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 sconto
      • created_at (string) - Quando è stato creato lo sconto
      • description (string | null) - Descrizione dello sconto
      • key (string) - Identificatore chiave dello sconto
      • target_selection (string) - Cosa prende di mira lo sconto
      • target_type (string) - Tipo di destinazione
      • title (string) - Titolo dello sconto
      • total_allocated_amount (number) - Importo totale allocato
      • type ('discount_code' | '') - Tipo di sconto (stringa vuota per gli sconti automatici)
      • value (string) - Valore dello sconto
      • value_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’immagine
      • height (number | null) - Altezza dell’immagine
      • width (number | null) - Larghezza dell’immagine
      • alt (string) - Testo alternativo
  • product (object) - Informazioni sul prodotto componente:
    • title (string) - Titolo del prodotto
    • has_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 consentita
    • max (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’opzione
        • position (number) - Posizione dell’opzione
        • value (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 integrata
    • bundleRole ('parent' | 'child') - Ruolo nella struttura del bundle

Upsells

Il modulo Upsells ti consente di personalizzare la visualizzazione dei prodotti in upsell con il tuo design mantenendo le funzionalità e-commerce essenziali come la selezione delle varianti, le azioni di aggiunta al carrello e la visualizzazione delle informazioni sul prodotto.

Prop disponibili - Template tile upsell

Tile di upsell che mostra un prodotto con prezzo scontato, menu a tendina delle varianti e pulsante Add 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

Il modulo Notes ti consente di personalizzare la funzionalità delle note del carrello con il tuo design mantenendo le capacità essenziali di annotazione come sezioni espandibili, gestione dell’input di testo e stati di caricamento.

Prop disponibili - Template completo

Sezione delle note del carrello con un campo di testo espandibile per istruzioni speciali 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

Il modulo Addons ti consente di personalizzare la visualizzazione dei prodotti add-on con il tuo design mantenendo le funzionalità e-commerce essenziali come la visualizzazione delle informazioni sul prodotto, i prezzi, i controlli di attivazione e la formattazione della valuta.

Prop disponibili - Template completo

Riga del prodotto add-on che mostra una carta regalo con prezzo e interruttore di attivazione 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à)
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

Il modulo Discount Code ti consente di personalizzare la funzionalità di inserimento dei codici sconto con il tuo design mantenendo le capacità e-commerce essenziali come la validazione del codice, l’invio del modulo e il feedback all’utente.

Prop disponibili - Template completo

Campo di inserimento del codice sconto con un pulsante Apply 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/validazione
    • invalid: la validazione del codice è fallita
    • none: 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

Il modulo Cart Summary ti consente di personalizzare la visualizzazione del riepilogo del carrello e degli sconti con il tuo design mantenendo le funzionalità e-commerce essenziali come la gestione degli sconti, il calcolo del risparmio e la trasparenza dei prezzi.

Prop disponibili - Template completo

Riga di sconto del riepilogo del carrello che mostra un codice sconto applicato e l'importo 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
showTotalSavings e formattedTotalSavings non sono disponibili all’interno di un template personalizzato. Esistono nel contesto interno del modulo, ma al template Cart summary vengono passate solo showCartTotalDiscount e formattedCartTotalDiscount — leggere la coppia più recente restituisce undefined. Usa le due indicate sopra e tieni presente che mostrano solo il totale degli sconti; non seguono l’impostazione Show compare-at price savings in footer total.
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

Il modulo Trust Badges ti consente di personalizzare la visualizzazione dei badge di fiducia con il tuo design mantenendo le funzionalità essenziali per costruire fiducia, come la visibilità condizionale dei badge e la corretta gestione delle immagini.

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