🎉 USE O CUPOM DESCONTO.FULL | 20% OFF acima de R$ 50,00

Como corrigir avaliações de curso que não funcionam no Tutor LMS

Time Full Services Time Full Services
Tipo Outros erros
Nome do erro Avaliações de curso não funcionam no Tutor LMS EN: Tutor LMS course reviews/ratings not working
Severidade Atenção
Descrição A avaliação de curso no Tutor LMS deixa de funcionar quando a opção de aprovação manual segura os reviews como pendentes, quando o addon de relatórios está desativado ou quando o aluno não concluiu o curso e por isso não recebe o convite para avaliar.

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.
Antes de começar: Antes de desativar o addon Reports, trocar de tema ou editar templates de curso em produção, faça um backup completo do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para reverter caso a página do curso ou as avaliações quebrem.

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

  1. 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
  2. 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
  3. 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)
  4. 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
  5. 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
<?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' );
}

Perguntas frequentes

Por que a avaliação do aluno não aparece na página do curso no Tutor LMS
Na maioria dos casos a opção 'Publish Course Review on Admin's Approval' está ligada em Tutor LMS Pro, Settings, Course, deixando o review pendente. Abra Tutor LMS, Reports, Reviews e publique a avaliação, ou desligue a aprovação manual para publicação automática.
Onde fica o painel para aprovar avaliações no Tutor LMS
O painel de gestão de reviews fica em Tutor LMS, Reports, Reviews. Ali o admin pública, despublica, pré-visualiza e exclui cada avaliação. Esse menu só existe com o addon Reports do Tutor LMS Pro ativado.
O aluno precisa concluir o curso para conseguir avaliar no Tutor LMS
Sim. Segundo a documentação da Themeum, o convite para deixar uma avaliação de 1 a 5 estrelas surge automaticamente após o aluno concluir o curso. Sem 100 por cento de progresso, o formulário de review não é exibido para ele.
Por que não vejo o menu de reviews dentro do Tutor LMS
O menu Reports, onde ficam as avaliações, depende do addon Reports do Tutor LMS Pro. Ative o addon em Tutor LMS Pro, Add-ons. Se você usa a versão gratuita, faça o upgrade para o Pro para liberar esse painel.
Como faço a avaliação ser publicada automaticamente sem aprovar uma a uma
Desligue a opção 'Publish Course Review on Admin's Approval' em Tutor LMS Pro, Settings, Course. Com ela desligada, cada review enviado pelo aluno vai ao ar na página do curso sem precisar de aprovação manual do administrador.
As avaliações estão publicadas mas a seção de reviews sumiu da página, e agora
Provavelmente um template de curso do tema sobrescreveu o template do Tutor LMS e removeu o bloco de reviews. Teste com um tema padrão e, se a seção voltar, reponha a chamada da seção de reviews no template personalizado do seu tema.
Atualizei e a nota média do curso continua zerada, o que fazer
Limpe o cache do plugin de otimização e do servidor ou CDN. Páginas de curso em cache servem uma versão antiga, mantendo a nota média e a lista de reviews congeladas mesmo depois de uma avaliação ser aprovada.

Seja PRO.

Tenha acesso a snippets de código premium — PHP, JavaScript, CSS e HTML prontos para usar em seus projetos.

Conhecer o plano Pro →

Uma nova era para o WordPress.

A FULL Services redefine o CMS com uma arquitetura modular que transforma o WordPress em um motor de crescimento digital. 

Painéis personalizados

Um novo nível de controle para o WordPress. Acompanhe métricas, automações e evolução do seu site em um único painel visual.

A força por trás de grandes marcas

Para agências, estúdios e profissionais independentes que desejam oferecer soluções de alto nível com sua própria marca.

Componentes

Hero Sections

30 componentes

Seções de CTA

14 componentes

Login

14 componentes

Blog

14 componentes

Cabeçalhos

24 componentes

Seções de FAQ

53 componentes

Cadastro

53 componentes

Blog individual

53 componentes

Rodapés

28 componentes

Seções de contato

27 componentes

Seções de preços

27 componentes

Faixas

27 componentes

Portfólio

16 componentes

Seções de equipe

12 componentes

Números

12 componentes

Logotipos

12 componentes