⚠️ Belangrijke mededeling
Functies van de code-editor
TypeScript IntelliSense
props. De typehints van de props zijn IntelliSense die alleen in de editor bestaat om je te helpen sjablonen te schrijven — je schrijft ze niet in het sjabloon zelf en ze worden nooit uitgevoerd in je webshop.
Bewerkbare sjablooninhoud
Sectie General
Header
Beschikbare props - Volledig sjabloon

cartQuantity
-
Type:
string - Beschrijving: Het huidige aantal artikelen in de winkelwagen, opgemaakt als string
- Gebruik: Toon het aantal winkelwagenartikelen in je aangepaste headerontwerp
closeHandler
-
Type:
() => void - Beschrijving: Een callbackfunctie die de winkelwagen sluit wanneer deze wordt aangeroepen
- Gebruik: Koppel aan knoppen, pictogrammen of andere interactieve elementen om de winkelwagen te sluiten
titleComponent
-
Type:
React.ReactElement | null - Beschrijving: Een vooraf gerenderd titelcomponent voor de winkelwagenheader met de juiste styling en vertalingen
- Gebruik: Toon de winkelwagentitel op basis van de configuratie van je winkelwageninstellingen
Sectie Body
Aankondigingen
Beschikbare props - Volledig sjabloon

announcementTemplate
-
Type:
string - Beschrijving: De HTML-inhoud van het aankondigingsbericht
- Gebruik: Toon het aankondigingsbericht in je aangepaste implementaties
timer
-
Type:
string - Beschrijving: De huidige timerwaarde, opgemaakt als string
- Gebruik: Toon een afteltimer in aangepaste aankondigingsimplementaties
shouldUseTimer
-
Type:
boolean - Beschrijving: Geeft aan of de timerfunctionaliteit is ingeschakeld voor deze aankondiging
- Gebruik: Render timergerelateerde inhoud en bedieningselementen voorwaardelijk
isTimerExpiredAndShouldHide
-
Type:
boolean - Beschrijving: Geeft aan of de timer is verlopen en de aankondiging verborgen moet worden
- Gebruik: Bepaal de zichtbaarheid van de hele aankondiging op basis van de timerstatus
Gestaffelde beloningen
Beschikbare props - Volledig sjabloon

rewardsMessageHtml
-
Type:
string - Beschrijving: De HTML-inhoud van het beloningsbericht
- Gebruik: Toon het beloningsbericht met rijke opmaak in aangepaste implementaties
milestonesCompleted
-
Type:
number - Beschrijving: Het aantal mijlpalen dat is voltooid
- Gebruik: Toon het aantal voltooide mijlpalen of bereken het voltooiingspercentage
milestonesData
-
Type:
- Beschrijving: Volledige mijlpaalconfiguratie en voortgangsgegevens voor het beloningssysteem
- Gebruik: Toegang tot mijlpaalinformatie, voortgangspercentage en weergave-instellingen
-
Eigenschappen:
milestonesToRender: Array van mijlpaalobjecten met voltooiingsstatus en positioneringprogressPercent: Huidige voortgang als percentage (0-100)showMilestones: Of mijlpaalmarkeringen moeten worden weergegevensettings: Visuele configuratie voor de mijlpaalweergave
Kortingen
TRIGGERED_REWARDS voor achterwaartse compatibiliteit met bestaande code van aangepaste sjablonen.
Beschikbare props - Volledig sjabloon
rules
-
Type:
- Beschrijving: Array van kortingsregels die momenteel zijn ingeschakeld
- Gebruik: Toon beschikbare beloningen, hun titels, beschrijvingen en of aan de voorwaarden van elke regel is voldaan
-
Eigenschappen:
id: Unieke identifier voor de beloningsregeltitle: Titel van de kortingsregeldescription: Beschrijving van de beloningsregelconditionsMet: Of momenteel aan de voorwaarden van de regel wordt voldaan door de winkelwagen. Gebruik dit om UX-patronen te bouwen als “je hebt X ontgrendeld” versus “besteed nog $Y om X te ontgrendelen”
showSection
-
Type:
boolean - Beschrijving: Geeft aan of de Discounts-sectie moet worden weergegeven
- Gebruik: Bepaal de zichtbaarheid van de hele Discounts-module
onToggleSection
-
Type:
() => void - Beschrijving: Een callbackfunctie die de zichtbaarheidsstatus van de Discounts-sectie omschakelt
- Gebruik: Koppel aan knoppen of interactieve elementen zodat gebruikers de beloningensectie kunnen tonen/verbergen
Aanbevelingen
Beschikbare props - Sjabloon voor aanbevelingstegel

Winkelwagenartikelen
Een laadindicator tonen tijdens het toevoegen aan de winkelwagen of winkelwagenupdates: De standaard Cart Items-module biedt geen ingebouwde spinner voor “toevoegen aan winkelwagen”. Als je een laadstatus wilt weergeven terwijl een artikel wordt toegevoegd of een winkelwagenbewerking bezig is, gebruik dan het Product tile-sjabloon en lees de props
isLoading en loadingOperation (hieronder gedocumenteerd) om voorwaardelijk een spinner of overlay te renderen. Aangepaste sjablonen vereisen developer-ervaring — zie de mededeling bovenaan deze pagina.Beschikbare props - Product tile-sjabloon
Als je aangepaste code in een van die sjablonen wilt gebruiken, moet je het Product Tile-sjabloon uitschakelen.

title
-
Type:
string - Beschrijving: De titel/naam van het product
- Gebruik: Toon de hoofdproductnaam bij winkelwagenartikelen
variant
-
Type:
React.ReactNode - Beschrijving: Vooraf gerenderd component met variantinformatie
- Gebruik: Toon variantdetails als React-component
properties
-
Type:
React.ReactNode - Beschrijving: Vooraf gerenderd component met producteigenschappen
- Gebruik: Toon producteigenschappen en abonnementsinformatie als React-component
bundle
-
Type:
React.ReactNode - Beschrijving: Vooraf gerenderd component met bundeldetails
- Gebruik: Toon bundelinformatie als React-component
compareAtPrice
-
Type:
string | undefined - Beschrijving: Opgemaakte vergelijkingsprijs (originele prijs)
- Gebruik: Toon de originele prijs bij afgeprijsde artikelen
price
-
Type:
string - Beschrijving: Opgemaakte huidige prijs
- Gebruik: Toon de huidige artikelprijs
savings
-
Type:
string | undefined - Beschrijving: Opgemaakt besparingsbedrag
- Gebruik: Toon hoeveel de klant bespaart
imageUrl
-
Type:
string | undefined - Beschrijving: URL van de productafbeelding
- Gebruik: Toon de productafbeelding
productUrl
-
Type:
string | undefined - Beschrijving: URL van de productpagina
- Gebruik: Link naar de productdetailpagina
quantity
-
Type:
number - Beschrijving: Huidig aantal van het artikel in de winkelwagen
- Gebruik: Toon en beheer het artikelaantal
showQuantitySelector
-
Type:
boolean - Beschrijving: Of de aantalbediening moet worden getoond
- Gebruik: Toon de aantalkiezer voorwaardelijk
discountCodes
-
Type:
string[] | undefined - Beschrijving: Array van toegepaste kortingscodes voor dit artikel
- Gebruik: Toon artikelspecifieke kortingen
subscription
-
Type:
- Beschrijving: Volledig abonnementsbeheerobject met upgradegegevens, verkoopplannen en handlerfuncties
- Gebruik: Beheer abonnementsfunctionaliteit
-
Het subscription-object bevat:
-
subscriptionUpgradeData: Upgrade-informatie (null als er geen upgrade beschikbaar is)
buttonText: Tekst voor de upgradeknopdefaultSellingPlanId: ID van het standaardverkoopplan voor upgrades
-
sellingPlansData: Beschikbare opties voor verkoopplannen (null als er geen plannen zijn)
sellingPlanGroups: Array van plangroepen met hun verkoopplannenactiveSellingPlanId: ID van het momenteel geselecteerde verkoopplanoneTimePurchaseText: Tekst voor de optie eenmalige aankoop (null indien niet beschikbaar)
- upgradeSellingPlan: Functie om te upgraden naar een specifiek verkoopplan
- changeSellingPlan: Functie om het huidige verkoopplan te wijzigen
- getSellingPlanGroupText: Hulpfunctie om de weergavetekst van het verkoopplan op te maken
-
subscriptionUpgradeData: Upgrade-informatie (null als er geen upgrade beschikbaar is)
onIncrease
-
Type:
() => void - Beschrijving: Functie om het artikelaantal te verhogen
- Gebruik: Verwerk acties om het aantal te verhogen
onDecrease
-
Type:
() => void - Beschrijving: Functie om het artikelaantal te verlagen
- Gebruik: Verwerk acties om het aantal te verlagen
onDeleteProduct
-
Type:
() => void - Beschrijving: Functie om het artikel uit de winkelwagen te verwijderen
- Gebruik: Verwerk het verwijderen van artikelen
onQuantityChange
-
Type:
(quantity: string) => void - Beschrijving: Functie om directe aantalinvoer te verwerken
- Gebruik: Verwerk handmatige aantalwijzigingen
handleInputChange
-
Type:
(e: React.ChangeEvent<HTMLInputElement>) => void - Beschrijving: Handler voor invoerwijzigingen van het aantalveld
- Gebruik: Verwerk wijzigingen in het invoerveld voor het aantal
replaceItemWithVariant
-
Type:
(variantId: string) => Promise<{ success: boolean }> - Beschrijving: Functie om het artikel te vervangen door een andere variant
- Gebruik: Verwerk het wisselen van varianten
isLoading
-
Type:
boolean - Beschrijving: Laadstatus voor winkelwagenbewerkingen
- Gebruik: Toon laadindicatoren
loadingOperation
-
Type:
'increase' | 'decrease' | 'inputChange' | 'remove' | 'subscription' | undefined - Beschrijving: Specifieke bewerking die momenteel wordt geladen
- Gebruik: Toon bewerkingsspecifieke laadstatussen
setLoadingOperation
-
Type:
(op: "increase" | "decrease" | "inputChange" | "remove" | "subscription" | undefined) => void - Beschrijving: Functie om de laadstatus van bewerkingen in te stellen
- Gebruik: Beheer laadstatussen voor verschillende bewerkingen
rawItem
-
Type:
CartItem(zie hetCartItem-type hieronder) - Beschrijving: Ruwe winkelwagenartikelgegevens met alle informatie
Beschikbare props - Variant-sjabloon

item
-
Type:
CartItem(zie hetCartItem-type hieronder) - Beschrijving: Ruwe winkelwagenartikelgegevens met variantinformatie
- Gebruik: Toegang tot variantdetails van het winkelwagenartikel
Beschikbare props - Properties-sjabloon

productProperties
-
Type:
{ key: string; value: string; isUrl?: boolean; }[] - Beschrijving: Array van producteigenschappen (aangepaste velden, regelartikeleigenschappen)
subscriptionLabel
-
Type:
string | undefined - Beschrijving: Label voor abonnementsinformatie
Beschikbare props - Bundle-sjabloon

getSizedImageUrl
-
Type:
getSizedImageUrl: ({ src, width, height }: SizedImageParams) => string - Beschrijving: Hulpfunctie om afbeeldings-URL’s met de juiste afmetingen op te halen
item
-
Type:
-
Beschrijving: Informatie over het bundelartikel, inclusief componenten.
itemComponentsis een array van componentobjecten — loop erover met map om elk gebundeld component te renderen.
showDetailsText
-
Type:
string | undefined - Beschrijving: Tekst voor de actie “details tonen”
- Gebruik: Toon de tekst van de uitklapknop
hideDetailsText
-
Type:
string | undefined - Beschrijving: Tekst voor de actie “details verbergen”
isExpanded
-
Type:
boolean - Beschrijving: Of de bundeldetails zijn uitgeklapt
toggleCollapsible
-
Type:
() => void - Beschrijving: Functie om de zichtbaarheid van de bundeldetails om te schakelen
- Gebruik: Verwerk uitklap-/inklapacties
chevronDownIconComponent
-
Type:
React.ReactElement - Beschrijving: Vooraf gerenderd chevron-pictogram voor uitklappen/inklappen
- Gebruik: Toon een consistente uitklap-/inklapindicator
Beschikbare props - Price-sjabloon

compareAtPrice
-
Type:
string | undefined - Beschrijving: Opgemaakte vergelijkingsprijs (originele prijs)
- Gebruik: Toon de originele prijs bij afgeprijsde artikelen
price
-
Type:
string - Beschrijving: Opgemaakte huidige prijs
- Gebruik: Toon de huidige artikelprijs
savings
-
Type:
string | undefined - Beschrijving: Opgemaakt besparingsbedrag
- Gebruik: Toon hoeveel de klant bespaart
Eigenschappen van het CartItem-object
CartItem-object bevat alle gedetailleerde informatie over een winkelwagenregel. Dit object is beschikbaar als props.rawItem in het Product Tile-sjabloon en als props.item in het Variant-sjabloon.
Kernidentificatie
-
key (string)- Unieke identifier voor dit winkelwagenartikel. -
id (number)- Variant-ID (verouderd veld, gebruik in plaats daarvan variant_id) -
variant_id (number)- De Shopify-variant-ID voor dit artikel -
product_id (number)- De Shopify-product-ID -
lineIdxFrom1 (number)- 1-gebaseerde index van dit artikel in de oorspronkelijke winkelwagen vóór wijzigingen
Productinformatie
-
title (string)- De titel van de winkelwagenregel (meestal de varianttitel) -
product_title (string)- De hoofdtitel van het product -
handle (string)- URL-handle van het product (bijv. “camp-stool”) -
vendor (string)- Naam van de leverancier/het merk van het product -
product_type (string)- Productcategorie/-type voor belastingdoeleinden -
sku (string)- Stock Keeping Unit-identifier -
product_description (string)- Volledige productbeschrijving -
product_has_only_default_variant (boolean)- Of het product slechts één variant heeft
Prijzen (alle prijzen in centen)
-
quantity (number)- Aantal van dit artikel in de winkelwagen -
price (number)- Stukprijs vóór kortingen -
original_price (number)- Hetzelfde als price -
discounted_price (number)- Stukprijs na kortingen op productniveau -
compare_at_price (number | null)- Vergelijkingsprijs (adviesprijs). Let op: dit veld wordt toegevoegd door Upcart en wordt niet geleverd door de cart-API van Shopify -
final_line_price (number)- Totaalprijs na kortingen op productniveau (quantity × discounted_price) -
original_line_price (number)- Totaalprijs vóór kortingen (quantity × price) -
line_price (number)- Totaalprijs na alle kortingen -
final_price (number)- Verouderd - Stukprijs na productkortingen (houdt geen rekening met het aantal) -
total_discount (number)- Hetzelfde als line_level_total_discount -
line_level_total_discount (number)- Totaal kortingsbedrag toegepast op deze winkelwagenregel
Media en URL’s
-
image (string)- URL van de primaire productafbeelding -
url (string)- Relatief URL-pad naar de productpagina (bijv. “/products/camp-stool?variant=42789611372803”) -
featured_image (object | null)- Details van de uitgelichte afbeelding:alt (string)- Alt-tekst van de afbeeldingaspect_ratio (number)- Beeldverhouding van de afbeeldingheight (number)- Afbeeldingshoogte in pixelsurl (string)- Afbeeldings-URLwidth (number)- Afbeeldingsbreedte in pixels
Varianten en opties
-
variant_title (string | null)- Varianttitel (bijv. “Large / Red”) -
variant_options (string[])- Array van variantoptiewaarden -
options_with_values (Array)- Gedetailleerde optie-informatie:name (string)- Optienaam (bijv. “Size”)value (string)- Optiewaarde (bijv. “Large”)
-
untranslated_product_title (string | undefined)- Oorspronkelijke producttitel vóór vertaling (alleen in reacties op winkelwagenmutaties) -
untranslated_variant_title (string | undefined)- Oorspronkelijke varianttitel vóór vertaling (alleen in reacties op winkelwagenmutaties)
Aangepaste eigenschappen en metadata
-
properties (Record<string, any> | null)- Aangepaste regelartikeleigenschappen, ofnullwanneer de regel er geen heeft — controleer dit voordat je een sleutel leest. Eigenschappen waarvan de sleutels beginnen met__zijn altijd verborgen voor klanten; sleutels die beginnen met één_zijn ook verborgen wanneer de winkelwageninstelling Hide properties starting with single underscore ”_” aan staat. -
gift_card (boolean)- Of dit artikel een cadeaubon is -
taxable (boolean)- Of dit artikel belastbaar is -
requires_shipping (boolean)- Of dit artikel verzending vereist -
grams (number)- Artikelgewicht in grammen
Kortingen en promoties
-
discounts (Array)- Vereenvoudigde kortingsinformatie:amount (number)- Kortingsbedrag in cententitle (string)- Titel/naam van de korting
-
line_level_discount_allocations (Array)- Gedetailleerde informatie over de kortingstoewijzing:-
amount (number)- Kortingsbedrag in centen -
discount_application (object)- Volledige details van de kortingstoepassing:allocation_method (string)- Hoe de korting wordt toegewezencreated_at (string)- Wanneer de korting is aangemaaktdescription (string | null)- Kortingsbeschrijvingkey (string)- Sleutelidentifier van de kortingtarget_selection (string)- Waarop de korting is gerichttarget_type (string)- Type doelwittitle (string)- Kortingstiteltotal_allocated_amount (number)- Totaal toegewezen bedragtype ('discount_code' | '')- Kortingstype (lege string voor automatische kortingen)value (string)- Kortingswaardevalue_type (string)- Hoe de waarde wordt toegepast
-
Bundelproducten
-
has_components (boolean | undefined)- Of dit artikel een bundel is die andere producten bevat (alleen in GET cart-reacties) -
item_components (Array | null | undefined)- Details van bundelcomponenten:-
quantity (number)- Aantal van dit component -
image (object)- Componentafbeelding:url (string)- Afbeeldings-URLheight (number | null)- Afbeeldingshoogtewidth (number | null)- Afbeeldingsbreedtealt (string)- Alt-tekst
-
-
product (object)- Productinformatie van het component:title (string)- Producttitelhas_only_default_variant (boolean)- Of het product alleen een standaardvariant heeft
-
variantTitle (string)- Varianttitel van het component
Bedrijfsregels
-
quantity_rule (object | undefined)- Aantalbeperkingen (alleen in GET cart-reacties):min (number)- Minimaal toegestaan aantalmax (number | null)- Maximaal toegestaan aantal (null = geen limiet)increment (number)- Stapgrootte voor het aantal
Abonnementsinformatie
-
selling_plan_allocation (object | undefined)- Details van abonnement/verkoopplan:-
price (number)- Abonnementsprijs in centen -
compare_at_price (number | null)- Vergelijkingsprijs van het abonnement -
per_delivery_price (number)- Prijs per levering -
selling_plan (object)- Details van het verkoopplan:-
id (number)- ID van het verkoopplan -
name (string)- Plannaam -
description (string)- Planbeschrijving -
options (Array)- Planopties:name (string)- Optienaamposition (number)- Optiepositievalue (string)- Optiewaarde
-
recurring_deliveries (boolean)- Of het plan terugkerende leveringen heeft
-
-
Integratiemetadata
-
__appIntegrated (object | undefined)- Integratiegegevens van externe apps:app ('stay.ai')- Identifier van de geïntegreerde appbundleRole ('parent' | 'child')- Rol in de bundelstructuur
Upsells
Beschikbare props - Sjabloon voor upsell-tegel

itemUrl
-
Type:
string - Beschrijving: De URL van de productpagina
- Gebruik: Maak links naar de productdetailpagina voor verbeterde gebruikersnavigatie
imageUrl
-
Type:
string | undefined - Beschrijving: De URL van de productafbeelding
- Gebruik: Toon productafbeeldingen in aangepaste upsell-implementaties
- Fallback: Ga netjes om met undefined-waarden via placeholder-afbeeldingen
description
-
Type:
string - Beschrijving: De beschrijving van het product
- Gebruik: Toon de productbeschrijving in aangepaste upsell-implementaties
altText
-
Type:
string - Beschrijving: Alt-tekst voor de productafbeelding voor toegankelijkheid
- Gebruik: Bied ondersteuning voor schermlezers en verbeter de naleving van toegankelijkheidsrichtlijnen
productId
-
Type:
string - Beschrijving: De unieke identifier voor het product
- Gebruik: Volg producten, implementeer analytics of gebruik in de functionaliteit voor toevoegen aan winkelwagen
productTitle
-
Type:
string - Beschrijving: De titel/naam van het product
- Gebruik: Toon de productnaam in aangepaste upsell-implementaties
oldPrice & newPrice
-
Type:
string | null(oldPrice),string(newPrice) - Beschrijving: Opgemaakte vergelijkingsprijs en huidige prijs
- Gebruik: Toon prijsinformatie met aanbiedingsindicatoren
isSingleVariant
-
Type:
boolean - Beschrijving: Geeft aan of het product slechts één variant heeft
- Gebruik: Render UI-elementen voor variantselectie voorwaardelijk
productOptions
-
Type:
{ name: string; position: 1 | 2 | 3; values: string[]; }[] - Beschrijving: Volledige configuratie van productopties, inclusief alle beschikbare keuzes
- Gebruik: Toegang tot gedetailleerde productoptie-informatie voor geavanceerde UI voor variantselectie
variantOptions
-
Type:
{ label: string; value: string }[] - Beschrijving: Beschikbare variantopties voor het product
- Gebruik: Maak dropdowns of knoppen voor variantselectie
- Structuur: Elke optie bevat een weergavelabel en een unieke waarde-identifier
selectedVariantId & selectedVariantLabel
- Type: string (selectedVariantId), string | undefined (selectedVariantLabel)
- Beschrijving: Het momenteel geselecteerde variant-ID en het bijbehorende weergavelabel
- Gebruik: Volg en toon de informatie van de geselecteerde variant
onVariantChange
-
Type:
(variantId: string) => void - Beschrijving: Functie om wijzigingen in de variantselectie te verwerken
- Gebruik: Werk de geselecteerde variant bij wanneer de gebruiker een selectie maakt
onAddClick
-
Type:
(productId: string, variantId?: string) => void - Beschrijving: Functie om het toevoegen van het product aan de winkelwagen te verwerken
- Gebruik: Implementeer de functionaliteit voor toevoegen aan winkelwagen met de juiste product- en variantidentificatie
rating & reviewCount
-
Type:
number | undefined(rating),string | undefined(reviewCount) - Beschrijving: Productbeoordeling en opgemaakte tekst met het aantal reviews
- Gebruik: Toon social proof en indicatoren van productkwaliteit
addLoading & addButtonText
-
Type:
boolean(addLoading),string(addButtonText) - Beschrijving: Laadstatus voor de actie toevoegen aan winkelwagen en de knoptekst
- Gebruik: Geef gebruikersfeedback tijdens winkelwagenbewerkingen en pas de knoptekst aan
cartItemsCount
-
Type:
number - Beschrijving: Het huidige aantal artikelen in de winkelwagen
- Gebruik: Toon de winkelwagenstatus of implementeer op de winkelwagen gebaseerde logica
Extra notities
Beschikbare props - Volledig sjabloon

cartNote
-
Type:
string - Beschrijving: De huidige inhoud van de winkelwagennotitie die door de klant is ingevoerd
- Gebruik: Toon en beheer de notitietekst in aangepaste implementaties
notesPlaceholder
-
Type:
string - Beschrijving: Placeholdertekst voor het notitie-invoerveld
- Gebruik: Geef klanten richtlijnen over wat ze in hun notities kunnen zetten
notesTitle
-
Type:
string - Beschrijving: De titel/koptekst van de notitiesectie
- Gebruik: Toon de sectietitel in aangepaste notitie-implementaties
chevronDownIconComponent
-
Type:
React.ReactElement - Beschrijving: Vooraf gerenderd chevron-pictogramcomponent voor uitklap-/inklapfunctionaliteit
- Gebruik: Toon consistente uitklap-/inklapindicatoren in aangepaste implementaties
loadingIndicatorComponent
-
Type:
React.ReactElement | null - Beschrijving: Vooraf gerenderd laadindicatorcomponent voor asynchrone bewerkingen
- Gebruik: Toon laadstatussen tijdens het opslaan van notities
handleCartNoteChange
-
Type:
(newCartNote: string) => void - Beschrijving: Functie om wijzigingen in de inhoud van de winkelwagennotitie te verwerken
- Gebruik: Werk de winkelwagennotitie bij wanneer de gebruiker de tekst wijzigt
isExpanded
-
Type:
boolean - Beschrijving: Geeft aan of de notitiesectie momenteel is uitgeklapt
- Gebruik: Bepaal de zichtbaarheid van het notitie-invoergebied
toggleCollapsible
-
Type:
() => void - Beschrijving: Functie om de uitgeklapte/ingeklapte status van de notitiesectie om te schakelen
- Gebruik: Koppel aan knoppen of interactieve elementen om de zichtbaarheid van de sectie te regelen
Add-ons
Beschikbare props - Volledig sjabloon

addonProduct
-
Type:
- Beschrijving: Volledige informatie over het add-on-product, inclusief productdetails, variantprijzen en afbeeldingsgegevens
- Gebruik: Toegang tot alle productinformatie die nodig is om add-on-producten weer te geven
-
Structuur: Bevat geneste product-, variant- en afbeeldingsobjecten met uitgebreide productgegevens
-
Eigenschappen van het productobject
addonProduct.product- id: Unieke numerieke identifier voor het product
- title: Weergavenaam van het add-on-product
- description: HTML-beschrijvingsinhoud van het product
-
Eigenschappen van het variantobject
- id: Unieke numerieke identifier voor de variant
- price: Huidige prijs in centen
- compare_at_price: Originele prijs in centen (null als er geen vergelijkingsprijs is)
-
Eigenschappen van het afbeeldingsobject
- src: URL van de productafbeelding
- alt: Alt-tekst voor de afbeelding (voor toegankelijkheid)
-
Eigenschappen van het productobject
toggle
-
Type:
- Beschrijving: Status en handlers van de schakelbediening voor het in-/uitschakelen van de add-on
- Gebruik: Implementeer interactieve schakelfunctionaliteit voor de selectie van add-ons
- Statussen: Drie mogelijke statussen — enabled, disabled en loading
- Handlers: Aparte functies voor in- en uitschakelacties
moneyFormat
-
Type:
string - Beschrijving: De valutaopmaakstring die wordt gebruikt voor prijsopmaak
- Gebruik: Geef door aan de functie formatMoney voor een consistente valutaweergave
formatMoney
-
Type:
- Beschrijving: Hulpfunctie voor het opmaken van valutawaarden
- Gebruik: Maak prijzen consistent op volgens de valuta-instellingen van de winkel
- Parameters: Neemt een waarde in centen, een optionele opmaakstring en een optie voor HTML-verwijdering
Kortingscodes
Beschikbare props - Volledig sjabloon

indicator
-
Type:
'validating' | 'invalid' | 'none' - Beschrijving: Huidige validatiestatus van de kortingscode-invoer
- Gebruik: Toon passende UI-feedback op basis van de validatiestatus
-
Statussen:
validating: De code wordt verwerkt/gevalideerdinvalid: De codevalidatie is misluktnone: Geen validatiestatus (standaard/inactief)
discountCodeInput
-
Type:
string - Beschrijving: Huidige waarde van het invoerveld voor de kortingscode
- Gebruik: Toon en beheer de kortingscodetekst die de gebruiker heeft ingevoerd
discountCodePlaceholder
-
Type:
string - Beschrijving: Placeholdertekst voor het invoerveld van de kortingscode
- Gebruik: Geef gebruikers richtlijnen over wat ze in het invoerveld moeten invullen
discountCodeButtonText
-
Type:
string - Beschrijving: Tekst die op de knop toepassen/verzenden wordt weergegeven
- Gebruik: Pas de knoptekst voor het verzenden van kortingscodes aan
setDiscountCodeInput
-
Type:
(value: string | ((prev: string) => string)) => void - Beschrijving: Functie om de invoerwaarde van de kortingscode bij te werken
- Gebruik: Verwerk invoerwijzigingen van de gebruiker in het kortingscodeveld
handleSubmit
-
Type:
(e: React.FormEvent<HTMLFormElement>) => void - Beschrijving: Functie om de formulierverzending voor het toepassen van kortingscodes te verwerken
- Gebruik: Verwerk de validatie en toepassing van kortingscodes
- Event: Verwerkt formulierverzendingsevents
Winkelwagenoverzicht
Beschikbare props - Volledig sjabloon

totalSavingsText
-
Type:
string - Beschrijving: Tekstlabel voor de sectie met totale besparingen
- Gebruik: Toon het besparingslabel in aangepaste implementaties van het winkelwagenoverzicht
discountApplications
-
Type:
- Beschrijving: Array van toegepaste kortingscodes en automatische kortingen
- Gebruik: Toon alle actieve kortingen met hun titels en typen
- Structuur: Elke korting bevat een unieke sleutel, een weergavetitel en een type-identifier
cartTotalDiscount
-
Type:
number - Beschrijving: Het totale kortingsbedrag in centen
- Gebruik: Toegang tot de ruwe kortingswaarde voor berekeningen of aangepaste opmaak
showCartTotalDiscount
-
Type:
boolean -
Beschrijving: Geeft aan of de totale korting moet worden weergegeven. Gemarkeerd als verouderd ten gunste van
showTotalSavings, maar zie de opmerking hieronder — binnen een aangepast sjabloon is dit nog steeds de prop die je hebt. - Gebruik: Render kortingsinformatie voorwaardelijk op basis van instellingen
formattedCartTotalDiscount
-
Type:
string -
Beschrijving: Vooraf opgemaakte HTML-string van het totale kortingsbedrag. Gemarkeerd als verouderd ten gunste van
formattedTotalSavings, maar zie de opmerking hieronder. - Gebruik: Toon een correct opgemaakt kortingsbedrag met valutasymbolen
isRemovingDiscount
-
Type:
boolean - Beschrijving: Geeft aan of het verwijderen van een korting bezig is
- Gebruik: Toon laadstatussen tijdens het verwijderen van kortingen
handleRemoveDiscount
-
Type:
() => Promise<void> - Beschrijving: Functie om het verwijderen van kortingscodes te verwerken
- Gebruik: Verwijder toegepaste kortingscodes uit de winkelwagen
totalCompareAtPrice
-
Type:
number - Beschrijving: Het opgetelde totaal van de vergelijkingsprijzen (alle artikelen in de winkelwagen)
- Gebruik: Bereken en toon besparingen of oorspronkelijke prijsinformatie
totalAfterAllDiscounts
-
Type:
number - Beschrijving: Eindtotaal van de winkelwagen in centen nadat alle kortingen zijn toegepast
- Gebruik: Toon de uiteindelijke prijs die klanten betalen
originalTotalPrice
-
Type:
number - Beschrijving: Oorspronkelijk winkelwagentotaal in centen vóór eventuele kortingen
- Gebruik: Toon de oorspronkelijke prijzen voor transparantie en besparingsberekening
cartItemCount
-
Type:
number - Beschrijving: Totaal aantal artikelen in de winkelwagen
- Gebruik: Toon informatie over het aantal artikelen in winkelwagenoverzichten
Vertrouwensbadges
Beschikbare props - Volledig sjabloon
showBadge
-
Type:
boolean - Beschrijving: Geeft aan of de vertrouwensbadge moet worden weergegeven
- Gebruik: Bepaal de zichtbaarheid van vertrouwensbadges op basis van de module-instellingen
badgeUrl
-
Type:
string - Beschrijving: De URL van de weer te geven afbeelding van de vertrouwensbadge
- Gebruik: Bron-URL voor de afbeelding van de vertrouwensbadge in aangepaste implementaties