Como corrigir o progresso do aluno que não atualiza no Tutor LMS
Perguntas frequentes
Por que o progresso do aluno no Tutor LMS não atualiza mesmo depois de concluir a aula?
Na maioria dos casos a página da aula está sendo servida pelo cache: o aluno conclui, a página recarrega, mas o HTML vem do cache com a barra de progresso antiga. Excluir as URLs de curso, aula e quiz do plugin de cache resolve o problema na origem.
A barra de progresso está travada em uma porcentagem fixa. O que fazer primeiro?
Limpe todo o cache (página, objeto e CDN) e recarregue a aula com o cache do navegador desativado. Se a porcentagem mudar, o cache era a causa e você deve adicionar as páginas de curso à lista de exceções permanente do plugin de cache.
Onde o Tutor LMS guarda o progresso de cada aluno?
Cada aula concluída vira um registro user meta com prefixo _tutor_completed_lesson_id na tabela wp_usermeta, e a conclusão do curso é registrada como um comentário do tipo course_completed. A porcentagem do curso é calculada em tempo real por get_course_completed_percent.
O botão Marcar como concluída não faz nada. Como diagnosticar?
Abra o console do navegador na aba Network e clique no botão. Se a requisição para admin-ajax.php com a ação tutor_mark_lesson_complete retornar 403 ou 0, há um firewall ou plugin de segurança bloqueando a chamada e você precisa liberar essa ação.
O Content Drip pode fazer o progresso parecer travado?
Sim. No modo Course Content Available Sequentially, se uma aula anterior não foi concluída, o Tutor LMS não libera nem contabiliza as próximas. Revise a ordem das aulas ou troque para o agendamento por data para destravar o aluno.
O relatório do instrutor mostra concluído mas o aluno vê incompleto. Por quê?
Esse descompasso quase sempre é cache de objeto ou registros _tutor_completed_lesson_id duplicados após uma migração. Rode wp cache flush e wp transient delete --all para forçar o recálculo e alinhar as duas telas.
Preciso editar o banco de dados para corrigir o progresso?
Na maioria das vezes não. Excluir as páginas do cache, liberar a ação AJAX e limpar os transientes resolve sem tocar no banco. Só edite a tabela wp_usermeta com backup feito quando houver registros de conclusão claramente corrompidos.
Limpar o cache vai apagar o progresso já registrado dos alunos?
Não. O cache guarda apenas a página renderizada e valores temporários, não o histórico de conclusão. Limpar o cache apenas força o Tutor LMS a recalcular e exibir a porcentagem correta a partir dos dados reais.














