Configure

configure(config) establece cómo se comporta el carrito. Es una llamada de configuración, así que es segura al principio de tu script, antes de que el carrito se haya cargado.

window.aftersell.cart.configure({
  open_on_add_to_cart: 'always',
  money_format: '${{amount}} USD',
});

Puedes llamarla más de una vez y los valores se fusionan. Una llamada posterior anula solo las claves que nombra, dejando el resto intacto.

Pasar undefined borra una clave en lugar de omitirla. configure({ open_on_add_to_cart: undefined }) restablece esa opción a su valor predeterminado, descartando lo que una llamada anterior haya establecido. Para dejar una opción intacta, omite la clave por completo.

Opciones

Opción	Valores	Predeterminado	Propósito
`open_on_add_to_cart`	`'always'`, `'never'`, `'default'`	`'default'`	Si el drawer se abre cuando se agrega un artículo.
`open_on_background_add`	`boolean`	`false`	Abrir también cuando algo más agrega al carrito.
`validate_form_on_add_to_cart`	`boolean`	`false`	Bloquear el agregado si el formulario del producto es inválido.
`skip_add_to_cart_interceptor`	`boolean`	`false`	Desactivar por completo la intercepción de agregar al carrito de Aftersell.
`skip_open_cart_interceptor`	`boolean`	`false`	Deja que un clic en el icono del carrito llegue a tus otros scripts.
`money_format`	string	formato de la tienda	Anular el formato que usa `formatMoney`.

open_on_add_to_cart

Controla si el drawer se abre cuando un comprador agrega un producto.

Valor	Comportamiento
`'always'`	Abrir siempre el drawer al agregar.
`'never'`	No abrirlo nunca; el artículo se agrega silenciosamente.
`'default'`	Seguir la configuración Open cart when an item is added del editor del carrito.

// Always open, regardless of the merchant's cart setting.
window.aftersell.cart.configure({ open_on_add_to_cart: 'always' });

Un uso común es mantener el drawer cerrado en una página específica dejando la configuración del comerciante intacta en el resto:

if (window.location.pathname.startsWith('/collections/')) {
  window.aftersell.cart.configure({ open_on_add_to_cart: 'never' });
}

Si solo quieres esto activado para toda la tienda, ya es una configuración: Cart settings → Content → Behavior → Open cart when an item is added. Usa configure cuando la respuesta dependa de la página, el comprador o algo que solo tu código sabe.

open_on_background_add

Establece esto en true para abrir el drawer también en agregados en segundo plano: aquellos que Aftersell detectó pero no manejó por sí mismo. Un agregado cuenta como en segundo plano cuando ocurre cualquiera de estas dos cosas:

llegó a través de los eventos estándar de carrito de Shopify (siempre se trata como en segundo plano, sin importar qué lo haya disparado), o
Aftersell vio la petición al carrito en la red sin ningún clic o pulsación de tecla confiable en los ~3 segundos anteriores; por ejemplo, otra app o script escribiendo en el carrito.

Un agregado que Aftersell vio en la red y que sí siguió a un clic del comprador no es un agregado en segundo plano: ya abre el drawer según open_on_add_to_cart, sin necesidad de esta opción.

window.aftersell.cart.configure({ open_on_background_add: true });

Esta es una compuerta adicional, no una anulación: un agregado en segundo plano abre el drawer solo si open_on_add_to_cart también lo hubiera permitido. Con open_on_add_to_cart: 'never', esta opción no hace nada.

Recurre a esto cuando un botón de agregar de terceros agrega el artículo correctamente pero deja el drawer cerrado. Si el artículo nunca llega al carrito, ese es un problema de intercepción. Consulta skip_add_to_cart_interceptor y el caso de uso del constructor de páginas.

validate_form_on_add_to_cart

Ejecuta la validación nativa de formularios del navegador (reportValidity()) antes de agregar, y cancela el agregado si el formulario es inválido. Úsalo cuando tu formulario de producto tiene campos obligatorios (un mensaje de grabado, una nota de regalo, una casilla obligatoria) que los compradores actualmente pueden omitir.

window.aftersell.cart.configure({ validate_form_on_add_to_cart: true });

El navegador muestra su propio mensaje de validación en el campo problemático. Desactivado de forma predeterminada, porque un tema con un atributo required extraviado en algún lugar del formulario de producto empezaría, de lo contrario, a bloquear silenciosamente el agregar al carrito.

skip_add_to_cart_interceptor

Desactiva por completo la intercepción de agregar al carrito de Aftersell. Para saber qué hace la intercepción y todas las formas de excluirse de ella, consulta Intercepción de agregar al carrito. El tema entonces realiza el agregado por sí mismo, y cada script que escuche ese envío vuelve a ejecutarse. Aftersell sigue vigilando la petición al carrito en la red, así que el drawer se abre como siempre. No lo pierdes al optar por salir. En los temas que Aftersell reconoce, el propio carrito del tema permanece inerte, así que no obtendrás dos carritos. En un tema que no reconoce, el tema puede abrir su propio carrito junto al tuyo; consulta ¿Se abrirá también el carrito del tema?.

window.aftersell.cart.configure({ skip_add_to_cart_interceptor: true });

Esta se lee una vez, al arrancar. Solo funciona desde una llamada de configuración que se ejecuta antes de que el carrito se cargue: el script de Initialization de tu carrito. Establecerla después (dentro de ready(), o desde un handler de eventos) no tiene efecto, y falla silenciosamente.

Este es un instrumento contundente que deshabilita la intercepción para todos los formularios de la página. Para eximir solo un formulario, usa el hook registerSkipAddToCartRule en su lugar:

// Preferred: exempt only the forms you own.
window.aftersell.cart.hooks.registerSkipAddToCartRule((form) =>
  form.hasAttribute('data-skip-aftersell')
);

skip_open_cart_interceptor

Al hacer clic en el icono del carrito, se abre el drawer de Aftersell. Para hacerlo de forma confiable, Aftersell detiene el clic para que nada más en la página lo maneje, lo que también impide que tus scripts lo vean. Si un evento de analíticas o de pixel se dispara en todas partes excepto en el icono del carrito, esta es la razón. Establece esto en true para dejar de silenciar el clic:

window.aftersell.cart.configure({ skip_open_cart_interceptor: true });

Tus listeners se ejecutan entonces, y el drawer sigue abriéndose exactamente como antes. El clic tampoco navega a /cart.

Esto hace menos de lo que sugiere su nombre. No omite el interceptor del icono del carrito. Solo evita que silencie a otros listeners. Aftersell sigue manejando el clic y sigue abriendo tu carrito. Para un control que Aftersell deba ignorar por completo, usa la clase aftersell-cart-wont-open-cart en su lugar; consulta Intercepción de agregar al carrito.

A diferencia de skip_add_to_cart_interceptor, esta se lee en cada clic, así que puedes establecerla en cualquier momento y surte efecto de inmediato: desde ready(), un handler de eventos o condicionalmente por página.

Algunos temas también responden por sí mismos al clic en el icono del carrito. Una vez que Aftersell deja de silenciarlo, un tema que abre su propio drawer lo hará junto al tuyo. Si ves dos carritos después de activar esto, agrega la clase aftersell-cart-wont-open-cart al icono del tema y abre el carrito desde tu propio handler con actions.open().

money_format

Anula el formato de dinero de Shopify que formatMoney usa. El valor predeterminado es el formato propio de tu tienda; si no está disponible, los precios recurren a $X.XX.

window.aftersell.cart.configure({ money_format: '${{amount}} USD' });

// Later:
window.aftersell.cart.actions.formatMoney(5779); // "$57.79 USD"

Como configure fusiona y formatMoney lee el valor en vivo, puedes cambiar el formato en tiempo de ejecución, por ejemplo cuando se dispara un selector de moneda:

window.myTheme.onCurrencyChange((currency) => {
  window.aftersell.cart.configure({ money_format: FORMATS[currency] });
  window.aftersell.cart.actions.visualRefresh(); // repaint prices already on screen
});

Esto cambia cómo el SDK y el carrito muestran los precios. No cambia la moneda que se le cobra al comprador; eso es Shopify Markets.

Adónde ir después

Acciones: lee y cambia el carrito.
Hooks: control por formulario y por línea, donde configure es demasiado amplio.
Casos de uso: soluciones completas a solicitudes comunes.

Primeros pasos

Página de inicio

Mejores prácticas

Ventas adicionales poscompra

Carrito

Ventas adicionales en el pago (Shopify Plus)

Página de agradecimiento

Ventas adicionales en la página de producto

Rokt Thanks

Estrategias

Analíticas y seguimiento

Integraciones

Aftersell MCP

Facturación y cuenta

Solución de problemas

Opciones

open_on_add_to_cart

open_on_background_add

validate_form_on_add_to_cart

skip_add_to_cart_interceptor

skip_open_cart_interceptor

money_format

Adónde ir después

​Opciones

​open_on_add_to_cart

​open_on_background_add

​validate_form_on_add_to_cart

​skip_add_to_cart_interceptor

​skip_open_cart_interceptor

​money_format

​Adónde ir después

Opciones

open_on_add_to_cart

open_on_background_add

validate_form_on_add_to_cart

skip_add_to_cart_interceptor

skip_open_cart_interceptor

money_format

Adónde ir después