O plugin oferece um shortcode pra exibir avaliações em qualquer página, post ou widget — útil pra criar uma página tipo "Veja o que nossos clientes dizem" ou pra mostrar reviews no rodapé.
Sintaxe básica
[wc_advanced_reviews_list]
Sem atributos, mostra todas as avaliações da loja, ordenadas da mais recente pra mais antiga, em páginas de 50 reviews.
Atributos
| Atributo | Padrão | O que faz |
|---|---|---|
id |
(vazio) | Mostra avaliações apenas do produto com esse ID. Sem id, mostra de toda a loja. |
per_page |
50 |
Quantidade de avaliações por página. |
paged |
(URL) | Página inicial. Por padrão, lê o parâmetro cpage da URL — você raramente precisa setar manualmente. |
Exemplos
Todas as avaliações da loja:
[wc_advanced_reviews_list]
Título exibido: 15 avaliações reais (onde 15 é o total).
Avaliações de um produto específico:
[wc_advanced_reviews_list id="123"]
Título exibido: 15 avaliações para o produto Camiseta Estampada (onde 15 é o total daquele produto).
Mais avaliações por página:
[wc_advanced_reviews_list per_page="20"]
Combinando produto + paginação curta:
[wc_advanced_reviews_list id="456" per_page="10"]
O que aparece em cada review
Pra cada avaliação na lista, o shortcode renderiza:
- Nome do avaliador (com selo de cliente verificado quando o WooCommerce confirma a compra).
- Data da avaliação no formato
dia/mês/ano. - Estrela com a média geral, em barra visual proporcional.
- Nome do produto avaliado com link pra página dele.
- Título e texto da avaliação.
- Botões de compartilhamento no Twitter e Facebook.
- Controles de paginação no rodapé.
Cache de contagem
A contagem total de avaliações exibida no título é cacheada via transient por 24 horas (chave wc_advanced_reviews_count_<id> ou wc_advanced_reviews_count_all).
O WooCommerce já invalida o transient automaticamente quando uma nova avaliação é aprovada. Se mesmo assim você ver um número desatualizado, force a limpeza:
delete_transient( 'wc_advanced_reviews_count_all' );
// ou pra um produto específico:
delete_transient( 'wc_advanced_reviews_count_123' );
Estilizar a listagem
A página renderizada usa um conjunto de classes CSS estáveis que você pode customizar no tema:
.wc-advanced-reviews-get-all { /* container */ }
.reviews-title { /* título com a contagem */ }
.wc-advanced-reviews-list { /* lista */ }
.single-review { /* cada review individual */ }
.review-header { /* topo do review (autor + data) */ }
.reviewer-name { /* nome do cliente */ }
.customer-verified { /* selo de cliente verificado */ }
.review-date { /* data */ }
.star-rating.wc-advanced-reviews { /* barra de estrelas */ }
.review-product { /* link pro produto */ }
.review-content { /* texto do review */ }
.share-review { /* botões de compartilhamento */ }
.reviews-pagination { /* paginação */ }
A listagem já é responsiva por padrão, mas se você quer um layout em grid ou colunas, use as classes acima como ponto de partida.
Onde colocar o shortcode
- Páginas e posts: Cole
[wc_advanced_reviews_list]no editor. - Widgets: Use o widget de Texto ou Shortcode do WordPress (ou o equivalente do seu page builder).
- Templates de tema: Use
echo do_shortcode( '[wc_advanced_reviews_list]' );em PHP.
O que não é exibido
A listagem só inclui avaliações que:
- Estão com status Aprovado no WordPress.
- Têm a meta
ratingpreenchida (foram criadas via formulário do plugin, não comentários comuns).
Comentários antigos importados sem rating ficam de fora — se quiser incluí-los, é preciso preencher a meta manualmente.