O atributo period controla qual janela de tempo o plugin analisa pra calcular os mais vendidos. São 7 valores aceitos.
Lista completa
| Valor | Janela analisada |
|---|---|
7day |
Últimos 7 dias (padrão). |
30day |
Últimos 30 dias. |
15day |
Últimos 15 dias. |
month |
Mês corrente (do dia 1 até hoje). |
last_month |
Mês anterior completo. |
year |
Ano corrente (de 1º de janeiro até hoje). |
custom |
Intervalo definido por você via start_date e end_date. |
Quando usar cada um
7day — bom pra homepage com sensação de "o que tá bombando agora". Padrão do plugin.
15day e 30day — janelas suficientes pra absorver oscilações semanais. Boas pra lojas com pedidos esparsos onde 7 dias daria pouco volume.
month e last_month — pensam por mês de calendário, não janela móvel. Útil quando o ciclo de venda da loja é mensal (assinaturas, lojas B2B com fechamento). month mostra o ranking parcial do mês corrente; last_month mostra o mês fechado.
year — best sellers do ano. Bom pra páginas de campanha tipo "Top 50 do ano", retrospectivas e Black Friday.
custom — quando precisa de um intervalo arbitrário: campanha específica, período sazonal (Dia das Mães, Natal), comparativo histórico.
Exemplos
Últimos 15 dias, top 12:
[best_selling_by_period limit="12" period="15day"]
Últimos 30 dias, top 20:
[best_selling_by_period limit="20" period="30day"]
Mês passado completo:
[best_selling_by_period period="last_month"]
Período customizado (campanha de Natal de 2024):
[best_selling_by_period limit="20" period="custom" start_date="2024-12-01" end_date="2024-12-25"]
Datas no formato YYYY-MM-DD. Se omitir end_date, o plugin assume hoje.
Próximos passos
- Como usar o shortcode — todos os atributos juntos.
- Cache e atualização — cada combinação de período + atributos tem cache independente de 24h.