configure(config) définit le comportement du panier. C’est un appel de configuration, donc il est sûr tout en haut de votre script, avant le chargement du panier.
Contrôle si le tiroir s’ouvre lorsqu’un acheteur ajoute un produit.
Si vous voulez simplement activer cela pour toute la boutique, c’est déjà un paramètre : Cart settings → Content → Behavior → Open cart when an item is added. Utilisez
configure lorsque la réponse dépend de la page, de l’acheteur ou de quelque chose que seul votre code connaît.true pour ouvrir aussi le tiroir lors des ajouts en arrière-plan, c’est-à-dire ceux qu’Aftersell a détectés mais n’a pas gérés lui-même.
Un ajout compte comme un ajout en arrière-plan lorsque :
- il est arrivé via les événements de panier standard de Shopify (toujours traité comme un ajout en arrière-plan, quel qu’en soit le déclencheur), ou
- Aftersell a vu la requête de panier passer sur le réseau sans clic ni frappe de touche fiable dans les ~3 secondes précédentes. Par exemple, une autre application ou un autre script qui écrit dans le panier.
open_on_add_to_cart, sans besoin de cette option.
open_on_add_to_cart l’aurait également permis. Avec open_on_add_to_cart: 'never', cette option ne fait rien.
Exécute la validation de formulaire native du navigateur (reportValidity()) avant l’ajout, et annule l’ajout si le formulaire est invalide. Utilisez-la lorsque votre formulaire produit comporte des champs obligatoires (un message de gravure, une note cadeau, une case à cocher obligatoire) que les acheteurs peuvent actuellement contourner.
required égaré quelque part dans le formulaire produit se mettrait sinon à bloquer silencieusement l’ajout au panier.
Désactive complètement l’interception d’ajout au panier d’Aftersell. Pour savoir ce que fait l’interception et connaître toutes les façons de vous en désinscrire, consultez Interception de l’ajout au panier.
Le thème effectue alors l’ajout lui-même, et chaque script qui écoute cette soumission s’exécute à nouveau. Aftersell continue de surveiller la requête de panier sur le réseau, donc le tiroir s’ouvre comme d’habitude. Vous ne le perdez pas en vous désinscrivant. Sur les thèmes qu’Aftersell reconnaît, le propre panier du thème reste inerte, donc vous n’aurez pas deux paniers. Sur un thème qu’il ne reconnaît pas, le thème peut ouvrir son propre panier à côté du vôtre ; consultez Le panier du thème s’ouvrira-t-il aussi ?.
registerSkipAddToCartRule :
true pour arrêter de faire taire le clic :
/cart non plus.
Contrairement à skip_add_to_cart_interceptor, celle-ci est lue à chaque clic, vous pouvez donc la définir à n’importe quel moment et elle prend effet immédiatement : depuis ready(), un gestionnaire d’événement, ou conditionnellement par page.
Certains thèmes réagissent aussi eux-mêmes au clic sur l’icône du panier. Une fois qu’Aftersell cesse de le faire taire, un thème qui ouvre son propre tiroir le fera à côté du vôtre. Si vous voyez deux paniers après avoir activé cette option, ajoutez la classe
aftersell-cart-wont-open-cart à l’icône du thème et ouvrez le panier depuis votre propre gestionnaire avec actions.open().formatMoney. Par défaut, il s’agit du format propre à votre boutique ; s’il est indisponible, les prix retombent sur $X.XX.
configure fusionne et que formatMoney lit la valeur en direct, vous pouvez changer le format à l’exécution, par exemple lorsqu’un sélecteur de devise se déclenche :
Cela change la façon dont le SDK et le panier affichent les prix. Cela ne change pas la devise facturée à l’acheteur ; c’est le rôle de Shopify Markets.
- Actions : lire et modifier le panier.
- Hooks : contrôle par formulaire et par ligne, là où
configureest trop large. - Cas d’usage : des solutions complètes aux demandes courantes.