Skip to main content
Én objektform flyder gennem hele SDK’et. Det er, hvad getCart() returnerer, hvad cart_loaded og cart_updated giver din handler, og hvad en Custom code-blok modtager.
Alle beløb er i valutaens mindste enhed (cents for USD), aldrig en formateret streng. 5779 er $57,79. Brug formatMoney til at vise det.

Kurven

itemCount er ikke altid summen af items. items afspejler den rigtige Shopify-kurv, herunder tilkøbslinjer, som draweren skjuler, såsom fragtbeskyttelse. itemCount er det kundevendte tal, der matcher kurv-badget. Til “hvor mange ting har kunden valgt” skal du bruge itemCount; til at iterere over de linjer, kurven renderer, skal du bruge items.To ting mangler helt i items: linjer skjult med setHidden, og bundle-børn, som flyttes over på deres anker. Begge tæller stadig med i kurvtotalerne, som kommer direkte fra Shopify.

Kurvlinjer

Hver post i items samt itemitem_added og item_removed:
properties kan indeholde input fra kunden, såsom en produktformulars felt til brugerdefineret tekst. Render det som tekst, aldrig som rå HTML.

Identificering af en linje

Brug key til alt, der handler på en linje, og variantId eller productId til alt, der identificerer et produkt:
Den samme variant kan optræde på flere linjer, når properties er forskellige. To graverede krus med forskellig graveringstekst er to linjer, der deler ét variantId. Derfor tager actions key.

Priser på en linje

Tre priser, som er nemme at forveksle:

Bundles

Når linjer grupperes i en bundle, bærer anker-linjen et bundle-objekt. Børnene foldes ind i det og optræder ikke længere selvstændigt i items. Se Gruppér bundle-linjer fra en anden app for, hvordan gruppering sættes op. Hvert barn bærer key (null for en native komponent), title, variantTitle, quantity, perAnchorQty, imageUrl, finalLinePrice, originalLinePrice og compareAtPrice.

Abonnementsplaner

En linjes aktive plan er sellingPlan, eller null for et engangskøb. For et svar for hele kurven skal du læse hasSubscriptionItems frem for selv at scanne linjerne, da den også tæller tilkøbslinjer, som items viser, men itemCount springer over:
De tilgængelige planer på en linje, dem i vælgeren, er ikke på cart-objektet. Form dem med registerSubscriptionOptionsTransform og registerDefaultSubscriptionOptionSelector.

Hvor skal du hen nu

  • Actions: læs og ændr kurven.
  • Events: hvor dette objekt kommer fra.
  • Hooks: tilføj dine egne data til en linje med en enricher.
  • Use cases: komplette løsninger, der læser disse felter.