configure(config) imposta come si comporta il carrello. È una chiamata di set-up, quindi è sicura in cima al tuo script, prima che il carrello si sia caricato.
Puoi chiamarla più di una volta e i valori si fondono. Una chiamata successiva sovrascrive solo le chiavi che nomina, lasciando intatto il resto.
Passare undefined cancella una chiave invece di saltarla. configure({ open_on_add_to_cart: undefined }) reimposta quell’opzione al suo valore predefinito, scartando ciò che una chiamata precedente aveva impostato. Per lasciare in pace un’opzione, ometti completamente la chiave.
Controlla se il drawer si apre quando un acquirente aggiunge un prodotto.
Un uso comune è tenere il drawer chiuso su una pagina specifica lasciando invariata l’impostazione del merchant ovunque altrove:
Se vuoi semplicemente attivarlo per tutto lo store, è già un’impostazione: Cart settings → Content → Behavior → Open cart when an item is added. Usa configure quando la risposta dipende dalla pagina, dall’acquirente o da qualcosa che solo il tuo codice conosce.
true per aprire il drawer anche per le aggiunte in background — quelle che Aftersell ha rilevato ma non ha gestito direttamente.
Un’aggiunta conta come background quando:
- è arrivata tramite gli eventi standard del carrello di Shopify (sempre trattati come background, qualunque cosa li abbia attivati), oppure
- Aftersell ha visto la richiesta al carrello sulla rete senza alcun clic o pressione di tasto attendibile nei ~3 secondi precedenti — per esempio un’altra app o script che scrive nel carrello.
Un’aggiunta che Aftersell ha visto sulla rete e che ha seguito un clic dell’acquirente non è un’aggiunta in background: apre già il drawer secondo open_on_add_to_cart, senza bisogno di questa opzione.
Questo è un gate aggiuntivo, non un override: un’aggiunta in background apre il drawer solo se anche open_on_add_to_cart lo avrebbe consentito. Con open_on_add_to_cart: 'never', questa opzione non fa nulla.
Ricorri a questa opzione quando un pulsante di aggiunta di terze parti aggiunge correttamente l’articolo ma lascia il drawer chiuso. Se l’articolo non raggiunge mai il carrello, è un problema di intercettazione. Vedi skip_add_to_cart_interceptor e il caso d’uso del page builder. reportValidity()) prima di aggiungere, e annulla l’aggiunta se il form non è valido. Usalo quando il tuo form prodotto ha campi obbligatori (un messaggio di incisione, una nota regalo, una checkbox obbligatoria) che gli acquirenti attualmente possono saltare.
Il browser mostra il proprio messaggio di validazione sul campo problematico. Disattivato per impostazione predefinita, perché un tema con un attributo required fuori posto da qualche parte nel form prodotto inizierebbe altrimenti a bloccare silenziosamente l’add-to-cart.
skip_add_to_cart_interceptor
Questa opzione viene letta una sola volta, al boot. Funziona solo da una chiamata di set-up eseguita prima del caricamento del carrello: lo script di Initialization del tuo carrello. Impostarla più tardi (dentro ready(), o da un handler di evento) non ha alcun effetto e fallisce silenziosamente.
registerSkipAddToCartRule:
skip_open_cart_interceptor
true per smettere di silenziare il clic:
I tuoi listener vengono quindi eseguiti, e il drawer si apre comunque esattamente come prima. Il clic inoltre continua a non navigare verso /cart.
Fa meno di quanto il nome suggerisca. Non salta l’interceptor dell’icona del carrello. Impedisce solo che silenzi altri listener. Aftersell continua a gestire il clic e continua ad aprire il tuo carrello. Per un controllo che Aftersell debba ignorare completamente, usa invece la classe aftersell-cart-wont-open-cart; vedi Intercettazione dell’add-to-cart. skip_add_to_cart_interceptor, questa viene letta a ogni clic, quindi puoi impostarla in qualunque momento e ha effetto immediatamente: da ready(), da un handler di evento o in modo condizionale per pagina.
Alcuni temi rispondono da soli anche al clic sull’icona del carrello. Una volta che Aftersell smette di silenziarlo, un tema che apre il proprio drawer lo farà accanto al tuo. Se vedi due carrelli dopo aver attivato questa opzione, aggiungi la classe aftersell-cart-wont-open-cart all’icona del tema e apri il carrello dal tuo handler con actions.open(). formatMoney usa. Per impostazione predefinita è il formato del tuo store; se non è disponibile, i prezzi ripiegano su $X.XX.
Poiché configure fonde i valori e formatMoney legge il valore corrente, puoi cambiare il formato a runtime, per esempio quando scatta un cambio di valuta:
Questo cambia il modo in cui l’SDK e il carrello mostrano i prezzi. Non cambia la valuta addebitata all’acquirente; quella è Shopify Markets.
- Azioni: leggi e modifica il carrello.
- Hook: controllo per singolo form e per singola riga, dove
configure è troppo generico.
- Casi d’uso: soluzioni complete alle richieste più comuni.
