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.
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.
Bepaalt of de drawer opent wanneer een shopper een product toevoegt.
Een veelvoorkomende toepassing is de drawer dicht houden op één specifieke pagina, terwijl je de merchant-instelling overal elders met rust laat:
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.
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.
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. 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.
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
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.
registerSkipAddToCartRule:
skip_open_cart_interceptor
true om te stoppen met het silencen van de klik:
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. 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(). formatMoney gebruikt. Standaard het formaat van je eigen winkel; als dat niet beschikbaar is, vallen prijzen terug op $X.XX.
Omdat configure samenvoegt en formatMoney de live waarde leest, kun je het formaat tijdens runtime wijzigen, bijvoorbeeld wanneer een valutawisselaar afgaat:
Dit verandert hoe de SDK en de winkelwagen prijzen weergeven. Het verandert niet de valuta waarin de shopper wordt belast; dat is Shopify Markets.
- 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.
