Configure

configure(config) stelt in hoe de winkelwagen zich gedraagt. Het is een set-up-aanroep, dus veilig helemaal bovenaan je script, voordat de winkelwagen is geladen.

window.aftersell.cart.configure({
  open_on_add_to_cart: 'always',
  money_format: '${{amount}} USD',
});

Je kunt het meer dan eens aanroepen en waarden worden samengevoegd. Een latere aanroep overschrijft alleen de keys die hij benoemt en laat de rest met rust.

undefined doorgeven wist een key in plaats van hem over te slaan. configure({ open_on_add_to_cart: undefined }) reset die optie naar zijn standaardwaarde en gooit weg wat een eerdere aanroep instelde. Om een optie met rust te laten, laat je de key volledig weg.

Opties

Optie	Waarden	Standaard	Doel
`open_on_add_to_cart`	`'always'`, `'never'`, `'default'`	`'default'`	Of de drawer opent wanneer een artikel wordt toegevoegd.
`open_on_background_add`	`boolean`	`false`	Ook openen wanneer iets anders aan de winkelwagen toevoegt.
`validate_form_on_add_to_cart`	`boolean`	`false`	Blokkeer de toevoeging als het productformulier ongeldig is.
`skip_add_to_cart_interceptor`	`boolean`	`false`	Schakel Aftersell’s add-to-cart-interceptie volledig uit.
`skip_open_cart_interceptor`	`boolean`	`false`	Laat een klik op het cart icon je andere scripts bereiken.
`money_format`	string	formaat van de winkel	Overschrijf het formaat dat `formatMoney` gebruikt.

open_on_add_to_cart

Bepaalt of de drawer opent wanneer een shopper een product toevoegt.

Waarde	Gedrag
`'always'`	Open de drawer altijd bij toevoegen.
`'never'`	Open hem nooit; het artikel wordt stilletjes toegevoegd.
`'default'`	Volg de instelling Open cart when an item is added in de cart editor.

// Always open, regardless of the merchant's cart setting.
window.aftersell.cart.configure({ open_on_add_to_cart: 'always' });

Een veelvoorkomende toepassing is de drawer dicht houden op één specifieke pagina, terwijl je de merchant-instelling overal elders met rust laat:

if (window.location.pathname.startsWith('/collections/')) {
  window.aftersell.cart.configure({ open_on_add_to_cart: 'never' });
}

Als je dit gewoon voor de hele winkel aan wilt, is het al een instelling: Cart settings → Content → Behavior → Open cart when an item is added. Gebruik configure wanneer het antwoord afhangt van de pagina, de shopper, of iets dat alleen jouw code weet.

open_on_background_add

Zet dit op true om de drawer ook te openen bij achtergrond-toevoegingen — toevoegingen die Aftersell detecteerde maar niet zelf afhandelde. Een toevoeging telt als achtergrond wanneer ofwel:

hij binnenkwam via Shopify’s standaard cart-events (altijd behandeld als achtergrond, wat hem ook triggerde), of
Aftersell het cart-verzoek op de lijn zag met geen vertrouwde klik of toetsaanslag in de voorafgaande ~3 seconden — bijvoorbeeld een andere app of script dat naar de winkelwagen schrijft.

Een toevoeging die Aftersell op de lijn zag en die wel volgde op een klik van een shopper is geen achtergrond-toevoeging: die opent de drawer al volgens open_on_add_to_cart, zonder dat deze optie nodig is.

window.aftersell.cart.configure({ open_on_background_add: true });

Dit is een extra poort, geen override: een achtergrond-toevoeging opent de drawer alleen als open_on_add_to_cart het ook zou hebben toegestaan. Met open_on_add_to_cart: 'never' doet deze optie niets.

Grijp hiernaar wanneer een toevoegknop van een derde partij het artikel correct toevoegt maar de drawer gesloten laat. Als het artikel de winkelwagen helemaal niet bereikt, is dat een interceptieprobleem. Zie skip_add_to_cart_interceptor en de page builder-use case.

validate_form_on_add_to_cart

Draait de native formuliervalidatie van de browser (reportValidity()) vóór het toevoegen, en annuleert de toevoeging als het formulier ongeldig is. Gebruik het wanneer je productformulier verplichte velden heeft (een graveerbericht, een cadeaunotitie, een verplichte checkbox) die shoppers momenteel kunnen overslaan.

window.aftersell.cart.configure({ validate_form_on_add_to_cart: true });

De browser toont zijn eigen validatiebericht bij het betreffende veld. Standaard uit, omdat een thema met een verdwaald required-attribuut ergens in het productformulier anders stilzwijgend add-to-cart zou gaan blokkeren.

skip_add_to_cart_interceptor

Schakelt Aftersell’s add-to-cart-interceptie volledig uit. Voor wat interceptie doet en elke manier om je af te melden, zie Add-to-cart-interceptie. Het thema voert de toevoeging dan zelf uit, en elk script dat naar die submit luistert draait weer. Aftersell kijkt nog steeds naar het cart-verzoek op de lijn, dus de drawer opent zoals gewoonlijk. Je verliest hem niet door je af te melden. Op thema’s die Aftersell herkent, blijft de eigen winkelwagen van het thema inert, dus je krijgt geen twee winkelwagens. Op een thema dat hij niet herkent, kan het thema zijn eigen winkelwagen naast de jouwe openen; zie Opent de winkelwagen van het thema ook?.

window.aftersell.cart.configure({ skip_add_to_cart_interceptor: true });

Deze wordt eenmalig, bij het opstarten gelezen. Hij werkt alleen vanuit een set-up-aanroep die draait voordat de winkelwagen laadt: het Initialization-script van je winkelwagen. Later instellen (binnen ready(), of vanuit een event-handler) heeft geen effect en faalt stilzwijgend.

Dit is een bot instrument dat interceptie uitschakelt voor elk formulier op de pagina. Om slechts één formulier uit te zonderen, gebruik je in plaats daarvan de hook registerSkipAddToCartRule:

// Preferred: exempt only the forms you own.
window.aftersell.cart.hooks.registerSkipAddToCartRule((form) =>
  form.hasAttribute('data-skip-aftersell')
);

skip_open_cart_interceptor

Op het cart icon klikken opent de Aftersell drawer. Om dat betrouwbaar te doen, stopt Aftersell de klik zodat niets anders op de pagina hem afhandelt, wat er ook voor zorgt dat jouw scripts hem niet zien. Als een analytics- of pixel-event overal afgaat behalve op het cart icon, is dit de reden. Zet dit op true om te stoppen met het silencen van de klik:

window.aftersell.cart.configure({ skip_open_cart_interceptor: true });

Je listeners draaien dan, en de drawer opent nog precies zoals voorheen. De klik navigeert ook nog steeds niet naar /cart.

Dit doet minder dan de naam suggereert. Het slaat de cart-icon-interceptor niet over. Het stopt hem alleen met het silencen van andere listeners. Aftersell handelt de klik nog steeds af en opent nog steeds je winkelwagen. Voor een besturingselement dat Aftersell volledig zou moeten negeren, gebruik in plaats daarvan de class aftersell-cart-wont-open-cart; zie Add-to-cart-interceptie.

Anders dan skip_add_to_cart_interceptor wordt deze bij elke klik gelezen, dus je kunt hem op elk moment instellen en hij treedt direct in werking: vanuit ready(), een event-handler, of voorwaardelijk per pagina.

Sommige thema’s reageren zelf ook op de klik op het cart icon. Zodra Aftersell stopt met het silencen ervan, zal een thema dat zijn eigen drawer opent dat naast de jouwe doen. Als je twee winkelwagens ziet na het aanzetten van dit, voeg dan de class aftersell-cart-wont-open-cart toe aan het icoon van het thema en open de winkelwagen vanuit je eigen handler met actions.open().

money_format

Overschrijft het Shopify-geldformaat dat formatMoney gebruikt. Standaard het formaat van je eigen winkel; als dat niet beschikbaar is, vallen prijzen terug op $X.XX.

window.aftersell.cart.configure({ money_format: '${{amount}} USD' });

// Later:
window.aftersell.cart.actions.formatMoney(5779); // "$57.79 USD"

Omdat configure samenvoegt en formatMoney de live waarde leest, kun je het formaat tijdens runtime wijzigen, bijvoorbeeld wanneer een valutawisselaar afgaat:

window.myTheme.onCurrencyChange((currency) => {
  window.aftersell.cart.configure({ money_format: FORMATS[currency] });
  window.aftersell.cart.actions.visualRefresh(); // repaint prices already on screen
});

Dit verandert hoe de SDK en de winkelwagen prijzen weergeven. Het verandert niet de valuta waarin de shopper wordt belast; dat is Shopify Markets.

Waar nu naartoe

Actions: lees en wijzig de winkelwagen.
Hooks: controle per formulier en per regel, waar configure te breed is.
Use cases: complete oplossingen voor veelvoorkomende verzoeken.

Aan de slag

Startpagina

Best practices

Post-purchase upsells

Aftersell-winkelwagen

Checkout-upsells (Shopify Plus)

Bedankpagina

Upsells op de productpagina

Rokt Thanks

Strategieën

Analytics en tracking

Integraties

Aftersell MCP

Facturering en account

Probleemoplossing

Opties

open_on_add_to_cart

open_on_background_add

validate_form_on_add_to_cart

skip_add_to_cart_interceptor

skip_open_cart_interceptor

money_format

Waar nu naartoe

​Opties

​open_on_add_to_cart

​open_on_background_add

​validate_form_on_add_to_cart

​skip_add_to_cart_interceptor

​skip_open_cart_interceptor

​money_format

​Waar nu naartoe

Opties

open_on_add_to_cart

open_on_background_add

validate_form_on_add_to_cart

skip_add_to_cart_interceptor

skip_open_cart_interceptor

money_format

Waar nu naartoe