Skjul og omdøb kurvlinjer

Skjul linjer, kunden ikke bør se, omdøb linjer, der læses dårligt, og styr rækkefølgen, alt renderes i, alt sammen uden at røre ved, hvad der faktisk er i kurven. Dette erstatter det ældre mønster med at skjule kurvelementer med CSS eller style.display = 'none'. En line transform anvendes, hver gang kurven renderes, så den overlever opdateringer, re-renders og genåbninger af skuffen.

Skjul en linje

// Hide free lines from the drawer. The cart total is unchanged.
window.aftersell.cart.hooks.registerLineTransform((line) => {
  if (line.finalLinePrice === 0) {
    line.setHidden(true);
  }
});

At skjule er ikke at fjerne. En skjult linje bliver i kundens kurv, bliver i totalen og går med til checkout; den tegnes bare ikke i skuffen. Den forsvinder dog fra getCart().items og itemCount, så din egen kode holder også op med at se den. Vil du have den væk for alvor, så brug removeItem.

Almindelige ting, der er værd at skjule:

window.aftersell.cart.hooks.registerLineTransform((line) => {
  // An app-injected line, tagged with a private property.
  if (line.properties?._bundle_child) {
    line.setHidden(true);
  }

  // A specific SKU that shouldn't be shopper-managed.
  if (line.variantId === HIDDEN_VARIANT_ID) {
    line.setHidden(true);
  }

  // Gift cards issued by a loyalty app.
  if (line.isGiftCard && line.finalLinePrice === 0) {
    line.setHidden(true);
  }
});

Omdøb en linje

window.aftersell.cart.hooks.registerLineTransform((line) => {
  // Flag discounted lines.
  if (line.finalLinePrice < line.originalLinePrice) {
    line.setTitle(`${line.title} (On sale)`);
  }

  // Make the subscription cadence read naturally.
  if (line.sellingPlan) {
    line.setVariantTitle(`Delivered ${line.sellingPlan.name.toLowerCase()}`);
  }

  // Drop a meaningless variant label.
  if (line.variantTitle === 'Default Title') {
    line.setVariantTitle(null);
  }
});

De fire settere, der er tilgængelige på en linje:

Setter	Effekt
`setHidden(bool)`	Skjul linjen fra skuffen.
`setTitle(string)`	Ændr den viste titel.
`setVariantTitle(string \| null)`	Ændr den viste variantetiket. `null` fjerner den.
`setInternalProperties(obj)`	Flet render-only properties ind, som en Custom code-blok kan læse. Gemmes aldrig i Shopify.

Styr rækkefølgen

En comparator har samme form, som Array.prototype.sort forventer, og kører efter skjul og omdøbning:

// Subscriptions first, then everything else.
window.aftersell.cart.hooks.registerLineComparator((lineA, lineB) => {
  return (lineB.sellingPlan ? 1 : 0) - (lineA.sellingPlan ? 1 : 0);
});

// Push free gifts and add-ons to the bottom.
window.aftersell.cart.hooks.registerLineComparator((lineA, lineB) => {
  return (lineA.finalLinePrice === 0 ? 1 : 0) - (lineB.finalLinePrice === 0 ? 1 : 0);
});

Returnér 0 for par, du ikke bekymrer dig om. Comparators sammensættes som tie-breakers, så den første, der returnerer en værdi forskellig fra nul, afgør det par, og at returnere 0 giver beslutningen videre til den næste i stedet for at påtvinge en rækkefølge.

Skjul en hel blok, ikke en linje

En line transform arbejder på kurvlinjer. For at vise forskellige blok-indstillinger efter land, marked eller valuta (for eksempel forskellige Rewards-niveauer) skal du bruge betingelser i cart editoren. Ingen kode kræves, og det overlever redesigns af kurven. Kurvtotal og kurvindhold er ikke betingelsestyper i editoren. Ræk ud efter SDK’et, når din regel er noget, betingelser ikke kan udtrykke (produkt-ID’er i kurven, en custom total og så videre). I det tilfælde forespørg shadow root’en efter en offentlig cart-external-*-klasse:

window.aftersell.cart.events.on('cart_updated', (state) => {
  const root = window.aftersell.cart.shadowRoot;
  if (!root) return;

  const rewards = root.querySelector('.cart-external-rewards');
  if (!rewards) return;

  const hasExcluded = state.items.some((line) => EXCLUDED_PRODUCT_IDS.includes(line.productId));
  rewards.style.display = hasExcluded ? 'none' : '';
});

Dette kører efter hver render, så blokken kan blinke frem, før din kode skjuler den. Betinget rendering har ikke det problem, så foretræk det, hvor det passer.

Ting du skal have styr på

Transforms er opsætningskald. Registrér dem øverst i dit Initialization-script; ingen ready() nødvendig.
Alles transforms kører. Din sammensættes med alle registreret af andre apps. Du kan ikke erstatte deres, og de kan ikke droppe din.
En transform kan ikke ændre pris, antal eller identitet. Den ændrer kun, hvad der renderes. Brug actions til rigtige ændringer.
En transform, der kaster, springes over stille. Resten kører stadig. Tjek aftersellCartDebugEvents under udviklingen.
registerLineTransform returnerer en afregistreringsfunktion, hvis du senere skal fortryde den.

Hvor du kan gå hen herfra

Hooks: den fulde hook-reference.
Cart-objektet: hvert felt du kan forgrene på.
Custom CSS: cart-external-*-klassekonventionen.

Kom godt i gang

Startside

Bedste praksis

Mersalg efter køb

Aftersell-kurv

Mersalg ved checkout (Shopify Plus)

Takkeside

Mersalg på produktsiden

Rokt Thanks

Strategier

Analyser og sporing

Integrationer

Aftersell MCP

Fakturering og konto

Fejlfinding

Skjul en linje

Omdøb en linje

Styr rækkefølgen

Skjul en hel blok, ikke en linje

Ting du skal have styr på

Hvor du kan gå hen herfra

​Skjul en linje

​Omdøb en linje

​Styr rækkefølgen

​Skjul en hel blok, ikke en linje

​Ting du skal have styr på

​Hvor du kan gå hen herfra

Skjul en linje

Omdøb en linje

Styr rækkefølgen

Skjul en hel blok, ikke en linje

Ting du skal have styr på

Hvor du kan gå hen herfra