--- title: "Como corrigir o progresso do aluno que não atualiza no Tutor LMS" url: https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir o progresso do aluno que não atualiza no Tutor LMS ## O que é o progresso do aluno do Tutor LMS que não atualiza? No Tutor LMS, o progresso do aluno não atualiza quando a barra de porcentagem do curso e o status das aulas permanecem congelados depois que o aluno clica em Marcar como concluída, ou quando concluir uma aula não libera a próxima. Cada aula concluída é gravada como um user meta do tipo _tutor_completed_lesson_id e a porcentagem do curso é recalculada por get_course_completed_percent(); quando essa gravação não chega ao banco, ou quando a página exibida vem do cache, o aluno vê o progresso parado mesmo tendo feito tudo. ## Como identificar - A barra de progresso do curso fica travada em uma porcentagem fixa (por exemplo 40 por cento) mesmo depois que o aluno conclui novas aulas. - O botão Marcar como concluída (Mark as Complete) é clicado, a página recarrega, mas a aula continua sem o ícone de concluída. - A próxima aula não é liberada no modo sequencial, e o aluno fica preso na mesma aula sem conseguir avançar. - O console do navegador mostra falha na chamada AJAX para admin-ajax.php com a ação tutor_mark_lesson_complete (status 403 ou 0). - O relatório do instrutor e o painel do aluno divergem: um mostra o curso concluído e o outro mostra incompleto. **Antes de começar:** Faça backup completo do banco de dados (tabelas wp_usermeta e wp_comments do Tutor LMS) antes de rodar comandos WP-CLI ou apagar registros de conclusão, porque progresso apagado por engano não é recuperável e o aluno perde o histórico do curso. ## Como prevenir - Manter as páginas /courses/, /lesson/ e /quizzes/ permanentemente fora do cache de página em qualquer plugin de cache. - Não cachear requisições para admin-ajax.php e revisar regras de firewall sempre que instalar um plugin de segurança novo. - Testar a conclusão de aula com um usuário aluno de teste após cada atualização do Tutor LMS, do tema ou do page builder. - Evitar o modo sequencial do Content Drip em cursos grandes sem antes validar a ordem das aulas com um aluno real. Erros relacionados - [Como corrigir relatórios que não exibem progresso no Tutor LMS](https://full.services/wp-fixer/corrigir-reports-progresso-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 o cache do WP Rocket em páginas de curso do Tutor LMS](https://full.services/wp-fixer/corrigir-cache-wp-rocket-tutor-lms/) --- ## Metadados Estruturados (Schema.org) ```json-ld { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://full.services/#org", "name": "FULL Services", "url": "https://full.services/", "sameAs": [ "https://www.instagram.com/fullservicesbr", "https://www.facebook.com/fullservices.br", "https://www.linkedin.com/company/fullservicesbr/" ], "knowsAbout": [ "WordPress", "WordPress Hosting", "Web Development", "Performance Optimization", "WordPress Security", "SEO para WordPress" ], "award": [ "Gold Medal - The WP Weekly Awards 2023", "Gold Medal - The WP Weekly Awards 2024" ], "logo": { "@type": "ImageObject", "url": "https://full.services/wp-content/uploads/full-services-logo.png", "width": 200, "height": 60 }, "hasCredential": { "@type": "EducationalOccupationalCredential", "credentialCategory": "certification", "name": "CVE Numbering Authority (CNA)", "description": "Autoridade de numeração de vulnerabilidades (CVE) para o ecossistema WordPress, autorizada a atribuir IDs CVE. Válida desde 2022-05-03, com abrangência global.", "url": "https://www.cve.org/PartnerInformation/ListofPartners/partner/FULL", "recognizedBy": { "@type": "Organization", "name": "CISA — Cybersecurity and Infrastructure Security Agency", "url": "https://www.cisa.gov/", "sameAs": "https://www.cisa.gov/" } } }, { "@type": "TechArticle", "@id": "https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/#article", "headline": "Como corrigir o progresso do aluno que não atualiza no Tutor LMS", "url": "https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/", "inLanguage": "pt-BR", "datePublished": "2026-06-17T12:08:34-03:00", "dateModified": "2026-06-17T12:37:52-03:00", "author": { "@id": "https://full.services/#org" }, "publisher": { "@id": "https://full.services/#org" }, "isAccessibleForFree": false, "about": [ { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, { "@type": "Thing", "name": "Outros erros" } ], "mentions": { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/" }, "wordCount": 810, "description": "O progresso do aluno no Tutor LMS não atualiza quando a página de curso fica em cache e a barra continua mostrando a porcentagem antiga mesmo depois de o aluno concluir a aula. Cache de página, requisição AJAX bloqueada e modo de conclusão sequencial são as causas mais comuns.", "articleSection": "Outros erros", "keywords": "tutor lms aula concluida nao marca, tutor lms barra de progresso travada, tutor lms mark as complete nao funciona, tutor lms progresso curso nao salva", "proficiencyLevel": "Intermediate", "citation": { "@type": "CreativeWork", "url": "https://docs.themeum.com/tutor-lms/addons/content-drip/", "name": "Tutor LMS — Content Drip (Course Content Available Sequentially)" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir o progresso do aluno que não atualiza no Tutor LMS", "programmingLanguage": "PHP", "codeRepository": "https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/#faq-q1", "name": "Por que o progresso do aluno no Tutor LMS não atualiza mesmo depois de concluir a aula?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/#faq-q2", "name": "A barra de progresso está travada em uma porcentagem fixa. O que fazer primeiro?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/#faq-q3", "name": "Onde o Tutor LMS guarda o progresso de cada aluno?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/#faq-q4", "name": "O botão Marcar como concluída não faz nada. Como diagnosticar?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/#faq-q5", "name": "O Content Drip pode fazer o progresso parecer travado?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/#faq-q6", "name": "O relatório do instrutor mostra concluído mas o aluno vê incompleto. Por quê?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/#faq-q7", "name": "Preciso editar o banco de dados para corrigir o progresso?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/#faq-q8", "name": "Limpar o cache vai apagar o progresso já registrado dos alunos?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```