Skip to main content
configure(config) bestemmer, hvordan kurven opfører sig. Det er et opsætningskald, så det er sikkert helt øverst i dit script, før kurven er indlæst.
Du kan kalde det mere end én gang, og værdierne flettes. Et senere kald tilsidesætter kun de nøgler, det nævner, og lader resten være.
At sende undefined rydder en nøgle i stedet for at springe den over. configure({ open_on_add_to_cart: undefined }) nulstiller den mulighed til dens standard og kasserer, hvad et tidligere kald har sat. For at lade en mulighed være i fred skal du udelade nøglen helt.

​
Muligheder

​
open_on_add_to_cart

Styrer, om draweren åbner, når en kunde tilføjer et produkt.
En almindelig anvendelse er at holde draweren lukket på én bestemt side, mens forhandlerindstillingen bevares alle andre steder:
Hvis du bare vil have dette slået til for hele butikken, er det allerede en indstilling: Cart settings → Content → Behavior → Open cart when an item is added. Brug configure, når svaret afhænger af siden, kunden eller noget, kun din kode ved.

​
open_on_background_add

Sæt denne til true for også at åbne draweren ved baggrundstilføjelser — dem Aftersell registrerede, men ikke selv håndterede. En tilføjelse tæller som baggrund, når enten:
  • den ankom via Shopifys standard-kurvevents (behandles altid som baggrund, uanset hvad der udløste den), eller
  • Aftersell så kurvanmodningen på netværket uden et betroet klik eller tastetryk i de foregående ~3 sekunder — for eksempel en anden app eller et andet script, der skriver til kurven.
En tilføjelse, som Aftersell så på netværket, og som fulgte efter en kundes klik, er ikke en baggrundstilføjelse: den åbner allerede draweren i henhold til open_on_add_to_cart, uden behov for denne mulighed.
Dette er en ekstra gate, ikke en tilsidesættelse: en baggrundstilføjelse åbner kun draweren, hvis open_on_add_to_cart også ville have tilladt det. Med open_on_add_to_cart: 'never' gør denne mulighed intet.
Ræk ud efter denne, når en tredjeparts tilføjelsesknap tilføjer varen korrekt, men lader draweren forblive lukket. Hvis varen slet ikke når kurven, er det et interception-problem. Se skip_add_to_cart_interceptor og page builder-use casen.

​
validate_form_on_add_to_cart

Kører browserens indbyggede formularvalidering (reportValidity()), før der tilføjes, og annullerer tilføjelsen, hvis formularen er ugyldig. Brug den, når din produktformular har påkrævede felter (en graveringsbesked, en gavenote, et påkrævet afkrydsningsfelt), som kunderne i øjeblikket kan springe over.
Browseren viser sin egen valideringsbesked på det pågældende felt. Slået fra som standard, fordi et tema med en vildfaren required-attribut et sted i produktformularen ellers lydløst ville begynde at blokere add to cart.

​
skip_add_to_cart_interceptor

Slår Aftersells add to cart-interception helt fra. For hvad interception gør, og hver måde at fritage sig fra den på, se Add to cart-interception. Temaet udfører så tilføjelsen selv, og hvert script, der lytter på den submit, kører igen. Aftersell holder stadig øje med kurvanmodningen på netværket, så draweren åbner som sædvanlig. Du mister den ikke ved at fritage. På temaer, Aftersell genkender, forbliver temaets egen kurv inert, så du får ikke to kurve. På et tema, den ikke genkender, kan temaet åbne sin egen kurv ved siden af din; se Åbner temaets kurv også?.
Denne læses én gang, ved boot. Den virker kun fra et opsætningskald, der kører, før kurven indlæses: din kurvs Initialization-script. Sættes den senere (inde i ready() eller fra en event handler), har det ingen effekt og fejler lydløst.
Dette er et groft værktøj, der deaktiverer interception for hver formular på siden. For kun at undtage én formular skal du i stedet bruge hooket registerSkipAddToCartRule:

​
skip_open_cart_interceptor

At klikke på cart-ikonet åbner Aftersell-draweren. For at gøre det pålideligt stopper Aftersell klikket, så intet andet på siden håndterer det, hvilket også stopper dine scripts fra at se det. Hvis et analytics- eller pixel-event fyrer overalt undtagen på cart-ikonet, er det derfor. Sæt denne til true for at stoppe med at gøre klikket tavst:
Dine listeners kører så, og draweren åbner stadig præcis som før. Klikket navigerer stadig heller ikke til /cart.
Dette gør mindre, end navnet antyder. Den springer ikke cart-ikon-interceptoren over. Den stopper kun med at gøre andre listeners tavse. Aftersell håndterer stadig klikket og åbner stadig din kurv. For en kontrol, som Aftersell helt skal ignorere, brug klassen aftersell-cart-wont-open-cart i stedet; se Add to cart-interception.
I modsætning til skip_add_to_cart_interceptor læses denne ved hvert klik, så du kan sætte den når som helst, og den træder i kraft med det samme: fra ready(), en event-handler eller betinget pr. side.
Nogle temaer reagerer også selv på klik på cart-ikonet. Når Aftersell holder op med at gøre det tavst, vil et tema, der åbner sin egen drawer, gøre det ved siden af din. Hvis du ser to kurve, efter du slår dette til, tilføj klassen aftersell-cart-wont-open-cart til temaets ikon, og åbn kurven fra din egen handler med actions.open().

​
money_format

Tilsidesætter det Shopify-pengeformat, som formatMoney bruger. Standard er din butiks eget format; hvis det ikke er tilgængeligt, falder priser tilbage på $X.XX.
Fordi configure fletter, og formatMoney læser den aktuelle værdi, kan du ændre formatet under kørsel, for eksempel når en valutaskifter udløses:
Dette ændrer, hvordan SDK’et og kurven viser priser. Det ændrer ikke den valuta, kunden opkræves i; det er Shopify Markets.

​
Hvor skal du hen nu

  • Actions: læs og ændr kurven.
  • Hooks: kontrol pr. formular og pr. linje, hvor configure er for bred.
  • Use cases: komplette løsninger på almindelige ønsker.