O plugin expõe um único shortcode — [best_selling_by_period] — que você cola onde quiser exibir os produtos mais vendidos. Sem mexer em código, sem editar template do tema.
Sintaxe básica
[best_selling_by_period]
Sem nenhum atributo, o shortcode mostra os 12 produtos mais vendidos dos últimos 7 dias, em 4 colunas.
Atributos disponíveis
| Atributo | Padrão | O que faz |
|---|---|---|
limit |
12 |
Quantos produtos exibir. |
columns |
4 |
Quantas colunas no grid. Aceita 1 a 6+ (depende do tema). |
period |
7day |
Período de análise. Veja períodos disponíveis. |
force |
false |
Força refresh do cache (ignora as 24h do transient). Útil em testes. |
start_date |
— | Data inicial no formato YYYY-MM-DD. Obrigatório quando period=custom. |
end_date |
— | Data final no formato YYYY-MM-DD. Opcional quando period=custom (default: hoje). |
Exemplos prontos pra colar
Top 8 da semana, em 2 colunas (sidebar estreita):
[best_selling_by_period limit="8" columns="2" period="7day"]
Top 20 dos últimos 30 dias (homepage):
[best_selling_by_period limit="20" period="30day"]
Top 24 do ano em 6 colunas (página de campanha):
[best_selling_by_period limit="24" columns="6" period="year"]
Os mais vendidos do mês passado:
[best_selling_by_period period="last_month"]
Janeiro de 2024 — período customizado:
[best_selling_by_period limit="15" period="custom" start_date="2024-01-01" end_date="2024-01-31"]
Forçar atualização do cache (testando uma campanha):
[best_selling_by_period period="month" force="true"]
Onde colar
O shortcode é WordPress padrão e funciona em:
- Editor de páginas e posts (Gutenberg ou clássico) — usa o bloco
Shortcode. - Builders (Elementor, Bricks, Divi, WPBakery) — qualquer widget de shortcode/HTML.
- Widgets de sidebar e footer — bloco "Shortcode" ou widget de texto com filtro de shortcode habilitado.
- Template do tema (PHP) — usando
do_shortcode():
echo do_shortcode( '[best_selling_by_period limit="12" period="month"]' );
Visual e estilo
O shortcode delega a renderização final pro shortcode nativo do WooCommerce (WC_Shortcode_Products). Isso significa que o HTML, classes CSS e responsividade são os mesmos do seu tema — o produto entra com a mesma cara que tem em qualquer listagem da loja. Sem CSS extra pra ajustar.
Você pode colocar várias chamadas do shortcode com configurações diferentes na mesma página — uma "Top da semana" e logo abaixo uma "Top do mês". Cada combinação de atributos tem cache próprio.
Próximos passos
- Períodos disponíveis — detalhe de cada
periodaceito. - Cache e atualização — como o
forcefunciona e por quanto tempo o resultado é cacheado. - Estoque e status de pedido — quais pedidos contam como "venda" e por que produtos sem estoque nunca aparecem.