- Exibe um popup automático sempre que um cliente adiciona um produto ao carrinho na sua loja
- Confirma visualmente a adição com mensagem e link para o carrinho, e pode incluir um carrossel com até 4 produtos recomendados para estimular vendas adicionais
- Permite escolher entre 5 tipos de carrossel: mais vendidos, recentes, aleatórios, cross-sell ou desabilitar o carrossel
Passo a Passo por Escrito
1. Acesse as configurações do módulo no painel administrativo
Faça login no admin da sua loja e navegue até Lojas (Stores) → Configuração (Configuration) → Catálogo (Catalog) → Popup de Adição ao Carrinho.
Resultado esperado: A tela de configuração do módulo será exibida com os campos disponíveis para preenchimento.
2. Habilite o popup
Localize o campo Habilitar Popup do Carrinho (Enable Cart Popup) e selecione Sim.
Por padrão, após a instalação do módulo este campo já vem marcado como Sim. Só altere se quiser desativar temporariamente o popup na loja.
Resultado esperado: O popup está habilitado e será exibido para os clientes ao adicionarem produtos ao carrinho, após a conclusão da configuração e limpeza de cache.
3. Escolha o tipo de produtos exibidos no carrossel
Localize o campo Exibição de Produtos (Product Display) e selecione uma das cinco opções disponíveis:
- Mais Vendidos (Best Sellers) — exibe os produtos mais vendidos da sua loja no mês corrente
- Produtos Recentes (Latest Products) — exibe os produtos mais recentemente cadastrados no catálogo
- Produtos Aleatórios (Random Products) — exibe produtos selecionados aleatoriamente do catálogo
- Produtos Cross-sell (Crosssell products) — exibe os produtos associados via cross-sell aos itens que já estão no carrinho do cliente
- Nenhum (None) — desabilita o carrossel; o popup exibe apenas a mensagem de confirmação e o link para o carrinho
Por padrão, o campo vem configurado em Nenhum (None). Para que o carrossel apareça no popup, é necessário alterar para uma das outras quatro opções.
Quando a opção Mais Vendidos está selecionada e a sua loja ainda não tem histórico de vendas no mês corrente, o módulo automaticamente exibe produtos aleatórios em vez de deixar o carrossel vazio. Para validar que os mais vendidos estão sendo exibidos corretamente, confira o relatório de vendas da loja.
A opção Produtos Cross-sell depende de você ter cadastrado produtos cross-sell para os itens da sua loja. Se nenhum produto no carrinho tiver cross-sell associado, o carrossel ficará vazio.
Resultado esperado: A opção escolhida fica selecionada no campo, pronta para ser salva no próximo passo.
4. Salve as configurações e limpe o cache
Clique no botão Salvar Configuração (Save Config) no canto superior direito da tela.
Após salvar, limpe o cache da loja para que as alterações entrem em vigor no frontend. Acesse Sistema (System) → Gerenciamento de Cache (Cache Management), selecione os caches Layout, Blocos HTML de Saída (Blocks HTML output) e Cache de Página Inteira (Page Cache), e clique em Submeter (Submit) com a ação Atualizar (Refresh).
Resultado esperado: Uma mensagem de "Você salvou a configuração." será exibida no topo da tela, e o popup já estará ativo no frontend da loja com as opções escolhidas.
Validação e Testes
Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.
Teste 1 — Adição de produto na página de produto
Ação: acesse a loja no frontend, abra a página de qualquer produto e clique no botão Adicionar ao Carrinho (Add to Cart).
Resultado esperado: Um popup aparece na tela com a mensagem "Um novo item foi adicionado ao seu carrinho.", um ícone de confirmação e um link para o carrinho.
Teste 2 — Adição de produto na listagem (categoria ou home)
Ação: acesse uma página de listagem (categoria ou home) que tenha produtos com botão Adicionar ao Carrinho visível, e clique no botão de um dos produtos.
Resultado esperado: O mesmo popup do Teste 1 aparece, confirmando que o recurso funciona em todas as páginas do site, não apenas na página do produto.
Teste 3 — Verificação do carrossel com a opção configurada
Ação: depois que o popup aparecer (Teste 1 ou Teste 2), observe o carrossel exibido dentro do popup. Confira se os produtos exibidos correspondem ao tipo escolhido no passo 3:
- Se escolheu Mais Vendidos, devem aparecer produtos com histórico de venda no mês
- Se escolheu Produtos Recentes, devem aparecer os últimos produtos cadastrados
- Se escolheu Produtos Aleatórios, devem aparecer produtos variados
- Se escolheu Produtos Cross-sell, devem aparecer os produtos cross-sell do item que você acabou de adicionar
- Se escolheu Nenhum, o popup não deve ter carrossel
Resultado esperado: O carrossel exibe até 4 produtos correspondentes ao tipo escolhido, ou nenhum produto caso a opção seja "Nenhum".
Se não funcionar, verifique:
- Se o campo Habilitar Popup do Carrinho está realmente em Sim
- Se o cache da loja foi limpo após salvar (caches Layout, Blocos HTML de Saída e Cache de Página Inteira)
- Se você está testando em uma loja com produtos disponíveis (com estoque e visíveis)
- Se a opção escolhida em Exibição de Produtos é compatível com o estado atual da loja (ex: "Mais Vendidos" exige histórico de vendas no mês; "Produtos Cross-sell" exige produtos cross-sell associados)
Pronto! Dessa forma realizamos a configuração do Popup de Adição ao Carrinho em sua loja virtual Magento 2.
Observações Importantes
-
Limite fixo de 4 produtos no carrossel: o carrossel sempre exibe no máximo 4 produtos, independente da opção escolhida. Esse limite não é configurável pelo admin.
-
Fallback automático de "Mais Vendidos" para "Aleatórios": quando a opção Mais Vendidos está ativa e a loja não tem histórico de vendas no mês corrente, o módulo exibe produtos aleatórios sem aviso visual. Esse é o comportamento esperado para evitar carrossel vazio.
-
Popup só é disparado na adição ao carrinho: o popup aparece apenas quando o cliente adiciona um produto novo ao carrinho. Atualizações de quantidade, remoção de itens ou outras alterações no carrinho não disparam o popup.
-
Mensagem do popup não é editável pelo admin: o texto exibido no popup ("Um novo item foi adicionado ao seu carrinho.") é fixo e não pode ser alterado pela tela de configurações. Para personalizar a mensagem, é necessário acionar o suporte técnico.
-
O popup é carregado em todas as páginas da loja: mesmo quando o popup está desabilitado, alguns elementos visuais relacionados ao recurso são carregados no site. Isso não afeta a experiência do cliente, mas é um comportamento esperado.
-
Aplicável a qualquer fluxo de adição ao carrinho: página de produto, listagens, home, blocos promocionais — sempre que o cliente clicar em "Adicionar ao Carrinho", o popup aparece.
Referências e Relacionados
- Gerenciamento de cache no Magento 2: após qualquer alteração nas configurações do módulo, é necessário limpar o cache para que as mudanças entrem em vigor. Esta doc cobre o procedimento completo.
- Cadastro de Produtos Cross-sell: se você quer usar a opção "Produtos Cross-sell" no carrossel, precisa primeiro associar produtos cross-sell aos seus itens. Esta doc explica como cadastrar.
- Relatório de Mais Vendidos (Bestsellers): para validar quais produtos aparecerão quando a opção "Mais Vendidos" estiver ativa, consulte o relatório de produtos mais vendidos da sua loja.
Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br