Course Builder não carrega no Tutor LMS: como corrigir

Tipo Outros erros

Nome do erro Course Builder não carrega no Tutor LMS EN: Tutor LMS Course Builder not loading

Severidade Grave

Descrição Quando o Course Builder não carrega no Tutor LMS, o editor de curso fica preso no spinner, abre em branco ou retorna nonce inválido. A causa quase sempre é minificação agressiva de JavaScript por plugin de cache ou conflito de plugin SEO que quebra o painel.

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.

Antes de começar: Faça backup do wp-config.php e do arquivo dashboard.php do tema antes de editá-los. Edite o dashboard.php somente no tema-filho, para que a alteração não se perca na próxima atualização do tema.

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' );
```

PHP

// 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?

Porque a minificação ou compressão agressiva de JavaScript e HTML corrompe os scripts do Tutor LMS e gera nonce inválido. A própria Themeum recomenda manter a compressão de JS e HTML desligada. Exclua os scripts do Tutor LMS dessas otimizações e limpe o cache.

O site abre normal mas o Course Builder não. Por quê?

Porque o site no front-end é HTML estático, enquanto o Course Builder é uma interface JavaScript que carrega dados via AJAX e REST API. Um erro de script, um nonce inválido ou uma rota REST quebrada travam só o editor, não o resto do site.

Um plugin de SEO pode quebrar o painel do Tutor LMS?

Sim. A documentação do Tutor LMS descreve o painel quebrado quando o tema sobrescreve o dashboard.php e usa get_header e get_footer sem a condição correta junto do Yoast ou Rank Math. A correção é aplicar a condição de header e rodapé no dashboard.php do tema-filho.

Como vejo qual é o erro exato do Course Builder?

Pressione F12 no navegador, abra a aba Console e recarregue o editor de curso. O console mostra se é erro de nonce, um arquivo .js que retorna 404 ou um conflito de extensão. Teste também com as extensões do navegador desativadas.

Os permalinks têm relação com o Course Builder não carregar?

Sim. O Tutor LMS recomenda usar a opção Nome do post nos permalinks. Estruturas diferentes podem invalidar as rotas REST e AJAX que o builder usa para carregar e salvar o curso. Ajuste em Configurações, Links Permanentes, e salve.

Qual a versão mínima de PHP e WordPress para o Tutor LMS funcionar?

O Tutor LMS exige PHP 7.4 ou superior e WordPress 5.8 ou superior, tanto na versão Free quanto na Pro. Versões antigas podem impedir o Course Builder de carregar. Confirme em Ferramentas, Saúde do Site, e atualize o que estiver abaixo do mínimo.

Limpei o cache mas o Course Builder continua em branco. O que faço?

Faça o teste de conflito: desative os demais plugins e ative um tema padrão. Se o builder voltar, reative um a um para achar o culpado. Limpe também o cache do navegador, pois ele pode reter os scripts minificados antigos.

Atenção

Como corrigir a importação de cursos que falha no Tutor LMS

No Tutor LMS importar curso falha quando o arquivo JSON é importado sem os addons correspondentes ativos, o upload estoura o limite do PHP, ou o recurso de Import/Export do Tutor LMS Pro não está disponível no site de destino.

Atenção

Como corrigir o Survey and Polls que não exibe resultados no WordPress

O WPForms não mostra resultados de survey quando o reporting não foi ativado no formulário, quando o campo usado não e suportado pelo addon Surveys and Polls, ou quando ainda não ha entradas coletadas para calcular o relatório.

Informativo

Como corrigir a exportação de dados de alunos que falha no Tutor LMS no WordPress

A exportação de dados de aluno no Tutor LMS falha quando o addon Reports do Tutor LMS Pro está desativado, quando o botão Download CSV em Analytics não responde por conflito de JavaScript, ou quando o servidor interrompe o download por limite de PHP, gerando um arquivo CSV vazio ou nenhum download.

Atenção

Como corrigir o course archive que não exibe todos os cursos no Tutor LMS

O Tutor LMS course archive não mostra todos os cursos quando há cursos fora do status Publicado, paginação limitando a quantidade exibida, cache servindo uma versão antiga da página ou um filtro de categoria ativo escondendo parte da lista.

Grave

Como identificar conflito de plugins no WordPress

Identificar um conflito de plugins no WordPress é o processo de isolar qual plugin (ou combinação com tema) quebra uma função do site. O método é desativar tudo, confirmar que o problema some e reativar um a um até o erro voltar, apontando o culpado.

Grave

Como corrigir alunos sem acesso ao login no Tutor LMS

Quando o aluno do Tutor LMS não consegue logar, ele e jogado para uma tela de login que recarrega sem entrar, cai em página 404 ou e redirecionado para o wp-admin sem ver os cursos. A causa mais comum e a página Dashboard do Tutor ausente ou não atribuida, seguida de um plugin de cache ou segurança bloqueando o POST de login.

Setores

Extensões

Integrações

Como corrigir o Course Builder que não carrega no Tutor LMS

O que é o Course Builder que não carrega no Tutor LMS?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir a importação de cursos que falha no Tutor LMS

Como corrigir o Survey and Polls que não exibe resultados no WordPress

Como corrigir a exportação de dados de alunos que falha no Tutor LMS no WordPress

Como corrigir o course archive que não exibe todos os cursos no Tutor LMS

Como identificar conflito de plugins no WordPress

Como corrigir alunos sem acesso ao login no Tutor LMS

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