Pra que a vitrine de mais vendidos seja útil, ela precisa refletir o que de fato vendeu e o que ainda dá pra comprar. O plugin lida com as duas coisas automaticamente, sem configuração.
Quais pedidos contam como venda
O plugin considera apenas pedidos com estes dois statuses do WooCommerce:
completed(Concluído) — pedido pago e finalizado.processing(Processando) — pedido pago, em fluxo de fulfillment.
Esses são os statuses que representam dinheiro entrando. Tudo o mais é descartado:
| Status excluído | Por quê |
|---|---|
pending (Pendente) |
Pedido criado mas pagamento não confirmado. |
on-hold (Em espera) |
Aguardando ação manual; pode virar venda ou não. |
cancelled (Cancelado) |
Cliente ou loja desistiu. |
refunded (Reembolsado) |
Venda revertida. |
failed (Falhou) |
Pagamento rejeitado. |
Resultado: o ranking representa vendas reais, não tentativas. Um pedido cancelado dois dias depois não infla o ranking de quem comprou e devolveu.
Filtragem automática de produtos sem estoque
Depois de calcular o ranking, o plugin descarta produtos cujo stock_status não seja instock. Significa que:
- Produtos marcados manualmente como fora de estoque não aparecem.
- Produtos com gerenciamento de estoque ativo e quantidade zerada não aparecem.
- Produtos esgotados que voltam ao estoque voltam a aparecer assim que o cache expirar (ou no próximo
force="true").
Pra evitar que a vitrine fique curta quando vários top sellers estão sem estoque, o plugin busca limit + 10 produtos no relatório de vendas e só depois filtra. Se você pedir limit="12", ele consulta os 22 mais vendidos e exibe os primeiros 12 que têm estoque.
Por que isso importa
- Cliente nunca clica em produto indisponível. Cada clique vira uma chance real de compra.
- Ranking honesto. Produtos que vendem bem mas estão temporariamente fora de estoque saem da vitrine sem prejudicar a percepção de catálogo.
- Sem manutenção manual. Você não precisa atualizar a vitrine quando algo esgota — o filtro acontece a cada 24h junto com o refresh do cache.
Variações de produto
O ranking é por produto principal. Se o cliente comprou a variação "Camiseta Preta M", a venda é contada na ficha "Camiseta" — que é o que aparece na vitrine. Isso bate com como o WooCommerce contabiliza vendas em todos os relatórios nativos.
Próximos passos
- Cache e atualização — quando o ranking é recalculado e como forçar refresh após reposições de estoque.
- Personalizações para devs — adicionar outros statuses de pedido ao cálculo (
on-hold, por exemplo).