Como corrigir avaliações de curso que não funcionam no Tutor LMS
O que é review rating de curso no Tutor LMS?
O review rating no Tutor LMS é a avaliação de curso que permite ao aluno dar uma nota de 1 a 5 estrelas e escrever um comentário sobre o curso. Segundo a documentação oficial da Themeum, ao concluir o curso o aluno é automaticamente convidado a deixar essa avaliação, que depois aparece na página do curso em uma seção dedicada de reviews e alimenta a nota média exibida na vitrine.
Quando essa avaliação para de funcionar, três sintomas se misturam: o aluno não vê o formulário de review, a estrela e o comentário enviados não aparecem na página do curso, ou o administrador não encontra as avaliações no painel. A causa raiz quase sempre está na configuração: a opção de publicar review somente após aprovação do admin segurando os envios, o addon de relatórios desativado escondendo o painel de gestão, ou o aluno tentando avaliar sem ter concluído o curso.
Como identificar
- O aluno conclui o curso mas o formulário de avaliação de 1 a 5 estrelas não aparece para ele deixar a nota.
- A avaliação foi enviada pelo aluno, porém não aparece na seção de reviews da página do curso nem soma na nota média.
- No painel não existe o menu de reviews: o caminho Tutor LMS e o item Reports/Relatórios não estão disponíveis.
- Ao abrir Tutor LMS, Reports e Reviews, todas as avaliações aparecem com status não publicado ou pendente, sem nunca irem ao ar.
- A nota média e a contagem de estrelas do curso ficam zeradas mesmo com alunos que já concluíram e enviaram comentário.
Como prevenir
- Defina desde o início a política de moderação: ou desligue ‘Publish Course Review on Admin’s Approval’ para publicação automática, ou crie uma rotina de aprovar reviews em Tutor LMS, Reports, Reviews regularmente.
- Mantenha o addon Reports do Tutor LMS Pro sempre ativo, pois é por ele que o admin enxerga, modera e pública as avaliações dos alunos.
- Ao personalizar templates de curso no tema, copie o template oficial do Tutor LMS e preserve a chamada da seção de reviews para não removê-la sem querer.
- Configure regras de exclusão de cache para as páginas de curso do Tutor LMS, garantindo que novas avaliações apareçam sem atraso na nota média.
Causa
- A opção 'Publish Course Review on Admin's Approval' está ativada em Tutor LMS Pro, Settings, Course: cada review enviado fica pendente e só aparece na página do curso depois que um administrador o aprova manualmente.
- O addon Reports do Tutor LMS Pro está desativado em Tutor LMS Pro, Add-ons: sem ele o menu Tutor LMS, Reports, Reviews não existe e o admin não consegue publicar nem moderar as avaliações enviadas.
- O aluno ainda não concluiu o curso: o Tutor LMS só convida a avaliar após a conclusão, então sem 100 por cento de progresso o formulário de avaliação não é exibido para esse aluno.
- Um tema ou template de curso personalizado sobrescreve o template do Tutor LMS e remove o bloco tutor_course_target_reviews, fazendo a seção de reviews desaparecer da página do curso mesmo com avaliações publicadas.
- Um plugin de cache ou de otimização serve uma versão estática antiga da página do curso, mantendo a nota média e a lista de reviews congeladas após uma avaliação nova ser aprovada.
Como resolver
- Verifique a opção de aprovação de reviews: Em Tutor LMS Pro, Settings, Course, localize a opção 'Publish Course Review on Admin's Approval'. Se ela estiver ligada, todo review fica pendente até aprovação. Desligue se você quer publicação automática, ou mantenha ligada e aprove os reviews manualmente no passo seguinte.
Painel WP -> Tutor LMS Pro -> Settings -> Course Localize 'Publish Course Review on Admin's Approval' e ajuste o toggle conforme a politica desejada - Ative o addon Reports e aprove os reviews: O painel de gestão de avaliações vive dentro do addon Reports. Ative-o e depois abra a tela de reviews para publicar as avaliações que estão pendentes. Esse é o lugar onde o admin pública, despublica, pré-visualiza e exclui cada review.
Painel WP -> Tutor LMS Pro -> Add-ons -> ative o addon 'Reports' Painel WP -> Tutor LMS -> Reports -> Reviews Clique no status de cada avaliação pendente e selecione Publish para coloca-la no ar - Confirme que o aluno concluiu o curso: O convite para avaliar só aparece depois que o aluno completa o curso. Abra o progresso do aluno e confirme que ele está em 100 por cento. Se o progresso não fecha, resolva primeiro a conclusão antes de cobrar a avaliação.
Painel WP -> Tutor LMS -> Reports -> Students -> abra o aluno Confirme que o progresso do curso esta em 100 por cento (curso concluido) - Restaure a seção de reviews no template do curso: Se as avaliações estão publicadas mas não aparecem na página, um template de curso sobrescrito pelo tema pode ter removido o bloco de reviews. Volte ao template padrão do Tutor LMS ou reinsira a chamada da seção de reviews no template do tema filho.
Painel WP -> Aparencia -> Temas -> ative temporariamente um tema padrão para testar Se a seção voltar, edite o template de curso sobrescrito no tema e reponha a chamada do bloco de reviews do Tutor LMS - Limpe o cache da página do curso: Depois de publicar um review, limpe o cache do plugin de otimização e do servidor ou CDN para que a página do curso recarregue a nota média e a lista de reviews atualizada em vez de servir a versão antiga.
Painel WP -> (plugin de cache) -> Limpar todo o cache Recarregue a página do curso com cache desativado (modo anonimo) e confira a nova avaliação
<?php
// Publica automaticamente todo review de curso do Tutor LMS,
// mesmo com a aprovacao manual ligada nas configuracoes.
add_action( 'wp_insert_comment', 'full_auto_publica_review_tutor', 20, 2 );
function full_auto_publica_review_tutor( $comment_id, $comment ) {
if ( ! isset( $comment->comment_type ) ) {
return;
}
// O Tutor LMS grava o review como comentario do tipo 'tutor_course_rating'.
if ( 'tutor_course_rating' !== $comment->comment_type ) {
return;
}
if ( '1' === (string) $comment->comment_approved ) {
return;
}
wp_set_comment_status( $comment_id, 'approve' );
}














