O plugin envia automaticamente um e-mail pedindo a avaliação alguns dias depois que o pedido é concluído. Esse fluxo é controlado pelo WP-Cron e por algumas configurações simples no admin.
Como funciona, em alto nível
- O WordPress executa o cron
wc_advanced_reviews_remindersduas vezes por dia (twicedaily). - A cada execução, o plugin busca pedidos com status Concluído que ainda não receberam o lembrete.
- Pra cada pedido encontrado, dispara o e-mail Lembrete de review (se ele estiver habilitado).
- O pedido é marcado internamente com a meta
_wc_advanced_reviews_reminder = yes, pra não receber o lembrete de novo.
A configuração que você controla
Em WooCommerce → Settings → Products → Reviews:
- Dias até enviar lembrete de review — número entre 1 e 30. Padrão: 2.
A semântica é: "envie o lembrete quando o pedido tiver sido concluído há X dias".
A janela de busca
A cada execução do cron, o plugin busca pedidos concluídos entre (agora − dias − 3) e (agora − dias). Isso é uma janela de 3 dias que fica andando junto com o tempo, pra evitar perder pedidos se o cron ficar atrasado.
Em prática:
- Se Dias até enviar lembrete de review está em 2, o lembrete sai pra pedidos concluídos entre 5 e 2 dias atrás.
- Se está em 7, sai pra pedidos concluídos entre 10 e 7 dias atrás.
A flag _wc_advanced_reviews_reminder garante que cada pedido recebe o e-mail apenas uma vez, mesmo que caia dentro da janela em duas execuções seguidas.
Se você precisa de uma janela maior (porque seu WP-Cron é instável, por exemplo), o filtro wc_advanced_reviews_interval permite mudar o tamanho dessa janela. Veja em Filtros disponíveis.
Pré-requisitos pra funcionar
Pro lembrete sair, três coisas precisam estar verdadeiras:
- WP-Cron ativo. Sem
wp-cron.phprodando, nada dispara. Se você desabilitou WP-Cron e usa cron de servidor, garanta que ele está funcionando. - E-mail habilitado. Em WooCommerce → Settings → Emails, verifique se o e-mail Lembrete de review está com Enable this email notification marcado.
- Pedido em status Concluído. Pedidos em Em processamento ou outro status não disparam (a menos que você customize via filtro
wc_advanced_reviews_reminder_status).
Logs pra debugar
O plugin grava o que o cron faz num log do WooCommerce, no canal reviews-teste.
- Caminho típico:
wp-content/uploads/wc-logs/reviews-teste-YYYY-MM-DD-<hash>.log. - Também acessível em WooCommerce → Status → Logs, escolhendo
reviews-teste-<data>.
A cada execução, o plugin registra:
- Os IDs dos pedidos encontrados na janela.
- Cada pedido pra qual o e-mail foi disparado, com a data de conclusão.
Se o log estiver vazio em uma janela em que você esperava lembretes, significa que ou o cron não rodou, ou nenhum pedido casou os critérios.
Troubleshooting
O lembrete não chega.
- Confirme que o e-mail Lembrete de review está habilitado.
- Confira se o pedido foi marcado como Concluído dentro da janela (
agora − dias − 3atéagora − dias). - Veja o log
reviews-testena data esperada. - Se o WP-Cron estiver desabilitado, force a execução:
wp cron event run wc_advanced_reviews_reminders(WP-CLI).
O lembrete chegou duplicado.
A versão 1.3.4 corrigiu um bug de integração com HPOS que causava esse comportamento. Se você ainda vê duplicidade, atualize o plugin.
Quero mudar o status disparador (ex.: "Em processamento" em vez de "Concluído").
Use o filtro wc_advanced_reviews_reminder_status. Veja em Filtros disponíveis.
Personalizar o e-mail
O conteúdo do lembrete (assunto, cabeçalho, corpo, variáveis disponíveis) está em E-mails do plugin.