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

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.

Erros relacionados

- [Como corrigir o progresso do aluno que não atualiza no Tutor LMS](https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/)
- [Como corrigir quizzes que não salvam respostas no Tutor LMS](https://full.services/wp-fixer/corrigir-quiz-nao-salva-tutor-lms/)
- [Como corrigir certificados que não geram PDF no Tutor LMS](https://full.services/wp-fixer/corrigir-certificado-pdf-tutor-lms/)

## 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

1. 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
```

2. 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
```

3. 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
```

4. 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
```

5. 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
```


## Código

```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.

**Fonte:** [Tutor LMS Documentation — Reports Addon](https://docs.themeum.com/tutor-lms/addons/reports/)