Skip to main content
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.
Você pode chamá-la mais de uma vez e os valores são mesclados. Uma chamada posterior sobrescreve apenas as chaves que nomeia, deixando o restante intacto.
Passar undefined limpa uma chave em vez de ignorá-la. configure({ open_on_add_to_cart: undefined }) redefine essa opção para o padrão, descartando o que uma chamada anterior definiu. Para deixar uma opção intocada, omita a chave por completo.

​
Opções

​
open_on_add_to_cart

Controla se o drawer abre quando um comprador adiciona um produto.
Um uso comum é manter o drawer fechado em uma página específica, deixando a configuração do lojista intacta em todos os outros lugares:
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.

​
open_on_background_add

Defina como 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.
Uma adição que o Aftersell viu na rede e que seguiu um clique do comprador não é uma adição em segundo plano: ela já abre o drawer conforme open_on_add_to_cart, sem precisar desta opção.
Isto é um portão adicional, não uma sobrescrita: uma adição em segundo plano abre o drawer apenas se open_on_add_to_cart também a teria permitido. Com open_on_add_to_cart: 'never', esta opção não faz nada.
Recorra a isto quando um botão de adicionar de terceiros adiciona o item corretamente, mas deixa o drawer fechado. Se o item nunca chega ao carrinho, isso é um problema de interceptação. Veja skip_add_to_cart_interceptor e o caso de uso de page builder.

​
validate_form_on_add_to_cart

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.
O navegador mostra a própria mensagem de validação no campo problemático. Desativado por padrão, porque um tema com um atributo required esquecido em algum lugar do formulário de produto começaria a bloquear silenciosamente a adição ao carrinho.

​
skip_add_to_cart_interceptor

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?.
Esta opção é lida uma vez, na inicialização. Só funciona a partir de uma chamada de configuração que roda antes de o carrinho carregar: o script de Initialization do seu carrinho. Defini-la depois (dentro de ready() ou em um handler de evento) não tem efeito e falha silenciosamente.
Este é um instrumento bruto que desativa a interceptação para todos os formulários da página. Para isentar apenas um formulário, use o hook registerSkipAddToCartRule:

​
skip_open_cart_interceptor

Clicar no ícone do carrinho abre o drawer do Aftersell. Para fazer isso de forma confiável, o Aftersell interrompe o clique para que nada mais na página o trate, o que também impede que os seus scripts o vejam. Se um evento de analytics ou de pixel dispara em toda parte, menos no ícone do carrinho, é por isso. Defina como true para parar de silenciar o clique:
Seus listeners então rodam, e o drawer ainda abre exatamente como antes. O clique também continua sem navegar para /cart.
Isto faz menos do que o nome sugere. Não pula o interceptor do ícone do carrinho. Só o impede de silenciar outros listeners. O Aftersell ainda trata o clique e ainda abre o seu carrinho. Para um controle que o Aftersell deve ignorar completamente, use a classe aftersell-cart-wont-open-cart no lugar; veja Interceptação do adicionar ao carrinho.
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().

​
money_format

Substitui o formato de moeda do Shopify que formatMoney usa. O padrão é o formato da sua loja; se ele estiver indisponível, os preços recorrem a $X.XX.
Como 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.

​
Para onde ir agora

  • 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.