configure(config) define como o carrinho se comporta. É uma chamada de configuração, então é segura logo no topo do seu script, antes de o carrinho carregar.
Controla se o drawer abre quando um comprador adiciona um produto.
Se você só quer isso ativado para a loja inteira, já existe uma configuração: Cart settings → Content → Behavior → Open cart when an item is added. Use
configure quando a resposta depende da página, do comprador ou de algo que só o seu código sabe.true para também abrir o drawer em adições em segundo plano — aquelas que o Aftersell detectou mas não tratou por conta própria.
Uma adição conta como em segundo plano quando:
- ela chegou pelos eventos padrão de carrinho do Shopify (sempre tratada como segundo plano, seja qual for o gatilho), ou
- o Aftersell viu a requisição de carrinho na rede sem nenhum clique ou tecla confiável nos ~3 segundos anteriores — outro app ou script escrevendo no carrinho, por exemplo.
open_on_add_to_cart, sem precisar desta opção.
open_on_add_to_cart também a teria permitido. Com open_on_add_to_cart: 'never', esta opção não faz nada.
Executa a validação de formulário nativa do navegador (reportValidity()) antes de adicionar, e cancela a adição se o formulário for inválido. Use quando o seu formulário de produto tem campos obrigatórios (uma mensagem de gravação, uma nota de presente, um checkbox obrigatório) que os compradores atualmente conseguem pular.
required esquecido em algum lugar do formulário de produto começaria a bloquear silenciosamente a adição ao carrinho.
Desativa completamente a interceptação de adição ao carrinho do Aftersell. Para saber o que a interceptação faz e todas as formas de sair dela, veja Interceptação do adicionar ao carrinho.
O tema então realiza a adição por conta própria, e todo script escutando aquele submit volta a rodar. O Aftersell ainda observa a requisição de carrinho na rede, então o drawer abre como de costume. Você não perde isso ao optar por sair. Em temas que o Aftersell reconhece, o próprio carrinho do tema permanece inerte, então você não fica com dois carrinhos. Em um tema que ele não reconhece, o tema pode abrir o próprio carrinho ao lado do seu; veja O carrinho do tema também vai abrir?.
registerSkipAddToCartRule:
true para parar de silenciar o clique:
/cart.
Ao contrário de skip_add_to_cart_interceptor, esta é lida a cada clique, então você pode defini-la em qualquer ponto e ela passa a valer imediatamente: a partir de ready(), de um handler de evento ou condicionalmente por página.
Alguns temas também respondem ao clique no ícone do carrinho por conta própria. Uma vez que o Aftersell deixa de silenciá-lo, um tema que abre o próprio drawer vai fazê-lo ao lado do seu. Se você vir dois carrinhos depois de ativar isso, adicione a classe
aftersell-cart-wont-open-cart ao ícone do tema e abra o carrinho a partir do seu próprio handler com actions.open().formatMoney usa. O padrão é o formato da sua loja; se ele estiver indisponível, os preços recorrem a $X.XX.
configure mescla e formatMoney lê o valor atual, você pode alterar o formato em tempo de execução, por exemplo quando um seletor de moeda dispara:
Isto altera como o SDK e o carrinho exibem preços. Não altera a moeda cobrada do comprador; isso é o Shopify Markets.
- Ações: leia e altere o carrinho.
- Hooks: controle por formulário e por linha, quando
configureé amplo demais. - Casos de uso: soluções completas para pedidos comuns.