Tutor LMS certificado não gera PDF: como corrigir

Tipo Outros erros

Nome do erro Certificado nao gera PDF no Tutor LMS EN: Tutor LMS certificate not generating PDF

Severidade Atenção

Descrição O certificado que não gera PDF no Tutor LMS acontece, na maioria das vezes, porque a extensão PHP Imagick esta ausente no servidor, o addon de Certificado não foi ativado, nenhum template foi atribuido ao curso ou a imagem de fundo esta fora das dimensoes exigidas.

O que é certificado que não gera PDF no Tutor LMS?

O certificado no Tutor LMS e gerado pelo addon de Certificado (recurso PRO): ao concluir um curso, o aluno ve o botão View Certificate na página de visao geral do curso e pode baixar o documento em PDF ou JPG. A geração do arquivo depende do servidor renderizar a imagem do certificado a partir do template atribuido ao curso, o que exige uma extensão grafica do PHP e recursos de processamento.

O problema de certificado que não gera PDF no Tutor LMS aparece quando essa renderizacao falha: o botão de download não surge, o clique não gera arquivo, ou o PDF baixa em branco ou com a imagem distorcida. Segundo a documentação oficial da Themeum, a causa número um e a falta da extensão PHP Imagick no servidor: sem ela, o recurso de certificado simplesmente não funciona. Hospedagens compartilhadas frequentemente não habilitam o Imagick por padrão.

Como identificar

O botão ‘View Certificate’ não aparece na página de visao geral do curso mesmo depois de o aluno concluir 100% do conteúdo.
Ao clicar em baixar, nenhum arquivo PDF e gerado e a tela fica em branco ou volta para a página do curso.
O PDF baixa, mas vem totalmente em branco ou apenas com o texto, sem a imagem de fundo do certificado.
A imagem do certificado aparece distorcida, esticada ou cortada no PDF gerado.
No log de erros do PHP surge algo como ‘Call to undefined function imagick’ ou ‘Class Imagick not found’ ao tentar gerar o certificado.
A geração trava e retorna erro de tempo esgotado (‘Maximum execution time exceeded’) ou de memória em sites com muitos certificados.

Antes de começar: Antes de editar o php.ini, o wp-config.php ou trocar a imagem do template em producao, faça um backup completo do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para poder reverter caso a geração do certificado continue falhando.

Como prevenir

Antes de habilitar certificados em producao, confirme com o provedor que a extensão PHP Imagick esta instalada e ativa no servidor.
Padronize as imagens de fundo dos templates em png/jpg/jpeg de até 150KB nas dimensoes 852×606 ou 606×852, validando cada template no Certificate Builder antes de atribuir ao curso.
Mantenha o PHP, o MySQL e o Tutor LMS Pro nas versões suportadas, testando atualizações em staging antes de aplicar no site ao vivo.
Reserve memory_limit e max_execution_time folgados para a geração de PDF e monitore os recursos do servidor em cursos com muitos alunos concluindo ao mesmo tempo.
Sempre atribua um template de certificado ao criar um curso e conclua um teste de ponta a ponta gerando um certificado de exemplo antes de publicar.

Causa

A extensão PHP Imagick não esta instalada nem habilitada no servidor: segundo a doc oficial da Themeum, sem o Imagick o recurso de certificado do Tutor LMS não funciona, e muitas hospedagens compartilhadas não a ativam por padrão.
O addon de Certificado não foi ativado em Tutor LMS Pro -> Add-ons, entao o motor que renderiza e baixa o documento nem e carregado para o curso.
Nenhum template de certificado foi atribuido ao curso na seção Certificate Template da edição do curso, fazendo o botão de download não aparecer após a conclusão.
A imagem de fundo do certificado esta fora das regras da doc oficial: passa de 150KB, usa formato diferente de png/jpg/jpeg ou não tem as dimensoes 852x606 (paisagem) ou 606x852 (retrato), gerando PDF em branco ou distorcido.
Os recursos do servidor (CPU e RAM) ou o memory_limit/max_execution_time do PHP são baixos demais para renderizar a imagem do certificado, e o processo de geração estoura antes de concluir o PDF.
A versão do PHP ou do MySQL esta defasada em relacao ao exigido pelo Tutor LMS Pro, fazendo a rotina de geração do certificado falhar no servidor.

Como resolver

Confirme que o addon de Certificado esta ativo: Antes de mexer no servidor, garanta que o motor do certificado esta ligado. No painel do Tutor LMS Pro, abra a área de Add-ons e ative o Certificate. Sem o addon ativo, o botão de download nem e gerado.
```
Painel WP -> Tutor LMS Pro -> Add-ons
Localize 'Certificate' e ative o interruptor
Salve as alterações
```
Atribua um template de certificado ao curso: Na edição do curso, va até a seção Certificate Template, escolha um modelo (pre-pronto ou criado no Certificate Builder) e clique em Use This. Um curso sem template atribuido não mostra o botão View Certificate ao aluno.
```
Painel WP -> Cursos -> abra o curso -> seção 'Certificate Template'
Selecione um template e clique em 'Use This'
Clique em 'Update' para salvar o curso
```
Verifique se a extensão PHP Imagick esta habilitada: Esta e a causa número um segundo a doc oficial: sem o Imagick o certificado não gera. Crie um arquivo de diagnostico ou abra Ferramentas -> Saude do site -> Info para conferir se o Imagick aparece entre as extensões ativas. Se não aparecer, peca ao seu provedor de hospedagem para instalar e ativar a extensão Imagick do PHP.
```
Painel WP -> Ferramentas -> Saude do site -> aba Informações -> seção Servidor
Procure 'Imagick' na lista de módulos do PHP
Se ausente: abra um chamado no provedor pedindo a extensão 'php-imagick'
```
Ajuste a imagem de fundo do certificado: Abra o template no Certificate Builder e confira a imagem de fundo. A doc oficial exige png, jpg ou jpeg de no máximo 150KB com dimensoes 852x606 para paisagem ou 606x852 para retrato. Fora dessas regras o PDF sai em branco ou distorcido. Reexporte a imagem no tamanho correto e troque no template.
```
Painel WP -> Tutor LMS Pro -> Certificate Builder -> abra o template
Substitua a imagem de fundo por um arquivo png/jpg/jpeg <= 150KB
Use 852x606 px (paisagem) ou 606x852 px (retrato) e salve
```
Aumente os limites de PHP do servidor: A renderizacao do certificado consome CPU e RAM. Se a geração trava ou estoura, eleve memory_limit e max_execution_time no php.ini (ou no wp-config como interim) e confirme que o PHP e o MySQL estão em versões suportadas pelo Tutor LMS Pro. Reinicie o PHP após editar o php.ini.
```
memory_limit = 256M
max_execution_time = 120
Após editar o php.ini, reinicie o serviço PHP (PHP-FPM)
```

PHP

<?php
// Diagnostico: rode via WP-CLI (wp eval-file check-cert.php) ou mu-plugin temporario.
// Confirma os pre-requisitos de geracao de certificado do Tutor LMS.

$ok = true;

// 1. Extensao Imagick (causa numero um na doc oficial).
if ( ! extension_loaded( 'imagick' ) || ! class_exists( 'Imagick' ) ) {
    echo "[FALHA] Extensao PHP Imagick ausente. Peca ao provedor o pacote php-imagick.n";
    $ok = false;
} else {
    echo "[OK] Imagick carregado.n";
}

// 2. Limites de PHP para renderizar o PDF.
$mem = (int) ini_get( 'memory_limit' );
if ( $mem > 0 && $mem < 256 ) {
    echo "[ALERTA] memory_limit em {$mem}M. Recomendado 256M para gerar o PDF.n";
}
if ( (int) ini_get( 'max_execution_time' ) > 0 && (int) ini_get( 'max_execution_time' ) < 120 ) {
    echo "[ALERTA] max_execution_time baixo. Recomendado 120s.n";
}

// 3. Addon de Certificado ativo no Tutor LMS Pro.
if ( function_exists( 'tutor_utils' ) ) {
    $addons = (array) get_option( 'tutor_addons_config', array() );
    $cert   = $addons['tutor-pro/addons/tutor-certificate/tutor-certificate.php'] ?? array();
    if ( empty( $cert['is_enable'] ) ) {
        echo "[FALHA] Addon Certificate desativado em Tutor LMS Pro -> Add-ons.n";
        $ok = false;
    } else {
        echo "[OK] Addon Certificate ativo.n";
    }
}

echo $ok ? "Pre-requisitos do certificado OK.n" : "Corrija os itens [FALHA] acima.n";

Perguntas frequentes

Por que o certificado do Tutor LMS não gera o PDF

Na maioria dos casos falta a extensão PHP Imagick no servidor, que a documentação oficial da Themeum aponta como obrigatoria para o recurso de certificado. Verifique em Ferramentas -> Saude do site se o Imagick aparece e, se não, peca ao provedor para instalar a extensão php-imagick.

O botão de baixar certificado não aparece para o aluno, o que fazer

O botão View Certificate so surge quando o addon de Certificado esta ativo, um template foi atribuido ao curso e o aluno concluiu 100% do conteúdo. Confirme os três requisitos: ative o addon em Add-ons, atribua um template na edição do curso e cheque o progresso do aluno.

O certificado baixa em branco ou distorcido, qual a causa

Quase sempre a imagem de fundo esta fora das regras da doc oficial. Use png, jpg ou jpeg de no máximo 150KB com dimensoes 852x606 (paisagem) ou 606x852 (retrato). Reexporte a imagem no tamanho certo e troque no template pelo Certificate Builder.

Preciso de uma extensão específica do PHP para o certificado funcionar

Sim. A documentação do Tutor LMS afirma que a extensão Imagick precisa estar instalada e ativa, pois sem ela o recurso de certificado não funciona. Muitas hospedagens compartilhadas não habilitam o Imagick por padrão, entao confirme com o provedor.

A geração do certificado da erro de tempo esgotado ou de memória

A renderizacao consome CPU e RAM. Aumente o memory_limit e o max_execution_time no php.ini, garanta PHP e MySQL em versões suportadas e verifique os recursos do servidor, especialmente em sites com muitos certificados sendo gerados ao mesmo tempo.

O certificado funciona sem o Tutor LMS Pro

Não. O addon de Certificado e um recurso PRO do Tutor LMS. Ele precisa ser ativado em Tutor LMS Pro -> Add-ons para que o motor que renderiza e baixa o certificado em PDF ou JPG seja carregado nos cursos.

Posso baixar o certificado em outro formato além de PDF

Sim. Na tela do certificado o aluno pode baixar em PDF ou JPG e também imprimir pelo navegador. Se o PDF falhar mas o JPG funcionar, o problema costuma estar na renderizacao do PDF pelo servidor, reforcando a checagem do Imagick e dos limites do PHP.

Como saber se o problema e do servidor ou do Tutor LMS

Cheque primeiro o servidor: confirme o Imagick em Saude do site, as versões de PHP e MySQL e os limites de memória. Se tudo estiver correto, teste com um tema padrão e desative outros plugins para descartar conflito, recarregando a página do certificado a cada teste.

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 feed RSS com erro no WordPress

O erro no feed RSS do WordPress aparece quando o navegador ou validador mostra uma falha de XML, normalmente porque há espaço ou texto antes da abertura do feed. A correção é localizar a saída extra (functions.php, wp-config.php ou plugin) e remover o espaço em branco antes da tag de XML.

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.

Informativo

Como corrigir a duplicação e a exportação de formulários no WPForms

O erro de clone e export no WPForms acontece quando o botão Duplicar não aparece, a exportação gera um arquivo vazio ou a importação do JSON falha por limite de upload do PHP, addon ausente ou arquivo de outro plugin de formulário.

Atenção

Como corrigir custom field do ACF que não exibe em cursos do Tutor LMS no WordPress

No ACF Tutor LMS, o custom field não exibe no curso quase sempre porque a regra de localização do grupo de campos não aponta para o tipo de post courses, ou porque o template do curso chama get_field sem o ID do curso correto, deixando o valor do meta vazio na página.

Crítico

Erro de enrollment no Tutor LMS: aluno não consegue comprar o curso

O erro de enrollment no Tutor LMS acontece quando o aluno tenta comprar um curso pago e a matrícula não é concluída: o botão de compra não aparece ou o pagamento passa mas o acesso nunca é liberado. Costuma vir do produto WooCommerce não vinculado ao curso, do curso marcado como Gratuito ou do pedido que não chega a Concluído.

Setores

Extensões

Integrações

Como corrigir certificados que não geram PDF no Tutor LMS

O que é certificado que não gera PDF no Tutor LMS?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir imagens que não aparecem no WordPress

Como corrigir o feed RSS com erro no WordPress

Como corrigir o favicon que não atualiza no WordPress

Como corrigir a duplicação e a exportação de formulários no WPForms

Como corrigir custom field do ACF que não exibe em cursos do Tutor LMS no WordPress

Erro de enrollment no Tutor LMS: aluno não consegue comprar o curso

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