Tutor LMS relatório não mostra progresso: como corrigir

Tipo Outros erros

Nome do erro Relatórios do Tutor LMS não exibem progresso EN: Tutor LMS reports not showing progress data

Severidade Atenção

Descrição O relatório do Tutor LMS não mostra progresso quando o addon Reports (exclusivo do Tutor LMS Pro) está desativado, quando o aluno enviado é anterior à instalação do plugin ou quando o modo de conclusão Strict deixa cursos sem 100% por lições e quizzes pendentes.

O que é relatório do Tutor LMS sem progresso?

O relatório do Tutor LMS é a área de analytics que mostra a taxa de conclusão de curso, o progresso por aluno e o histórico de matrículas e vendas. Quem alimenta esses números é o addon Reports, um recurso exclusivo do Tutor LMS Pro: ao ativá-lo em Tutor LMS Pro e Add-ons, surge um menu Report no painel com as abas Overview, Courses, Reviews, Sales e Students, cada uma listando o avanço dos alunos lição a lição.

O problema aparece quando esse painel fica zerado ou desatualizado: a aba Courses mostra 0% de conclusão, a aba Students não traz o progresso curso a curso, ou o menu Report sequer existe. Segundo a documentação oficial, o addon agrega dados a partir da data de instalação em diante, então matrículas e conclusões anteriores à ativação não são recalculadas. Somado a isso, o modo de conclusão do curso e o cache de objeto influenciam diretamente o número que o relatório exibe.

Como identificar

O menu Report não aparece sob Tutor LMS no painel, mesmo com o Tutor LMS Pro instalado e ativo.
A aba Courses do relatório mostra 0% de taxa de conclusão para cursos que têm alunos claramente avançados.
A aba Students lista o aluno matriculado, mas o progresso curso a curso permanece vazio ou travado no mesmo número.
O painel frontend em Dashboard e Analytics, acessado pelo aluno, não reflete as lições já marcadas como concluídas.
O relatório só conta matrículas recentes e ignora alunos antigos, deixando a base histórica de fora dos gráficos.

Antes de começar: Antes de alternar o modo de conclusão de curso ou esvaziar o cache de objeto em produção, faça um backup do site (arquivos e banco de dados) ou teste em um ambiente de staging, pois mudar de Strict para Flexible altera como a conclusão dos cursos já em andamento é calculada.

Como prevenir

Ative o addon Reports logo na configuração do Tutor LMS Pro, antes de matricular alunos, para que o relatório agregue o progresso desde a primeira matrícula.
Defina o modo de conclusão de curso (Flexible ou Strict) na criação da trilha e comunique a regra aos instrutores, evitando taxas de conclusão que parecem travadas.
Padronize a configuração do cache de objeto para que o relatório do Tutor LMS não seja servido com contagem defasada após o aluno avançar.
Mantenha o Tutor LMS Pro atualizado em staging antes de produção, acompanhando mudanças nas regras de progresso e nas abas do relatório.

Causa

O addon Reports não está ativado em Tutor LMS Pro e Add-ons: como ele é exclusivo do Tutor LMS Pro, sem ativá-lo o menu Report não existe e nenhuma taxa de conclusão é agregada.
As matrículas e conclusões são anteriores à instalação do plugin: a documentação do addon afirma que ele agrega dados a partir da data de instalação em diante, então o progresso histórico não entra no relatório.
O curso está no modo de conclusão Strict, que só marca 100% quando o aluno conclui todas as lições e é aprovado em todos os quizzes; lições ou quizzes pendentes seguram a taxa de conclusão em um número baixo.
O aluno marcou as lições pelo frontend, mas um cache de objeto persistente (Redis ou Memcached) serviu a contagem antiga, deixando o relatório defasado em relação ao progresso real.
A versão gratuita do Tutor LMS está instalada no lugar do Tutor LMS Pro: o relatório completo é um recurso Pro e o painel de Reports não acompanha a edição gratuita.

Como resolver

Confirme que o Tutor LMS Pro está ativo: O relatório de progresso completo é um recurso exclusivo do Tutor LMS Pro. Confira em Plugins se o Tutor LMS Pro está instalado e ativo, e não apenas a versão gratuita, pois o painel de Reports só existe na edição Pro.
```
Painel WP -> Plugins -> Plugins Instalados
Confirme que o 'Tutor LMS Pro' está ativo, além do 'Tutor LMS' gratuito
```
Ative o addon Reports: Sem o addon ligado, o menu Report não aparece e nenhuma taxa de conclusão é calculada. Ative-o nos add-ons do Tutor LMS Pro e recarregue o painel para o novo menu surgir.
```
Painel WP -> Tutor LMS Pro -> Add-ons
Localize 'Reports' e ligue a chave para Enabled
Recarregue o painel: o menu 'Report' deve surgir sob Tutor LMS
```
Verifique o modo de conclusão do curso: No modo Strict, o curso só atinge 100% quando o aluno conclui todas as lições e passa em todos os quizzes; é por isso que a taxa de conclusão fica baixa mesmo com o aluno ativo. Avalie se o modo Flexible faz mais sentido para a sua trilha.
```
Painel WP -> Tutor LMS -> Settings -> Course
Localize 'Course Completion' e escolha entre Flexible e Strict conforme a regra do curso
```
Confira o progresso pelo painel do aluno: Abra a aba Students do relatório e o painel frontend em Dashboard e Analytics para comparar o que o aluno concluiu com o que o relatório exibe. Se houver divergência, o próximo passo é limpar o cache que está servindo a contagem antiga.
```
Painel WP -> Tutor LMS -> Report -> aba Students -> abra o aluno
Frontend -> Dashboard -> Analytics -> compare as lições concluídas
```
Limpe o cache de objeto e o cache de página: Um cache de objeto persistente pode servir a contagem de progresso antiga ao relatório. Esvazie o cache de objeto e o cache de página do plugin de performance para forçar o Tutor LMS a recalcular os números a partir do banco.
```
Painel WP -> Plugin de cache -> Limpar todo o cache de página
Se houver Redis ou Memcached: limpe o cache de objeto pela ferramenta do host ou do plugin
```

PHP

<?php
// Lê o progresso real de um curso para um aluno direto da API do Tutor LMS,
// útil para conferir o número quando o relatório aparece defasado.
add_shortcode( 'full_tutor_progresso', 'full_tutor_progresso_curso' );
function full_tutor_progresso_curso( $atts ) {
    if ( ! function_exists( 'tutor_utils' ) ) {
        return ''; // Tutor LMS inativo: evita fatal error.
    }
    $atts    = shortcode_atts( array( 'curso' => 0 ), $atts );
    $user_id = get_current_user_id();
    if ( ! $user_id || ! $atts['curso'] ) {
        return '';
    }
    $dados   = tutor_utils()->get_course_completed_percent( (int) $atts['curso'], $user_id, true );
    $percent = is_array( $dados ) ? (int) $dados['percent'] : (int) $dados;
    return sprintf( 'Progresso real: %d%%', $percent );
}

Perguntas frequentes

Por que o relatório do Tutor LMS não mostra nenhum progresso

Na maioria dos casos o addon Reports está desativado. Como ele é exclusivo do Tutor LMS Pro, vá em Tutor LMS Pro e Add-ons, ative Reports e recarregue o painel para o menu Report e as taxas de conclusão aparecerem.

O relatório ignora alunos antigos, isso é normal

Sim. A documentação do addon Reports informa que ele agrega dados a partir da data de instalação em diante. Matrículas e conclusões anteriores à ativação do plugin não entram nos gráficos, então a base histórica fica de fora do relatório.

O addon Reports existe na versão gratuita do Tutor LMS

Não. O painel de Reports com taxa de conclusão, vendas e progresso por aluno é um recurso exclusivo do Tutor LMS Pro. Na versão gratuita o menu Report não fica disponível e o progresso completo não é agregado.

Por que a taxa de conclusão fica baixa mesmo com o aluno ativo

Provavelmente o curso está no modo de conclusão Strict, que só marca 100% quando o aluno conclui todas as lições e passa em todos os quizzes. Lições ou quizzes pendentes seguram a taxa; avalie o modo Flexible se fizer sentido para a trilha.

Onde o aluno vê o próprio progresso no Tutor LMS

O aluno acompanha o avanço pelo painel frontend, em Dashboard e Analytics, que mostra as lições concluídas curso a curso. Compare esse painel com a aba Students do relatório para identificar onde os números divergem.

O cache pode deixar o relatório de progresso defasado

Pode. Um cache de objeto persistente, como Redis ou Memcached, serve a contagem antiga e o relatório fica atrasado em relação ao progresso real. Esvazie o cache de objeto e o cache de página para forçar o recálculo a partir do banco.

Quais abas o relatório do Tutor LMS oferece

O addon Reports traz as abas Overview, Courses, Reviews, Sales e Students. A aba Courses exibe a taxa de conclusão por curso e a aba Students mostra o progresso de cada aluno curso a curso, com o detalhe das lições concluídas.

Atenção

Como corrigir a integração com Zoho/Salesforce no WPForms

A integração Zoho/Salesforce no WPForms falha quando o addon exige a licença Elite, o site não roda em HTTPS, o app conectado (Connected App) do CRM está mal configurado ou o mapeamento de campos do formulário não casa com os campos do objeto no CRM, fazendo o envio não criar o registro.

Grave

Como corrigir o painel frontend que não carrega para instrutores no Tutor LMS

Quando o painel instrutor não carrega no Tutor LMS, o frontend dashboard em /dashboard abre em branco, sem cabeçalho e rodapé ou retorna 404. A causa quase sempre é o tema sobrescrever o dashboard.php sem a condição de get_header, a página do painel não estar atribuída ou permalink fora de Post Name.

Informativo

Como corrigir notificações de Q&A que não chegam aos instrutores no Tutor LMS

As notificações de Q&A do Tutor LMS não chegam aos instrutores quando o addon Email do Tutor LMS Pro está desligado, o gatilho New Q&A Message está desmarcado ou o site não tem um SMTP configurado para entregar o e-mail disparado quando o aluno faz uma pergunta.

Grave

Como corrigir o cálculo de comissões do Revenue Sharing no Tutor LMS

A comissão errada no Revenue Sharing do Tutor LMS acontece quando o Sharing Percentage está mal configurado, a opção Deduct Fees desconta a taxa antes da divisão ou o ganho foi gravado com um percentual antigo, fazendo o valor pago ao instrutor divergir do esperado.

Crítico

Como corrigir o erro de pagamento (Stripe e PayPal) no Tutor LMS

O pagamento do Tutor LMS não funciona quando o aluno tenta comprar um curso pelo Stripe ou PayPal e o checkout não conclui ou o pedido nunca confirma. Quase sempre vem de chaves de API no ambiente errado (Test no lugar de Live), webhook não configurado no gateway, ou mais de uma engine de eCommerce ativa ao mesmo tempo.

Atenção

Como corrigir o mapa do Google que não aparece no WordPress

O mapa do Google que não aparece no WordPress quase sempre indica uma chave de API ausente, restrita demais ou sem faturamento ativo na conta. O resultado é um bloco cinza, um mapa com a marca d'água 'For development purposes only' ou um erro no console; a correção é gerar e restringir corretamente a chave da Google Maps Platform.

Setores

Extensões

Integrações

Como corrigir relatórios que não exibem progresso no Tutor LMS

O que é relatório do Tutor LMS sem progresso?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir a integração com Zoho/Salesforce no WPForms

Como corrigir o painel frontend que não carrega para instrutores no Tutor LMS

Como corrigir notificações de Q&A que não chegam aos instrutores no Tutor LMS

Como corrigir o cálculo de comissões do Revenue Sharing no Tutor LMS

Como corrigir o erro de pagamento (Stripe e PayPal) no Tutor LMS

Como corrigir o mapa do Google que não aparece no WordPress

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos