Skip to main content

​
Visão geral

Esta configuração faz duas coisas:
  1. Enfileira as chamadas Ajax de carrinho da Shopify. Quando vários scripts acessam a Ajax cart API da Shopify (/cart/add, /cart/add.js, /cart/update.js, /cart/change.js) ao mesmo tempo, a Shopify às vezes descarta uma das alterações. O Upcart força essas chamadas a serem executadas uma de cada vez, garantindo que cada atualização seja registrada. Este é o objetivo principal da configuração.
  2. Recua do Add to Cart. Ela também desativa o tratamento integrado de Add to Cart do Upcart, para que um app ou tema que precise de controle total desse fluxo não entre em conflito com ele.
Os dois comportamentos estão vinculados a uma única caixa de seleção — você não pode ativar o enfileiramento de requisições sem também abrir mão do tratamento de Add to Cart do Upcart.

​
Onde encontrar

Abra o editor do carrinho, vá para Settings > Cart settings e expanda Advanced Settings.
Procure por “Enhanced Ajax API compatibility”.

​
Como funciona

O Upcart mantém controle total sobre o processo de Add to Cart. Isso garante um comportamento consistente e permite que o Upcart impeça que outros apps ou scripts substituam o fluxo do carrinho. Esta é a configuração recomendada para a maioria das lojas. Mantenha-a desativada, a menos que você esteja enfrentando problemas específicos em que o Upcart não intercepta eventos de adicionar ao carrinho do seu tema ou de outros apps.

​
Ativada

O Upcart deixará de gerenciar o processo de Add to Cart. Isso permite que outros apps, JavaScript personalizado ou seu tema modifiquem o carrinho sem interferência. Ative esta configuração SOMENTE quando:
  • Sua loja usa uma AJAX cart API fora do padrão
  • O Upcart não está interceptando eventos de adicionar ao carrinho do seu tema ou de outros apps
  • Você precisa que apps de terceiros tenham controle direto sobre o comportamento do carrinho
Compensações importantes quando ativada:
  • Outros apps podem redirecionar os clientes para a página de carrinho da Shopify em vez de abrir o drawer do Upcart
  • Você pode enfrentar loops de redirecionamento ou comportamento inesperado do carrinho
  • O Upcart não pode impedir que apps externos alterem o comportamento do carrinho
Se a ativação causar loops de redirecionamento:
  1. Desative esta configuração
  2. Use a API manual do Upcart (upcartRegisterAddToCart) em vez disso
  3. Consulte os guias de integração de apps específicos (por exemplo, Replo)

​
Testes

Depois de alterar esta configuração:
  1. Clique em Save
  2. Teste adicionar produtos ao carrinho
  3. Verifique se o drawer do Upcart abre corretamente
  4. Confirme que você não está sendo redirecionado para a página de carrinho da Shopify
Se você tiver problemas após a ativação, desative a configuração e entre em contato com o suporte para soluções alternativas.