Skip to main content

⚠️ Vigtig meddelelse

Brugerdefinerede skabeloner kræver avanceret teknisk viden om HTML, CSS, JavaScript og React. Sørg for, at du har tilstrækkelig udviklingsekspertise eller adgang til en kvalificeret Shopify-udvikler, før du fortsætter. Vores supportteam yder ikke hjælp til udvikling, debugging eller fejlfinding af brugerdefinerede skabeloner. Tekniske spørgsmål bør rettes til en Shopify-ekspert eller kvalificeret udvikler.

Kodeeditorens funktioner

Kodeeditoren til brugerdefinerede skabeloner indeholder indbyggede værktøjer, der hjælper dig med lettere at skrive gyldige skabeloner.

TypeScript IntelliSense

Editoren forstår TypeScript, så du får autofuldførelsesforslag, typekontrol og inline-dokumentation for alle tilgængelige props, mens du skriver. Prop-typehjælpen er IntelliSense, der kun findes i editoren, for at hjælpe dig med at skrive skabeloner — det er ikke noget, du skriver ind i skabelonen, og det kører aldrig på din webshop.

Redigerbar skabelonkrop

Editoren viser kun den redigerbare JSX-krop af din skabelon — der er ingen låste linjer. Den omgivende funktionswrapper tilføjes automatisk ved build-tid og vises aldrig i editoren. Brug Reset to default når som helst for at gendanne den oprindelige skabelon, hvis dine redigeringer ødelægger skabelonstrukturen.

General-sektionen

Header-modulet giver dig mulighed for at tilpasse kurvens header med dit eget design, samtidig med at essentiel kurvfunktionalitet som visning af vareantal og en lukkeknap bevares.

Tilgængelige props - Fuld skabelon

Kurvskuffens header med kurvtitlen, vareantal og lukkeknap cartQuantity
  • Type: string
  • Beskrivelse: Det aktuelle antal varer i kurven, formateret som en streng
  • Anvendelse: Vis kurvens vareantal i dit brugerdefinerede header-design
closeHandler
  • Type: () => void
  • Beskrivelse: En callback-funktion, der lukker kurven, når den udløses
  • Anvendelse: Knyt til knapper, ikoner eller andre interaktive elementer for at lukke kurven
titleComponent
  • Type: React.ReactElement | null
  • Beskrivelse: En forudrenderet titelkomponent til kurvens header, som inkluderer korrekt styling og oversættelser
  • Anvendelse: Vis kurvtitlen baseret på konfigurationen af dine kurvindstillinger

Body-sektionen

Meddelelser

Announcements-modulet giver dig mulighed for at tilpasse visningen af meddelelser med dit eget design, samtidig med at essentiel meddelelsesfunktionalitet som timerstyring og betinget synlighed bevares.

Tilgængelige props - Fuld skabelon

Kurvens meddelelsesbar med en nedtællingstimer, der reserverer kundens produkter announcementTemplate
  • Type: string
  • Beskrivelse: HTML-indholdet til meddelelsesbeskeden
  • Anvendelse: Vis meddelelsesbeskeden i dine brugerdefinerede implementeringer
timer
  • Type: string
  • Beskrivelse: Den aktuelle timerværdi formateret som en streng
  • Anvendelse: Vis nedtællingstimer i brugerdefinerede meddelelsesimplementeringer
shouldUseTimer
  • Type: boolean
  • Beskrivelse: Angiver, om timerfunktionaliteten er aktiveret for denne meddelelse
  • Anvendelse: Rendér betinget timerrelateret indhold og kontroller
isTimerExpiredAndShouldHide
  • Type: boolean
  • Beskrivelse: Angiver, om timeren er udløbet, og meddelelsen skal skjules
  • Anvendelse: Styr synligheden af hele meddelelsen baseret på timertilstanden

Trinvise belønninger

Rewards-modulet giver dig mulighed for at tilpasse visningen af belønningsfremskridt med dit eget design, samtidig med at essentiel belønningsfunktionalitet som milepælssporing, visualisering af fremskridt og belønningsbeskeder bevares.

Tilgængelige props - Fuld skabelon

Fremskridtsbjælke for trinvise belønninger med milepælsikoner for gratis fragt og produkt rewardsMessageHtml
  • Type: string
  • Beskrivelse: HTML-indholdet til belønningsbeskeden
  • Anvendelse: Vis belønningsbeskeden med rig formatering i brugerdefinerede implementeringer
milestonesCompleted
  • Type: number
  • Beskrivelse: Antallet af milepæle, der er fuldført
  • Anvendelse: Vis antal fuldførte eller beregn fuldførelsesprocent
milestonesData
  • Type:
  • Beskrivelse: Komplet milepælskonfiguration og fremskridtsdata for belønningssystemet
  • Anvendelse: Få adgang til milepælsinformation, fremskridtsprocent og visningsindstillinger
  • Egenskaber:
    • milestonesToRender: Array af milepælsobjekter med fuldførelsesstatus og placering
    • progressPercent: Aktuelt fremskridt som en procentdel (0-100)
    • showMilestones: Om milepælsmarkører skal vises
    • settings: Visuel konfiguration af milepælsvisningen

Rabatter

Discounts-modulet understøtter brugerdefinerede skabeloner, så du kan designe din egen visning, samtidig med at essentiel funktionalitet som regelstyring, sektionssynlighed og belønningspræsentation bevares. Modulets interne typeidentifikator for brugerdefinerede skabeloner er TRIGGERED_REWARDS af hensyn til bagudkompatibilitet med eksisterende brugerdefineret skabelonkode.

Tilgængelige props - Fuld skabelon

rules
  • Type:
  • Beskrivelse: Array af Discount-regler, der i øjeblikket er aktiveret
  • Anvendelse: Vis tilgængelige belønninger, deres titler, beskrivelser, og om hver regels betingelser er opfyldt
  • Egenskaber:
    • id: Unik identifikator for belønningsreglen
    • title: Titel på Discount-reglen
    • description: Beskrivelse af belønningsreglen
    • conditionsMet: Om reglens betingelser i øjeblikket er opfyldt af kurven. Brug dette til at bygge UX-mønstre som “du har låst X op” vs. “brug $Y mere for at låse X op”
showSection
  • Type: boolean
  • Beskrivelse: Angiver, om Discounts-sektionen skal vises
  • Anvendelse: Styr synligheden af hele Discounts-modulet
onToggleSection
  • Type: () => void
  • Beskrivelse: En callback-funktion, der skifter synlighedstilstanden for Discounts-sektionen
  • Anvendelse: Knyt til knapper eller interaktive elementer for at lade brugere vise/skjule belønningssektionen

Anbefalinger

Recommendation-modulet giver dig mulighed for at tilpasse visningen af upsell-produkter med dit eget design, samtidig med at essentiel e-handelsfunktionalitet som variantvalg, læg-i-kurv-handlinger og visning af produktinformation bevares.

Tilgængelige props - Anbefalingsflise-skabelon

Anbefalingsflise, der viser et snowboard-produkt med pris og Add-knap Anbefalingsflise-skabelonen deler samme prop-interface som upsell-flise-skabelonen i Upsells-modulet. Alle tilgængelige props, typer og anvendelseseksempler er dokumenteret i Upsells-modulsektionen nedenfor.

Kurvvarer

Cart Items-modulet giver dig mulighed for at tilpasse visningen af kurvvarer med dit eget design, samtidig med at essentiel e-handelsfunktionalitet bevares. Dette modul tilbyder flere skabelontyper, hver med deres egne specifikke props til forskellige aspekter af visningen af kurvvarer.
Visning af en indlæsningsindikator under læg-i-kurv eller kurvopdateringer: Standard Cart Items-modulet eksponerer ikke en indbygget “tilføjer til kurv”-spinner. Hvis du vil vise en indlæsningstilstand, mens en vare tilføjes, eller en kurvoperation er i gang, skal du bruge produktflise-skabelonen og læse props’ene isLoading og loadingOperation (dokumenteret nedenfor) for betinget at rendere en spinner eller et overlay. Brugerdefinerede skabeloner kræver udviklererfaring — se meddelelsen øverst på denne side.

Tilgængelige props - Produktflise-skabelon

Bemærk: Aktivering af Product Tile-skabelonen tilsidesætter alle andre skabeloner i dette modul, herunder Variant template, Properties template, Bundle template og Price template.
Hvis du vil bruge brugerdefineret kode i nogen af disse skabeloner, skal du slå Product Tile-skabelonen fra.
Produktflise i kurven med billede, variant, tilbudspris, antalsvælger og abonnér-knap title
  • Type: string
  • Beskrivelse: Produktets titel/navn
  • Anvendelse: Vis det primære produktnavn i kurvvarer
variant
  • Type: React.ReactNode
  • Beskrivelse: Forudrenderet variantinformationskomponent
  • Anvendelse: Vis variantdetaljer som en React-komponent
properties
  • Type: React.ReactNode
  • Beskrivelse: Forudrenderet produktegenskabskomponent
  • Anvendelse: Vis produktegenskaber og abonnementsinfo som en React-komponent
bundle
  • Type: React.ReactNode
  • Beskrivelse: Forudrenderet komponent med bundle-detaljer
  • Anvendelse: Vis bundle-information som en React-komponent
compareAtPrice
  • Type: string | undefined
  • Beskrivelse: Formateret sammenligningspris (oprindelig pris)
  • Anvendelse: Vis oprindelig pris for tilbudsvarer
price
  • Type: string
  • Beskrivelse: Formateret aktuel pris
  • Anvendelse: Vis varens aktuelle pris
savings
  • Type: string | undefined
  • Beskrivelse: Formateret besparelsesbeløb
  • Anvendelse: Vis, hvor meget kunden sparer
imageUrl
  • Type: string | undefined
  • Beskrivelse: URL til produktbillede
  • Anvendelse: Vis produktbillede
productUrl
  • Type: string | undefined
  • Beskrivelse: URL til produktside
  • Anvendelse: Link til produktdetaljesiden
quantity
  • Type: number
  • Beskrivelse: Varens aktuelle antal i kurven
  • Anvendelse: Vis og administrér vareantal
showQuantitySelector
  • Type: boolean
  • Beskrivelse: Om antalskontroller skal vises
  • Anvendelse: Vis antalsvælgeren betinget
discountCodes
  • Type: string[] | undefined
  • Beskrivelse: Array af anvendte rabatkoder for denne vare
  • Anvendelse: Vis varespecifikke rabatter
subscription
  • Type:
  • Beskrivelse: Komplet objekt til abonnementsstyring med opgraderingsdata, salgsplaner og handlerfunktioner
  • Anvendelse: Administrér abonnementsfunktionalitet
  • Subscription-objektet indeholder:
    • subscriptionUpgradeData: Opgraderingsinformation (null, hvis ingen opgradering er tilgængelig)
      • buttonText: Tekst til opgraderingsknappen
      • defaultSellingPlanId: ID for standardsalgsplanen til opgraderinger
    • sellingPlansData: Tilgængelige salgsplansmuligheder (null, hvis ingen planer)
      • sellingPlanGroups: Array af plangrupper med deres salgsplaner
      • activeSellingPlanId: ID for den aktuelt valgte salgsplan
      • oneTimePurchaseText: Tekst til engangskøbsmuligheden (null, hvis ikke tilgængelig)
    • upgradeSellingPlan: Funktion til at opgradere til en specifik salgsplan
    • changeSellingPlan: Funktion til at ændre den aktuelle salgsplan
    • getSellingPlanGroupText: Hjælpefunktion til at formatere visningsteksten for salgsplaner
onIncrease
  • Type: () => void
  • Beskrivelse: Funktion til at øge vareantallet
  • Anvendelse: Håndtér handlinger til forøgelse af antal
onDecrease
  • Type: () => void
  • Beskrivelse: Funktion til at mindske vareantallet
  • Anvendelse: Håndtér handlinger til formindskelse af antal
onDeleteProduct
  • Type: () => void
  • Beskrivelse: Funktion til at fjerne varen fra kurven
  • Anvendelse: Håndtér fjernelse af varer
onQuantityChange
  • Type: (quantity: string) => void
  • Beskrivelse: Funktion til at håndtere direkte antalsinput
  • Anvendelse: Håndtér manuelle antalsændringer
handleInputChange
  • Type: (e: React.ChangeEvent<HTMLInputElement>) => void
  • Beskrivelse: Inputændringshandler til antalsfeltet
  • Anvendelse: Håndtér ændringer i antalsinputfeltet
replaceItemWithVariant
  • Type: (variantId: string) => Promise<{ success: boolean }>
  • Beskrivelse: Funktion til at erstatte varen med en anden variant
  • Anvendelse: Håndtér variantskift
isLoading
  • Type: boolean
  • Beskrivelse: Indlæsningstilstand for kurvoperationer
  • Anvendelse: Vis indlæsningsindikatorer
loadingOperation
  • Type: 'increase' | 'decrease' | 'inputChange' | 'remove' | 'subscription' | undefined
  • Beskrivelse: Den specifikke operation, der indlæses i øjeblikket
  • Anvendelse: Vis operationsspecifikke indlæsningstilstande
setLoadingOperation
  • Type: (op: "increase" | "decrease" | "inputChange" | "remove" | "subscription" | undefined) => void
  • Beskrivelse: Funktion til at sætte tilstanden for indlæsningsoperationen
  • Anvendelse: Administrér indlæsningstilstande for forskellige operationer
rawItem
  • Type: CartItem (Se CartItem-typen nedenfor)
  • Beskrivelse: Rå kurvvaredata, der indeholder al information

Tilgængelige props - Variantskabelon

Kurvvarens variantlinje, der viser den valgte størrelse Medium item
  • Type: CartItem (Se CartItem-typen nedenfor)
  • Beskrivelse: Rå kurvvaredata, der indeholder variantinformation
  • Anvendelse: Få adgang til variantdetaljer fra kurvvaren

Tilgængelige props - Egenskabsskabelon

Kurvvarens egenskabslinje, der viser en gavebeskedsnote productProperties
  • Type: { key: string; value: string; isUrl?: boolean; }[]
  • Beskrivelse: Array af produktegenskaber (brugerdefinerede felter, linjevareegenskaber)
subscriptionLabel
  • Type: string | undefined
  • Beskrivelse: Etiket til abonnementsinformation

Tilgængelige props - Bundle-skabelon

Udvidet bundle, der viser tre inkluderede komponentprodukter med varianter getSizedImageUrl
  • Type: getSizedImageUrl: ({ src, width, height }: SizedImageParams) => string
  • Beskrivelse: Hjælpefunktion til at hente korrekt dimensionerede billed-URL’er
item
  • Type:
  • Beskrivelse: Bundle-vareinformation inklusive komponenter. itemComponents er et array af komponentobjekter — map over det for at rendere hver bundlet komponent.
showDetailsText
  • Type: string | undefined
  • Beskrivelse: Tekst til “vis detaljer”-handlingen
  • Anvendelse: Vis udvidknappens tekst
hideDetailsText
  • Type: string | undefined
  • Beskrivelse: Tekst til “skjul detaljer”-handlingen
isExpanded
  • Type: boolean
  • Beskrivelse: Om bundle-detaljerne er udvidet
toggleCollapsible
  • Type: () => void
  • Beskrivelse: Funktion til at skifte synligheden af bundle-detaljer
  • Anvendelse: Håndtér udvid/sammenfold-handlinger
chevronDownIconComponent
  • Type: React.ReactElement
  • Beskrivelse: Forudrenderet chevron-ikon til udvid/sammenfold
  • Anvendelse: Vis en ensartet udvid/sammenfold-indikator

Tilgængelige props - Prisskabelon

Kurvpris, der viser den oprindelige pris gennemstreget med tilbudspris og besparelser compareAtPrice
  • Type: string | undefined
  • Beskrivelse: Formateret sammenligningspris (oprindelig pris)
  • Anvendelse: Vis oprindelig pris for tilbudsvarer
price
  • Type: string
  • Beskrivelse: Formateret aktuel pris
  • Anvendelse: Vis varens aktuelle pris
savings
  • Type: string | undefined
  • Beskrivelse: Formateret besparelsesbeløb
  • Anvendelse: Vis, hvor meget kunden sparer

CartItem-objektets egenskaber

CartItem-objektet indeholder al detaljeret information om en kurvlinjevare. Dette objekt er tilgængeligt som props.rawItem i produktflise-skabelonen og props.item i variantskabelonen.

Kerneidentifikation

  • key (string) - Unik identifikator for denne kurvvare.
  • id (number) - Variant-ID (ældre felt, brug variant_id i stedet)
  • variant_id (number) - Shopify-variant-ID’et for denne vare
  • product_id (number) - Shopify-produkt-ID’et
  • lineIdxFrom1 (number) - 1-baseret indeks for denne vare i den oprindelige kurv før ændringer

Produktinformation

  • title (string) - Linjevarens titel (normalt varianttitlen)
  • product_title (string) - Produktets hovedtitel
  • handle (string) - Produktets URL-handle (f.eks. “camp-stool”)
  • vendor (string) - Produktets leverandør-/brandnavn
  • product_type (string) - Produktkategori/-type til skatteformål
  • sku (string) - SKU-identifikator (Stock Keeping Unit)
  • product_description (string) - Fuld produktbeskrivelse
  • product_has_only_default_variant (boolean) - Om produktet kun har én variant

Priser (alle priser i cents)

  • quantity (number) - Antal af denne vare i kurven
  • price (number) - Enhedspris før rabatter
  • original_price (number) - Samme som price
  • discounted_price (number) - Enhedspris efter rabatter på produktniveau
  • compare_at_price (number | null) - Sammenligningspris (MSRP). Bemærk: Dette felt tilføjes af Upcart og leveres ikke af Shopifys kurv-API
  • final_line_price (number) - Samlet pris efter rabatter på produktniveau (quantity × discounted_price)
  • original_line_price (number) - Samlet pris før rabatter (quantity × price)
  • line_price (number) - Samlet pris efter alle rabatter
  • final_price (number) - Forældet - Enhedspris efter produktrabatter (tager ikke højde for antal)
  • total_discount (number) - Samme som line_level_total_discount
  • line_level_total_discount (number) - Samlet rabatbeløb anvendt på denne linjevare

Medier & URL’er

  • image (string) - URL til det primære produktbillede
  • url (string) - Relativ URL-sti til produktsiden (f.eks. “/products/camp-stool?variant=42789611372803”)
  • featured_image (object | null) - Detaljer om det fremhævede billede:
    • alt (string) - Billedets alt-tekst
    • aspect_ratio (number) - Billedets billedformat
    • height (number) - Billedhøjde i pixels
    • url (string) - Billed-URL
    • width (number) - Billedbredde i pixels

Varianter & muligheder

  • variant_title (string | null) - Varianttitel (f.eks. “Large / Red”)
  • variant_options (string[]) - Array af variantmulighedernes værdier
  • options_with_values (Array) - Detaljeret information om muligheder:
    • name (string) - Mulighedens navn (f.eks. “Size”)
    • value (string) - Mulighedens værdi (f.eks. “Large”)
  • untranslated_product_title (string | undefined) - Oprindelig produkttitel før oversættelse (kun i kurvmutationssvar)
  • untranslated_variant_title (string | undefined) - Oprindelig varianttitel før oversættelse (kun i kurvmutationssvar)

Brugerdefinerede egenskaber & metadata

  • properties (Record<string, any> | null) - Brugerdefinerede linjevareegenskaber, eller null når linjen ikke har nogen — tjek, før du læser en nøgle. Egenskaber, hvis nøgler starter med __, er altid skjult for kunder; nøgler, der starter med en enkelt _, skjules også, når kurvindstillingen Hide properties starting with single underscore ”_” er slået til.
  • gift_card (boolean) - Om denne vare er et gavekort
  • taxable (boolean) - Om denne vare er momspligtig
  • requires_shipping (boolean) - Om denne vare kræver forsendelse
  • grams (number) - Varens vægt i gram

Rabatter & kampagner

  • discounts (Array) - Forenklet rabatinformation:
    • amount (number) - Rabatbeløb i cents
    • title (string) - Rabattens titel/navn
  • line_level_discount_allocations (Array) - Detaljeret information om rabatallokering:
    • amount (number) - Rabatbeløb i cents
    • discount_application (object) - Fulde detaljer om rabatanvendelsen:
      • allocation_method (string) - Hvordan rabatten allokeres
      • created_at (string) - Hvornår rabatten blev oprettet
      • description (string | null) - Rabatbeskrivelse
      • key (string) - Rabatnøgle-identifikator
      • target_selection (string) - Hvad rabatten målretter
      • target_type (string) - Måltype
      • title (string) - Rabattitel
      • total_allocated_amount (number) - Samlet allokeret beløb
      • type ('discount_code' | '') - Rabattype (tom streng for automatiske rabatter)
      • value (string) - Rabatværdi
      • value_type (string) - Hvordan værdien anvendes

Bundle-produkter

  • has_components (boolean | undefined) - Om denne vare er en bundle, der indeholder andre produkter (kun GET-kurvsvar)
  • item_components (Array | null | undefined) - Detaljer om bundle-komponenter:
    • quantity (number) - Antal af denne komponent
    • image (object) - Komponentbillede:
      • url (string) - Billed-URL
      • height (number | null) - Billedhøjde
      • width (number | null) - Billedbredde
      • alt (string) - Alt-tekst
  • product (object) - Komponentens produktinfo:
    • title (string) - Produkttitel
    • has_only_default_variant (boolean) - Om produktet kun har standardvarianten
  • variantTitle (string) - Komponentens varianttitel

Forretningsregler

  • quantity_rule (object | undefined) - Antalsbegrænsninger (kun GET-kurvsvar):
    • min (number) - Mindste tilladte antal
    • max (number | null) - Største tilladte antal (null = ingen grænse)
    • increment (number) - Trinstørrelse for antal

Abonnementsinformation

  • selling_plan_allocation (object | undefined) - Detaljer om abonnement/salgsplan:
    • price (number) - Abonnementspris i cents
    • compare_at_price (number | null) - Abonnementets sammenligningspris
    • per_delivery_price (number) - Pris pr. levering
    • selling_plan (object) - Salgsplansdetaljer:
      • id (number) - Salgsplan-ID
      • name (string) - Planens navn
      • description (string) - Planens beskrivelse
      • options (Array) - Planens muligheder:
        • name (string) - Mulighedens navn
        • position (number) - Mulighedens position
        • value (string) - Mulighedens værdi
      • recurring_deliveries (boolean) - Om planen har tilbagevendende leveringer

Integrationsmetadata

  • __appIntegrated (object | undefined) - Integrationsdata fra tredjepartsapps:
    • app ('stay.ai') - Identifikator for den integrerede app
    • bundleRole ('parent' | 'child') - Rolle i bundle-strukturen

Upsells

Upsells-modulet giver dig mulighed for at tilpasse visningen af upsell-produkter med dit eget design, samtidig med at essentiel e-handelsfunktionalitet som variantvalg, læg-i-kurv-handlinger og visning af produktinformation bevares.

Tilgængelige props - Upsell-flise-skabelon

Upsell-flise, der viser et produkt med tilbudspris, variant-dropdown og Add-knap itemUrl
  • Type: string
  • Beskrivelse: URL’en til produktsiden
  • Anvendelse: Opret links til produktdetaljesiden for forbedret brugernavigation
imageUrl
  • Type: string | undefined
  • Beskrivelse: URL’en til produktbilledet
  • Anvendelse: Vis produktbilleder i brugerdefinerede upsell-implementeringer
  • Fallback: Håndtér undefined-værdier elegant med pladsholderbilleder
description
  • Type: string
  • Beskrivelse: Produktets beskrivelse
  • Anvendelse: Vis produktbeskrivelsen i brugerdefinerede upsell-implementeringer
altText
  • Type: string
  • Beskrivelse: Alt-tekst til produktbilledet af hensyn til tilgængelighed
  • Anvendelse: Giv understøttelse af skærmlæsere og forbedr overholdelse af tilgængelighedskrav
productId
  • Type: string
  • Beskrivelse: Den unikke identifikator for produktet
  • Anvendelse: Spor produkter, implementér analytics, eller brug i læg-i-kurv-funktionalitet
productTitle
  • Type: string
  • Beskrivelse: Produktets titel/navn
  • Anvendelse: Vis produktnavnet i brugerdefinerede upsell-implementeringer
oldPrice & newPrice
  • Type: string | null (oldPrice), string (newPrice)
  • Beskrivelse: Formateret sammenligningspris og aktuel pris
  • Anvendelse: Vis prisinformation med tilbudsindikatorer
isSingleVariant
  • Type: boolean
  • Beskrivelse: Angiver, om produktet kun har én variant
  • Anvendelse: Rendér betinget UI-elementer til variantvalg
productOptions
  • Type: { name: string; position: 1 | 2 | 3; values: string[]; }[]
  • Beskrivelse: Komplet konfiguration af produktmuligheder inklusive alle tilgængelige valg
  • Anvendelse: Få adgang til detaljeret information om produktmuligheder til avanceret UI for variantvalg
variantOptions
  • Type: { label: string; value: string }[]
  • Beskrivelse: Tilgængelige variantmuligheder for produktet
  • Anvendelse: Opret dropdowns eller knapper til variantvalg
  • Struktur: Hver mulighed indeholder en visningsetiket og en unik værdi-identifikator
selectedVariantId & selectedVariantLabel
  • Type: string (selectedVariantId), string | undefined (selectedVariantLabel)
  • Beskrivelse: Det aktuelt valgte variant-ID og dets visningsetiket
  • Anvendelse: Spor og vis information om den valgte variant
onVariantChange
  • Type: (variantId: string) => void
  • Beskrivelse: Funktion til at håndtere ændringer i variantvalg
  • Anvendelse: Opdatér den valgte variant, når brugeren foretager et valg
onAddClick
  • Type: (productId: string, variantId?: string) => void
  • Beskrivelse: Funktion til at håndtere tilføjelse af produktet til kurven
  • Anvendelse: Implementér læg-i-kurv-funktionalitet med korrekt produkt- og variantidentifikation
rating & reviewCount
  • Type: number | undefined (rating), string | undefined (reviewCount)
  • Beskrivelse: Produktbedømmelse og formateret tekst med antal anmeldelser
  • Anvendelse: Vis social proof og indikatorer for produktkvalitet
addLoading & addButtonText
  • Type: boolean (addLoading), string (addButtonText)
  • Beskrivelse: Indlæsningstilstand for læg-i-kurv-handlingen og knaptekst
  • Anvendelse: Giv brugerfeedback under kurvoperationer og tilpas knapteksten
cartItemsCount
  • Type: number
  • Beskrivelse: Det aktuelle antal varer i kurven
  • Anvendelse: Vis kurvstatus eller implementér kurvbaseret logik

Yderligere noter

Notes-modulet giver dig mulighed for at tilpasse kurvnotefunktionaliteten med dit eget design, samtidig med at essentielle notefunktioner som udvidelige sektioner, håndtering af tekstinput og indlæsningstilstande bevares.

Tilgængelige props - Fuld skabelon

Kurvens notesektion med et udvideligt tekstfelt til særlige instruktioner cartNote
  • Type: string
  • Beskrivelse: Det aktuelle kurvnoteindhold indtastet af kunden
  • Anvendelse: Vis og administrér kurvnoteteksten i brugerdefinerede implementeringer
notesPlaceholder
  • Type: string
  • Beskrivelse: Pladsholdertekst til noteinputfeltet
  • Anvendelse: Giv kunder vejledning om, hvad de skal inkludere i deres noter
notesTitle
  • Type: string
  • Beskrivelse: Titlen/overskriften til notesektionen
  • Anvendelse: Vis sektionens titel i brugerdefinerede noteimplementeringer
chevronDownIconComponent
  • Type: React.ReactElement
  • Beskrivelse: Forudrenderet chevron-ikonkomponent til udvid/sammenfold-funktionalitet
  • Anvendelse: Vis ensartede udvid/sammenfold-indikatorer i brugerdefinerede implementeringer
loadingIndicatorComponent
  • Type: React.ReactElement | null
  • Beskrivelse: Forudrenderet indlæsningsindikatorkomponent til asynkrone operationer
  • Anvendelse: Vis indlæsningstilstande under gemning af noter
handleCartNoteChange
  • Type: (newCartNote: string) => void
  • Beskrivelse: Funktion til at håndtere ændringer i kurvnotens indhold
  • Anvendelse: Opdatér kurvnoten, når brugeren ændrer teksten
isExpanded
  • Type: boolean
  • Beskrivelse: Angiver, om notesektionen i øjeblikket er udvidet
  • Anvendelse: Styr synligheden af noteinputområdet
toggleCollapsible
  • Type: () => void
  • Beskrivelse: Funktion til at skifte mellem udvidet/sammenfoldet tilstand for notesektionen
  • Anvendelse: Knyt til knapper eller interaktive elementer for at styre sektionens synlighed

Tilkøb

Addons-modulet giver dig mulighed for at tilpasse visningen af tilkøbsprodukter med dit eget design, samtidig med at essentiel e-handelsfunktionalitet som visning af produktinformation, priser, toggle-kontroller og valutaformatering bevares.

Tilgængelige props - Fuld skabelon

Tilkøbsproduktrække, der viser et gavekort med pris og aktiveringstoggle addonProduct
  • Type:
  • Beskrivelse: Komplet information om tilkøbsproduktet inklusive produktdetaljer, variantpriser og billeddata
  • Anvendelse: Få adgang til al produktinformation, der er nødvendig for at vise tilkøbsprodukter
  • Struktur: Indeholder indlejrede product-, variant- og image-objekter med omfattende produktdata
    • Product-objektets egenskaber addonProduct.product
      • id: Unik numerisk identifikator for produktet
      • title: Visningsnavn for tilkøbsproduktet
      • description: Produktets HTML-beskrivelsesindhold
    • Variant-objektets egenskaber
      • id: Unik numerisk identifikator for varianten
      • price: Aktuel pris i cents
      • compare_at_price: Oprindelig pris i cents (null, hvis der ikke er nogen sammenligningspris)
    • Image-objektets egenskaber
      • src: URL til produktbilledet
      • alt: Alt-tekst til billedet (af hensyn til tilgængelighed)
toggle
  • Type:
  • Beskrivelse: Toggle-kontrollens tilstand og handlers til aktivering/deaktivering af tilkøbet
  • Anvendelse: Implementér interaktiv toggle-funktionalitet til valg af tilkøb
  • Tilstande: Tre mulige tilstande - enabled, disabled og loading
  • Handlers: Separate funktioner til aktiverings- og deaktiveringshandlinger
moneyFormat
  • Type: string
  • Beskrivelse: Valutaformatstrengen, der bruges til prisformatering
  • Anvendelse: Send til formatMoney-funktionen for ensartet valutavisning
formatMoney
  • Type:
  • Beskrivelse: Hjælpefunktion til formatering af valutaværdier
  • Anvendelse: Formatér priser konsistent med butikkens valutaindstillinger
  • Parametre: Tager cents-værdi, valgfri formatstreng og en mulighed for HTML-fjernelse

Rabatkoder

Discount Code-modulet giver dig mulighed for at tilpasse funktionaliteten til rabatkodeinput med dit eget design, samtidig med at essentielle e-handelsfunktioner som kodevalidering, formularindsendelse og brugerfeedback bevares.

Tilgængelige props - Fuld skabelon

Rabatkodeinputfelt med en Apply-knap indicator
  • Type: 'validating' | 'invalid' | 'none'
  • Beskrivelse: Den aktuelle valideringstilstand for rabatkodeinputtet
  • Anvendelse: Vis passende UI-feedback baseret på valideringsstatus
  • Tilstande:
    • validating: Koden behandles/valideres
    • invalid: Kodevalideringen mislykkedes
    • none: Ingen valideringstilstand (standard/inaktiv)
discountCodeInput
  • Type: string
  • Beskrivelse: Den aktuelle værdi i rabatkodeinputfeltet
  • Anvendelse: Vis og administrér rabatkodeteksten indtastet af brugeren
discountCodePlaceholder
  • Type: string
  • Beskrivelse: Pladsholdertekst til rabatkodeinputfeltet
  • Anvendelse: Giv brugere vejledning om, hvad de skal indtaste i feltet
discountCodeButtonText
  • Type: string
  • Beskrivelse: Tekst, der skal vises på anvend/indsend-knappen
  • Anvendelse: Tilpas knapteksten til indsendelse af rabatkoder
setDiscountCodeInput
  • Type: (value: string | ((prev: string) => string)) => void
  • Beskrivelse: Funktion til at opdatere rabatkodeinputtets værdi
  • Anvendelse: Håndtér brugerens inputændringer i rabatkodefeltet
handleSubmit
  • Type: (e: React.FormEvent<HTMLFormElement>) => void
  • Beskrivelse: Funktion til at håndtere formularindsendelse for anvendelse af rabatkoder
  • Anvendelse: Behandl validering og anvendelse af rabatkoder
  • Event: Håndterer formularindsendelses-events

Kurvoversigt

Cart Summary-modulet giver dig mulighed for at tilpasse visningen af kurvoversigt og rabatter med dit eget design, samtidig med at essentiel e-handelsfunktionalitet som rabatstyring, besparelsesberegning og prisgennemsigtighed bevares.

Tilgængelige props - Fuld skabelon

Kurvoversigtens rabatrække, der viser en anvendt rabatkode og beløb totalSavingsText
  • Type: string
  • Beskrivelse: Tekstetiket til sektionen med samlede besparelser
  • Anvendelse: Vis besparelsesetiketten i brugerdefinerede kurvoversigtsimplementeringer
discountApplications
  • Type:
  • Beskrivelse: Array af anvendte rabatkoder og automatiske rabatter
  • Anvendelse: Vis alle aktive rabatter med deres titler og typer
  • Struktur: Hver rabat indeholder en unik nøgle, visningstitel og typeidentifikator
cartTotalDiscount
  • Type: number
  • Beskrivelse: Det samlede rabatbeløb i cents
  • Anvendelse: Få adgang til den rå rabatværdi til beregninger eller brugerdefineret formatering
showCartTotalDiscount
  • Type: boolean
  • Beskrivelse: Angiver, om den samlede rabat skal vises. Markeret som forældet til fordel for showTotalSavings, men se noten nedenfor — inde i en brugerdefineret skabelon er dette stadig den prop, du har.
  • Anvendelse: Rendér betinget rabatinformation baseret på indstillinger
formattedCartTotalDiscount
  • Type: string
  • Beskrivelse: Forudformateret HTML-streng med det samlede rabatbeløb. Markeret som forældet til fordel for formattedTotalSavings, men se noten nedenfor.
  • Anvendelse: Vis et korrekt formateret rabatbeløb med valutasymboler
showTotalSavings og formattedTotalSavings er ikke tilgængelige inde i en brugerdefineret skabelon. De findes i modulets interne kontekst, men Cart summary-skabelonen får kun showCartTotalDiscount og formattedCartTotalDiscount — læsning af det nyere par returnerer undefined. Brug de to ovenfor, og bemærk, at de kun viser rabattotalen; de følger ikke indstillingen Show compare-at price savings in footer total.
isRemovingDiscount
  • Type: boolean
  • Beskrivelse: Angiver, om en rabatfjernelsesoperation er i gang
  • Anvendelse: Vis indlæsningstilstande under rabatfjernelse
handleRemoveDiscount
  • Type: () => Promise<void>
  • Beskrivelse: Funktion til at håndtere fjernelse af rabatkoder
  • Anvendelse: Fjern anvendte rabatkoder fra kurven
totalCompareAtPrice
  • Type: number
  • Beskrivelse: Den samlede sammenligningspris lagt sammen (alle varer i kurven)
  • Anvendelse: Beregn og vis besparelser eller information om oprindelige priser
totalAfterAllDiscounts
  • Type: number
  • Beskrivelse: Endelig kurvtotal i cents, efter alle rabatter er anvendt
  • Anvendelse: Vis den endelige pris, kunderne skal betale
originalTotalPrice
  • Type: number
  • Beskrivelse: Oprindelig kurvtotal i cents før eventuelle rabatter
  • Anvendelse: Vis oprindelige priser af hensyn til gennemsigtighed og besparelsesberegning
cartItemCount
  • Type: number
  • Beskrivelse: Samlet antal varer i kurven
  • Anvendelse: Vis information om vareantal i kurvoversigter

Tillidsbadges

Trust Badges-modulet giver dig mulighed for at tilpasse visningen af tillidsbadges med dit eget design, samtidig med at essentiel tillidsopbyggende funktionalitet som betinget badge-synlighed og korrekt billedhåndtering bevares.

Tilgængelige props - Fuld skabelon

showBadge
  • Type: boolean
  • Beskrivelse: Angiver, om tillidsbadget skal vises
  • Anvendelse: Styr synligheden af tillidsbadges baseret på modulindstillinger
badgeUrl
  • Type: string
  • Beskrivelse: URL’en til det tillidsbadge-billede, der skal vises
  • Anvendelse: Kilde-URL til tillidsbadge-billedet i brugerdefinerede implementeringer