Como corrigir o Course Builder que não carrega no Tutor LMS
O que é o Course Builder que não carrega no Tutor LMS?
O Course Builder é o editor de cursos do Tutor LMS, em Tutor LMS -> Cursos -> Adicionar Novo. Ele é uma interface JavaScript que carrega currículo, aulas e quizzes via AJAX e REST API do WordPress. Quando o Course Builder não carrega, essa interface não inicializa: a tela fica no carregando, abre em branco ou acusa nonce inválido, e você não consegue montar ou salvar o curso. O resto do site segue no ar, porque o problema é o JavaScript do editor que não roda, não o servidor.
Como identificar
- O editor de curso fica preso no spinner de carregando e nunca completa.
- A área do Course Builder abre totalmente em branco, sem currículo nem botões.
- Mensagem de nonce inválido ou de undefined ao tentar salvar o curso.
- O console do navegador (F12) mostra erro de JavaScript ou um 404 em arquivo .js do Tutor LMS.
- O painel do Tutor LMS aparece quebrado, sem o cabeçalho e o rodapé corretos.
Como prevenir
- Exclua os scripts do Tutor LMS da minificação de JS desde a instalação do plugin de cache
- Mantenha PHP em versão suportada e WP_MEMORY_LIMIT em 256M ou mais antes de criar cursos grandes
- Atualize Tutor LMS, tema e plugins SEO juntos e sempre teste o Course Builder em ambiente de staging
- Mantenha os permalinks em Post Name para preservar as rotas REST do builder
Causa
- Plugin de cache com minificação ou compressão agressiva de JavaScript e HTML, que corrompe os scripts do Course Builder e gera nonce inválido (documentado pela Themeum).
- Feature Protect do Jetpack ativa, que bloqueia as requisições AJAX do editor de curso.
- Conflito de plugin SEO (Yoast SEO ou Rank Math) com tema que sobrescreve o dashboard.php do Tutor LMS sem a condição de get_header/get_footer, quebrando o painel.
- Permalinks fora de Post Name, o que invalida as rotas REST/AJAX que o Course Builder consome.
- Versão de PHP abaixo de 7.4 ou WordPress abaixo de 5.8, abaixo do mínimo exigido pelo Tutor LMS.
- Limite de memória do WordPress baixo demais para carregar a interface React do builder em cursos com muitas aulas.
Como resolver
- Abra o console do navegador e identifique o erro: pressione F12 no navegador, vá na aba Console e recarregue o Course Builder. Anote se o erro é de nonce, de arquivo .js que retorna 404 ou de extensão do navegador. Teste também com todas as extensões do navegador desativadas.
- Desligue a minificação de JavaScript e HTML no plugin de cache: no seu plugin de cache, desative a minificação e combinação de JS e HTML, ou exclua os scripts do Tutor LMS dessas otimizações. Se usa Jetpack, desative o recurso Protect. Depois limpe todo o cache e o cache do navegador.
Excluir da minificação: /wp-content/plugins/tutor/assets/js/tutor.min.js Excluir da minificação: /wp-content/plugins/tutor/assets/js/tutor-front.min.js - Ajuste os permalinks para Post Name: em Configurações -> Links Permanentes, selecione a opção Nome do post e salve. Isso regenera as rotas que o Course Builder usa para carregar e salvar o curso via REST e AJAX.
- Isole o conflito de plugin e tema: desative os demais plugins e ative um tema padrão para testar o Course Builder isolado. Se voltar a carregar, reative um a um para achar o culpado. Em conflito de tema com plugin SEO, aplique a condição de header e rodapé no dashboard.php do tema.
if ( ! $is_by_short_code && ! defined( 'OTLMS_VERSION' ) ) { get_header(); } if ( ! $is_by_short_code && ! defined( 'OTLMS_VERSION' ) ) { get_footer(); } - Confirme PHP, WordPress e memória: garanta PHP 7.4 ou superior e WordPress 5.8 ou superior, mínimos exigidos pelo Tutor LMS. Eleve o limite de memória do WordPress para cargas maiores do builder. Confira também Tutor LMS -> Tools e Ferramentas -> Saúde do Site.
define( 'WP_MEMORY_LIMIT', '256M' ); define( 'WP_MAX_MEMORY_LIMIT', '512M' );
// wp-config.php — limites que a interface do Course Builder exige (antes de "That's all")
define( 'WP_MEMORY_LIMIT', '256M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );
@ini_set( 'max_input_vars', '3000' ); // currículos com muitas aulas
@ini_set( 'max_execution_time', '300' );Perguntas frequentes
Por que o Course Builder não carrega só depois que instalei um plugin de cache?
O site abre normal mas o Course Builder não. Por quê?
Um plugin de SEO pode quebrar o painel do Tutor LMS?
Como vejo qual é o erro exato do Course Builder?
Os permalinks têm relação com o Course Builder não carregar?
Qual a versão mínima de PHP e WordPress para o Tutor LMS funcionar?
Limpei o cache mas o Course Builder continua em branco. O que faç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.
Como corrigir certificados que não chegam por e-mail no Tutor LMS
No Tutor LMS, o aluno conclui o curso mas não recebe o e-mail com o link do certificado. A causa quase sempre está no addon Email Notifications desativado, no gatilho Completed a Course desligado ou no wp_mail do WordPress caindo em spam por falta de SMTP.
Como corrigir o WPForms Post Submissions que não cria posts no WordPress
O WPForms Post Submissions não cria post quando o addon esta inativo, quando o formulário não foi montado com o template de envio de post, ou quando os campos do formulário não foram conectados aos campos de post na aba Post Submissions das configurações do formulário.
Como corrigir entradas que não salvam no banco de dados no WPForms
Quando entries do WPForms não salvam, o e-mail de notificação chega mas nada aparece em WPForms -> Entries. As causas mais comuns são a versão Lite (gratuita), que só envia por e-mail e não grava no banco, e a opção 'Disable storing entry information in WordPress' marcada no formulário. O conserto é checar a licença e essa opção.
Como corrigir quizzes que não salvam respostas no Tutor LMS
No Tutor LMS, o quiz não salvar respostas significa que o aluno envia mas a tentativa não aparece em Quiz Attempts ou vem com respostas em branco. Quase sempre vem de tabelas customizadas ausentes no banco, do limite max_input_vars estourado, ou do AJAX do Tutor bloqueado por segurança ou cache.
Como corrigir o mapeamento de campos no User Registration do WPForms
O mapeamento de campos no User Registration do WPForms falha quando os dropdowns em Settings -> User Registration não apontam para os campos certos do formulário, quando o campo Email obrigatório esta ausente ou quando a Meta Key de um custom user meta não casa com o nome real do campo, fazendo os dados não chegarem ao perfil do usuário.
