Exportação de dados no Tutor LMS: corrigir erro no export

Tipo Outros erros

Nome do erro Exportação de dados de alunos falha no Tutor LMS EN: Tutor LMS student data CSV export fails

Severidade Informativo

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

O que é exportação de dados de alunos no Tutor LMS?

A exportação de dados de aluno no Tutor LMS é o recurso que transforma os relatórios de alunos matriculados, progresso e vendas em um arquivo CSV baixável. Segundo a documentação oficial da Themeum, esse recurso pertence ao addon Reports, exclusivo do Tutor LMS Pro: o administrador o ativa em Tutor LMS Pro e o exporta pelo Frontend Dashboard em Analytics, clicando no botão Download CSV. Sem o addon ativo, não existe botão de exportação para acionar.

O erro aparece de três formas práticas. O botão Download CSV não está presente porque o addon Reports nunca foi habilitado. O botão existe mas não dispara o download, normalmente por um conflito de JavaScript no painel que bloqueia a requisição AJAX da exportação. Ou o download começa e entrega um CSV vazio ou truncado, quando o volume de alunos estoura limites de PHP como o tempo máximo de execução ou a memória disponível, e o servidor encerra o processo antes de montar o arquivo completo.

Como identificar

O botão ‘Download CSV’ não aparece na aba Analytics do Frontend Dashboard, mesmo com o Tutor LMS Pro ativo.
Ao clicar em ‘Download CSV’ nada acontece: nenhum arquivo é baixado e a página não dá retorno.
O arquivo CSV é baixado, mas abre vazio ou só com o cabeçalho das colunas, sem as linhas de alunos.
O download começa e é interrompido na metade, gerando um CSV truncado quando há muitos alunos matriculados.
No console do navegador (F12) surge um erro de JavaScript ou uma resposta 500 da requisição admin-ajax ao tentar exportar.
A página de relatório fica em ‘carregando’ indefinidamente e o navegador acusa tempo de requisição esgotado durante a exportação.

Antes de começar: Os relatórios de alunos contêm dados pessoais (nome e e-mail). Antes de editar limites de PHP em arquivos do servidor ou desativar plugins em produção, faça backup do site e do banco de dados ou teste em staging, e trate o CSV exportado como dado sensível, removendo-o de pastas públicas após o uso.

Como prevenir

Mantenha o addon Reports do Tutor LMS Pro sempre ativo em sites que precisam exportar dados de alunos, para que o botão Download CSV nunca dependa de reativação na hora.
Dimensione max_execution_time e memory_limit do PHP conforme o número de alunos cresce, validando a exportação em staging após cada salto grande de matrículas.
Mantenha admin-ajax.php fora de regras agressivas de cache e do bloqueio do firewall, já que a exportação do Tutor LMS depende dessa requisição.
Atualize Tutor LMS Pro e WordPress na versão estável mais recente e valide a exportação em staging antes de subir, acompanhando mudanças no addon Reports.

Causa

O addon Reports do Tutor LMS Pro está desativado em Tutor LMS Pro -> Add-ons, então o menu Report e o botão Download CSV em Analytics nem chegam a ser renderizados (a doc oficial coloca a exportação dentro desse addon).
O usuário que tenta exportar não é administrador nem instrutor com a capability adequada, então a ação de exportação do Frontend Dashboard é negada e devolve resposta vazia.
Um conflito de JavaScript com outro plugin ou tema interrompe o script do painel do Tutor LMS antes da requisição admin-ajax de exportação disparar, fazendo o clique em Download CSV não responder.
O número de alunos matriculados ultrapassa o limite de max_execution_time ou de memory_limit do PHP, e o servidor encerra o processo de geração do CSV no meio, devolvendo um arquivo truncado ou vazio.
Um plugin de cache ou de segurança (firewall/WAF) bloqueia ou serve uma versão em cache da requisição admin-ajax.php de exportação, impedindo que o CSV recém-gerado seja entregue ao navegador.

Como resolver

Ative o addon Reports no Tutor LMS Pro: A exportação de dados de aluno só existe com o addon Reports do Tutor LMS Pro ligado. Ative-o e confirme que o menu Report passa a aparecer no painel do Tutor LMS, conforme a documentação oficial da Themeum.
```
Painel WP -> Tutor LMS Pro -> Add-ons
Localize 'Reports' e ative a chave (toggle)
Confirme que o menu 'Report' agora aparece sob Tutor LMS no admin
```
Exporte pelo caminho correto do Frontend Dashboard: A exportação é feita pelo painel do usuário, não pelo admin. Acesse o Frontend Dashboard, abra Analytics e clique em Download CSV para baixar os dados de alunos e vendas em CSV, como indica a doc do addon Reports.
```
Acesse SeuSite/dashboard (Frontend Dashboard)
Abra a aba Analytics -> Export
Clique no botão 'Download CSV'
```
Confirme a permissão de quem exporta: A exportação responde vazio quando o usuário não tem capability para acessar os relatórios. Faça a exportação como administrador, ou garanta que o instrutor tenha permissão de ver os relatórios dos próprios cursos antes de tentar baixar o CSV.
```
Faça login como Administrador e repita a exportação para isolar problema de permissão
Painel WP -> Usuários -> confirme o papel do usuário que exporta (Administrador ou Instrutor)
Em Tutor LMS Pro -> Add-ons, confirme que o instrutor tem acesso ao relatório dos próprios cursos
```
Aumente os limites de PHP para volumes grandes: Quando o CSV vem vazio ou truncado com muitos alunos, o servidor está encerrando o processo por estourar tempo ou memória. Eleve max_execution_time e memory_limit e tente exportar de novo. Use staging ou faça backup antes de mexer em arquivos do servidor.
```
Edite o php.ini (ou wp-config.php / .htaccess conforme o host)
max_execution_time = 300
memory_limit = 512M
Reinicie o PHP/servidor e refaça a exportação
```
Descarte conflito de JavaScript, cache e firewall: Se o botão Download CSV não responde mesmo com tudo certo, isole a interferência. Limpe o cache, libere o admin-ajax.php no firewall e desative os demais plugins um a um, recarregando o painel a cada teste para achar o que bloqueia a requisição de exportação.
```
Limpe o cache do plugin de cache e do CDN/Cloudflare
Adicione admin-ajax.php à allowlist do firewall/WAF (não cachear)
Painel WP -> Plugins -> desative os demais plugins um a um e teste o Download CSV a cada vez
Abra o console do navegador (F12 -> Console) e observe o erro ao clicar em exportar
```

PHP

<?php
/**
 * Contorno: exporta as matriculas do Tutor LMS em CSV quando o botao do painel falha.
 * Acesse /wp-admin/admin-post.php?action=full_tutor_export_alunos como administrador.
 */
add_action( 'admin_post_full_tutor_export_alunos', 'full_tutor_export_alunos' );
function full_tutor_export_alunos() {
    if ( ! current_user_can( 'manage_options' ) ) {
        wp_die( 'Permissao negada.' );
    }

    // Matriculas do Tutor LMS sao posts do tipo 'tutor_enrolled'.
    $matriculas = get_posts( array(
        'post_type'      => 'tutor_enrolled',
        'post_status'    => 'completed',
        'posts_per_page' => -1,
        'fields'         => 'ids',
    ) );

    header( 'Content-Type: text/csv; charset=utf-8' );
    header( 'Content-Disposition: attachment; filename=alunos-tutor-lms.csv' );
    $out = fopen( 'php://output', 'w' );
    fputcsv( $out, array( 'aluno', 'email', 'curso_id', 'data' ) );

    foreach ( $matriculas as $id ) {
        $post  = get_post( $id );
        $user  = get_userdata( $post->post_author );
        if ( ! $user ) {
            continue;
        }
        fputcsv( $out, array(
            $user->display_name,
            $user->user_email,
            $post->post_parent, // ID do curso
            $post->post_date,
        ) );
    }
    fclose( $out );
    exit;
}

Perguntas frequentes

Por que não aparece o botão de exportar dados de aluno no Tutor LMS

Na maioria dos casos o addon Reports do Tutor LMS Pro está desativado. A exportação pertence a esse addon, então ative-o em Tutor LMS Pro -> Add-ons e o botão Download CSV passa a aparecer na aba Analytics do Frontend Dashboard.

Preciso do Tutor LMS Pro para exportar dados de alunos

Sim. Segundo a documentação oficial da Themeum, a exportação de relatórios em CSV faz parte do addon Reports, que é exclusivo do Tutor LMS Pro. Na versão gratuita não há o botão Download CSV para baixar os dados de alunos.

Onde fica o Download CSV dos relatórios de alunos no Tutor LMS

A exportação é feita pelo Frontend Dashboard, não pelo admin. Acesse SeuSite/dashboard, abra a aba Analytics e clique em Export, depois em Download CSV para baixar os dados de alunos e vendas em arquivo CSV.

Por que o CSV exportado do Tutor LMS vem vazio ou pela metade

Isso costuma ser limite de PHP. Com muitos alunos, o servidor estoura o max_execution_time ou o memory_limit e encerra a geração do arquivo antes de terminar. Eleve esses limites no servidor e refaça a exportação para gerar o CSV completo.

Cliquei em Download CSV e nada acontece, o que fazer

Quase sempre é conflito de JavaScript, cache ou firewall bloqueando a requisição admin-ajax. Limpe o cache, libere o admin-ajax.php no firewall e desative os demais plugins um a um, recarregando o painel a cada teste para achar o que trava a exportação.

Um instrutor consegue exportar os dados de alunos no Tutor LMS

Depende da permissão. A exportação responde vazio quando o usuário não tem capability para acessar os relatórios. Faça a exportação como administrador para confirmar, e garanta que o instrutor tenha acesso aos relatórios dos próprios cursos.

Posso exportar os dados de alunos por código em vez do botão

Sim, dá para gerar um CSV das matrículas por código quando o painel falha. Um script que consulta as matrículas e usa fputcsv monta o arquivo no servidor, mas use isso como contorno e mantenha o addon Reports como o caminho oficial.

Grave

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

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.

Crítico

Como corrigir o erro de pagamento (Stripe e PayPal) no Tutor LMS

O pagamento do Tutor LMS não funciona quando o aluno tenta comprar um curso pelo Stripe ou PayPal e o checkout não conclui ou o pedido nunca confirma. Quase sempre vem de chaves de API no ambiente errado (Test no lugar de Live), webhook não configurado no gateway, ou mais de uma engine de eCommerce ativa ao mesmo tempo.

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 layout quebrado no mobile do WPForms no WordPress

O layout quebrado no mobile do WPForms acontece quando as colunas do formulário não empilham em coluna única no celular, geralmente porque a configuração Include Form Styling esta reduzida, falta a classe wpforms-mobile-full nos campos ou o CSS do tema sobrescreve os estilos do plugin.

Grave

Como corrigir e-mails de notificação que não chegam no Tutor LMS

No Tutor LMS, os e-mails automáticos como matrícula, boas-vindas e conclusão de curso não chegam aos alunos nem aos instrutores. A causa quase sempre está no addon Email Notifications desativado, nos gatilhos de e-mail desligados ou no wp_mail do WordPress sem SMTP autenticado caindo em spam.

Informativo

Como corrigir o favicon que não atualiza no WordPress

O favicon que não atualiza no WordPress quase sempre é cache: o navegador, o plugin de cache ou o CDN ainda servem o ícone antigo. A correção é trocar o ícone do site pelo Personalizar, limpar todas as camadas de cache e forçar o navegador a baixar o arquivo novo.

Setores

Extensões

Integrações

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

O que é exportação de dados de alunos no Tutor LMS?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

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

Como corrigir o erro de pagamento (Stripe e PayPal) no Tutor LMS

Como corrigir imagens que não aparecem no WordPress

Como corrigir o layout quebrado no mobile do WPForms no WordPress

Como corrigir e-mails de notificação que não chegam no Tutor LMS

Como corrigir o favicon que não atualiza no WordPress

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