Skip to main content
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.
Vous pouvez l’appeler plusieurs fois et les valeurs fusionnent. Un appel ultérieur ne remplace que les clés qu’il nomme, en laissant le reste intact.
Passer undefined efface une clé au lieu de l’ignorer. configure({ open_on_add_to_cart: undefined }) réinitialise cette option à sa valeur par défaut, en écartant ce qu’un appel précédent avait défini. Pour laisser une option intacte, omettez complètement la clé.

​
Options

​
open_on_add_to_cart

Contrôle si le tiroir s’ouvre lorsqu’un acheteur ajoute un produit.
Un usage courant consiste à garder le tiroir fermé sur une page spécifique tout en laissant le paramètre du marchand intact partout ailleurs :
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.

​
open_on_background_add

Définissez cette option sur 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.
Un ajout qu’Aftersell a vu sur le réseau et qui a bien suivi le clic d’un acheteur n’est pas un ajout en arrière-plan : il ouvre déjà le tiroir selon open_on_add_to_cart, sans besoin de cette option.
C’est une condition supplémentaire, pas une surcharge : un ajout en arrière-plan n’ouvre le tiroir que si open_on_add_to_cart l’aurait également permis. Avec open_on_add_to_cart: 'never', cette option ne fait rien.
Utilisez cette option lorsqu’un bouton d’ajout tiers ajoute correctement l’article mais laisse le tiroir fermé. Si l’article n’atteint jamais le panier du tout, c’est un problème d’interception. Consultez skip_add_to_cart_interceptor et le cas d’usage constructeur de pages.

​
validate_form_on_add_to_cart

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.
Le navigateur affiche son propre message de validation sur le champ fautif. Désactivée par défaut, car un thème avec un attribut required égaré quelque part dans le formulaire produit se mettrait sinon à bloquer silencieusement l’ajout au panier.

​
skip_add_to_cart_interceptor

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 ?.
Cette option est lue une seule fois, au démarrage. Elle ne fonctionne que depuis un appel de configuration exécuté avant le chargement du panier : le script Initialization de votre panier. La définir plus tard (dans ready(), ou depuis un gestionnaire d’événement) n’a aucun effet, et échoue silencieusement.
C’est un instrument grossier qui désactive l’interception pour chaque formulaire de la page. Pour exempter un seul formulaire, utilisez plutôt le hook registerSkipAddToCartRule :

​
skip_open_cart_interceptor

Cliquer sur l’icône du panier ouvre le tiroir Aftersell. Pour le faire de manière fiable, Aftersell arrête le clic afin que rien d’autre sur la page ne le traite, ce qui empêche aussi vos scripts de le voir. Si un événement d’analyse ou de pixel se déclenche partout sauf sur l’icône du panier, c’est pour cette raison. Définissez cette option sur true pour arrêter de faire taire le clic :
Vos écouteurs s’exécutent alors, et le tiroir s’ouvre exactement comme avant. Le clic ne navigue toujours pas vers /cart non plus.
Cette option fait moins que ce que son nom suggère. Elle ne saute pas l’intercepteur de l’icône du panier. Elle l’empêche seulement de faire taire les autres écouteurs. Aftersell traite toujours le clic et ouvre toujours votre panier. Pour un contrôle qu’Aftersell doit ignorer complètement, utilisez plutôt la classe aftersell-cart-wont-open-cart ; consultez Interception de l’ajout au panier.
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().

​
money_format

Remplace le format monétaire Shopify utilisé par formatMoney. Par défaut, il s’agit du format propre à votre boutique ; s’il est indisponible, les prix retombent sur $X.XX.
Comme 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.

​
Pour aller plus loin

  • Actions : lire et modifier le panier.
  • Hooks : contrôle par formulaire et par ligne, là où configure est trop large.
  • Cas d’usage : des solutions complètes aux demandes courantes.