Tutor LMS importar curso: corrigir erro de importação

Tipo Outros erros

Nome do erro Falha na importação de cursos do Tutor LMS EN: Tutor LMS course import failed

Severidade Atenção

Descrição 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.

O que é importação de curso que falha no Tutor LMS?

No Tutor LMS importar curso é feito pelo recurso Import/Export do Tutor LMS Pro, que move cursos entre sites usando um arquivo no formato JSON. Você exporta os cursos de um site em Tutor LMS Pro, aba Tools, e importa esse mesmo arquivo .json no site de destino. A falha de importação acontece quando o arquivo é enviado mas o processo não conclui, ou conclui parcialmente: o curso aparece sem aulas, sem quizzes ou sem os recursos avançados que existiam na origem.

A documentação oficial da Themeum aponta dois pontos que quebram a importação com mais frequência. O primeiro é a dependência de addons: se os cursos exportados usam content drip, pré-requisitos, reuniões online ou outras funcionalidades avançadas, os addons correspondentes do Tutor LMS precisam estar ativos no site de destino antes de importar, senão esses dados não são restaurados. O segundo é o aviso de que importar um arquivo com configurações sobrescreve os ajustes atuais do Tutor LMS. Somado a limites de upload do PHP e à ausência da versão Pro, esses fatores explicam a maioria das importações que falham.

Como identificar

A importação fica processando e não chega à tela de confirmação com os totais importados, ou retorna sem mensagem de sucesso.
O curso é importado mas aparece sem aulas, sem quizzes ou sem o content drip e os pré-requisitos que existiam no site de origem.
Ao escolher o arquivo, surge um erro de upload do tipo ‘The uploaded file exceeds the upload_max_filesize directive’ ou ‘Arquivo muito grande’.
A aba Import/Export não aparece em Tutor LMS > Tools porque o site de destino está com a versão gratuita, sem o Tutor LMS Pro.
O navegador atinge tempo limite (erro 504 ou tela em branco) durante a importação de um arquivo JSON grande com muitos cursos.

Antes de começar: Antes de importar, faça um backup completo do site de destino (arquivos e banco de dados) e, se possível, teste a importação em um ambiente de staging. A importação com a opção Settings marcada sobrescreve as configurações atuais do Tutor LMS e não tem desfazer.

Como prevenir

Antes de importar, replique no site de destino os mesmos addons do Tutor LMS ativos na origem, para que content drip, pré-requisitos e reuniões online sejam restaurados.
Exporte e importe sempre pelo recurso nativo Import/Export do Tutor LMS Pro, sem editar o arquivo .json à mão, para preservar a estrutura esperada pelo importador.
Para cursos grandes, garanta limites de PHP folgados (upload_max_filesize, post_max_size e max_execution_time) no servidor de destino antes de iniciar a importação.
Deixe a opção Settings desmarcada no export quando quiser mover apenas os cursos, evitando sobrescrever as configurações do Tutor LMS no destino.
Mantenha o Tutor LMS e o Tutor LMS Pro na mesma versão estável nos dois sites para reduzir diferenças de estrutura entre origem e destino.

Causa

Os addons usados pelos cursos exportados (content drip, pré-requisitos, reuniões online) não estão ativados no site de destino antes da importação, então esses recursos não são restaurados no curso importado, conforme alerta a documentação oficial da Themeum.
O arquivo JSON exportado ultrapassa o limite de upload do PHP (upload_max_filesize ou post_max_size), fazendo o envio do arquivo ser rejeitado antes da importação começar.
O Tutor LMS Pro não está instalado e ativo no site de destino: o recurso Import/Export é exclusivo da versão Pro, então a aba some de Tutor LMS > Tools e não há como importar.
A importação de um JSON com muitos cursos estoura o max_execution_time do PHP, e o processo é interrompido pelo servidor antes de concluir.
O arquivo selecionado foi gerado por outra ferramenta ou editado manualmente e não é o JSON nativo do Import/Export do Tutor LMS, então o importador não reconhece a estrutura.
A opção de incluir Settings veio marcada no export, e a importação sobrescreve as configurações do Tutor LMS no destino, deixando o ambiente inconsistente com o curso importado.

Como resolver

Confirme o Tutor LMS Pro ativo no site de destino: O recurso Import/Export existe apenas no Tutor LMS Pro. Verifique se a versão Pro está instalada e ativa no site onde você vai importar, senão a aba Import/Export não aparece em Tutor LMS > Tools.
```
Painel WP -> Plugins -> Plugins Instalados
Confirme que 'Tutor LMS Pro' está ativo (além do Tutor LMS gratuito)
```
Ative os addons usados pelos cursos antes de importar: A documentação da Themeum orienta ativar, no site de destino, os addons correspondentes aos recursos dos cursos exportados (content drip, pré-requisitos, reuniões online) antes de importar. Sem eles, o curso importado vem sem esses recursos.
```
Painel WP -> Tutor LMS -> Add-ons
Ative os mesmos addons usados na origem (ex.: Content Drip, Prerequisites)
```
Use a aba Import/Export e selecione o arquivo .json correto: Vá para a aba Import/Export do Tutor LMS Pro e selecione o arquivo .json gerado pelo próprio recurso de exportação. Não use arquivos editados à mão ou de outras ferramentas, pois o importador espera a estrutura nativa do Tutor LMS.
```
Painel WP -> Tutor LMS Pro -> Tools -> aba Import/Export
Na seção Import, clique em 'Choose a File' e selecione o .json exportado
Clique em 'Import' e aguarde a tela de confirmação com os totais importados
```
Aumente os limites de upload e execução do PHP: Se o arquivo é grande e o envio é rejeitado ou a importação expira, aumente os limites do PHP. Você pode pedir ao suporte da hospedagem ou aplicar o trecho da seção de código em wp-config.php ou no php.ini do servidor.
```
Confira o limite atual em Painel WP -> Ferramentas -> Saúde do Site -> Informações -> Servidor
Aumente upload_max_filesize, post_max_size e max_execution_time (ver bloco de código)
```
Reimporte e valide o curso restaurado: Com os addons ativos e os limites ajustados, repita a importação e abra o curso no Course Builder para confirmar que aulas, quizzes e recursos avançados vieram completos. Se exportou com Settings marcado, revise as configurações do Tutor LMS, pois elas foram sobrescritas.
```
Painel WP -> Tutor LMS Pro -> Tools -> Import/Export -> Import (repita)
Painel WP -> Tutor LMS -> Cursos -> abra o curso importado e revise o conteúdo
Painel WP -> Tutor LMS -> Settings -> confira se as configurações continuam corretas
```

INI

; php.ini ou .user.ini na raiz do site — aumenta os limites para
; importar arquivos JSON grandes de cursos do Tutor LMS sem estourar.
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300
max_input_time = 300
memory_limit = 256M

Perguntas frequentes

Qual o formato do arquivo de importação de cursos no Tutor LMS

O recurso Import/Export do Tutor LMS Pro usa o formato JSON. Você exporta os cursos em um arquivo .json e importa esse mesmo arquivo no site de destino, pela aba Import/Export em Tutor LMS Pro > Tools.

Por que o curso importado veio sem content drip ou pré-requisitos

Porque os addons correspondentes não estavam ativos no destino na hora da importação. A documentação da Themeum orienta ativar os addons usados pelos cursos (content drip, pré-requisitos, reuniões online) antes de importar para que esses recursos sejam restaurados.

Não encontro a aba Import Export no Tutor LMS, por quê

O recurso Import/Export é exclusivo do Tutor LMS Pro. Se o site só tem a versão gratuita, a aba não aparece em Tools. Instale e ative o Tutor LMS Pro no site de destino para liberar a importação de cursos.

A importação trava em arquivos grandes, o que fazer

Arquivos grandes podem estourar os limites do PHP. Aumente upload_max_filesize, post_max_size e max_execution_time no servidor, ou peça à hospedagem. Depois repita a importação pela aba Import/Export.

Importar um curso sobrescreve minhas configurações do Tutor LMS

Sobrescreve se o arquivo foi exportado com a opção Settings marcada. A documentação alerta que importar configurações substitui os ajustes atuais. Para mover só os cursos, exporte sem Settings; se já importou, revise as configurações depois.

Posso importar um curso de um site para outro com domínios diferentes

Sim. O Import/Export foi feito para migrar cursos entre sites. Garanta apenas que o destino tenha o Tutor LMS Pro e os mesmos addons ativos, e que os limites de upload do servidor comportem o arquivo .json.

Posso editar o arquivo JSON exportado antes de importar

Não é recomendado. O importador espera a estrutura nativa gerada pela exportação do Tutor LMS. Editar o JSON à mão pode corromper o arquivo e fazer a importação falhar ou trazer o curso incompleto.

A importação do curso traz também os alunos matriculados

O Import/Export move a estrutura do curso (aulas, quizzes e recursos avançados, com os addons ativos), não as matrículas de alunos do site de origem. Os alunos precisam se matricular novamente no site de destino.

Informativo

Como corrigir notificações de Q&A que não chegam aos instrutores no Tutor LMS

As notificações de Q&A do Tutor LMS não chegam aos instrutores quando o addon Email do Tutor LMS Pro está desligado, o gatilho New Q&A Message está desmarcado ou o site não tem um SMTP configurado para entregar o e-mail disparado quando o aluno faz uma pergunta.

Atenção

Como corrigir imagens que não aparecem no WordPress

Imagens que não aparecem no WordPress costumam vir de permissões erradas na pasta wp-content/uploads, de miniaturas que nunca foram geradas ou de URLs em HTTP num site HTTPS. A correção passa por ajustar as permissões para 755 nas pastas e 644 nos arquivos, regenerar as miniaturas e alinhar as URLs ao protocolo do site.

Atenção

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.

Grave

Como corrigir e-mails do WordPress que não são enviados (SMTP)

O WordPress não envia e-mail quando usa a função PHP mail() padrão, que a maioria das hospedagens bloqueia ou marca como spam por falta de autenticação. A correção é configurar SMTP autenticado, que entrega o e-mail por um servidor confiável (do seu domínio, Gmail, Brevo, etc.).

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.

Atenção

Como corrigir o spam no WPForms mesmo com reCAPTCHA ativo

WPForms continuar recebendo spam mesmo com reCAPTCHA ativo costuma indicar que a Proteção Antispam Moderna esta desligada no formulário antigo, que ha um único CAPTCHA por site ou que faltam camadas como tempo mínimo de envio e filtro de palavras.

Setores

Extensões

Integrações

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

O que é importação de curso que falha no Tutor LMS?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir notificações de Q&A que não chegam aos instrutores no Tutor LMS

Como corrigir imagens que não aparecem no WordPress

Como corrigir o WPForms Post Submissions que não cria posts no WordPress

Como corrigir e-mails do WordPress que não são enviados (SMTP)

Como corrigir alunos sem acesso ao login no Tutor LMS

Como corrigir o spam no WPForms mesmo com reCAPTCHA ativo

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