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.
Controlla se il drawer si apre quando un acquirente aggiunge un prodotto.
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.
open_on_add_to_cart, senza bisogno di questa opzione.
open_on_add_to_cart lo avrebbe consentito. Con open_on_add_to_cart: 'never', questa opzione non fa nulla.
Esegue la validazione nativa dei form del browser (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.
required fuori posto da qualche parte nel form prodotto inizierebbe altrimenti a bloccare silenziosamente l’add-to-cart.
Disattiva completamente l’intercettazione dell’add-to-cart di Aftersell. Per cosa fa l’intercettazione e ogni modo per uscirne, vedi Intercettazione dell’add-to-cart.
Il tema esegue quindi l’aggiunta da solo, e ogni script in ascolto su quel submit viene eseguito di nuovo. Aftersell continua a osservare la richiesta al carrello sulla rete, quindi il drawer si apre come al solito. Non lo perdi disattivando l’intercettazione. Sui temi che Aftersell riconosce, il carrello del tema resta inerte, quindi non ottieni due carrelli. Su un tema che non riconosce, il tema potrebbe aprire il proprio carrello accanto al tuo; vedi Si aprirà anche il carrello del tema?.
registerSkipAddToCartRule:
true per smettere di silenziare il clic:
/cart.
A differenza di 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.
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.