Solução de problemas
Quase tudo aqui se resolve com uma limpeza de cache — mas vale entender o comportamento por trás de cada sintoma.
O clique na sacolinha abre a página do produto em vez do modal
Esse é o comportamento de segurança do módulo: quando o script do modal não carregou a tempo, o clique leva à página do produto (em vez de falhar ou adicionar algo ao carrinho sem o cliente ver). A causa mais comum é cache de página desatualizado — limpe o cache do site e do Cloudflare e teste em janela anônima. Se persistir, fale com a equipe da Pixel Partners.
Os tamanhos aparecem fora de ordem (GG, G, M, P)
Confirme que o atributo usa Ordenação personalizada com os termos arrastados na ordem correta — o passo a passo está aqui. Depois do ajuste, limpe o cache de página.
O botão não aparece no catálogo
O Quick Shop depende do tema Flatsome (ou um tema filho dele) e da grade de produtos renderizada pelo tema. Se a vitrine é montada por outro construtor de páginas, o botão não é injetado — fale com a equipe da Pixel Partners.
O swatch de cor aparece como texto
O termo não tem swatch configurado — nem no Quick Shop, nem no Flatsome. Configure em Produtos → Atributos → Configurar termos → editar o termo.
O modal abre mas o botão de compra fica desabilitado
É o comportamento esperado enquanto houver opção não selecionada — o rótulo mostra “SELECIONE TODAS AS OPÇÕES”. Se todas estão selecionadas e o botão continua desabilitado, a combinação escolhida provavelmente está sem estoque ou desabilitada no produto.
O plugin foi atualizado e nada mudou
Cache. Limpe o cache de página do site, do otimizador e do Cloudflare, e teste em janela anônima.
Regra de ouro: depois de qualquer atualização do módulo, o cache de página e o CDN devem ser limpos — a equipe da Pixel Partners já faz isso ao atualizar, mas se a sua loja tem cache próprio adicional, inclua-o na rotina.
Documentação do Quick Shop · escrita com base na versão 1.0.3. As telas ilustradas podem variar conforme a versão instalada na sua loja.