Certificado personalizado Tutor LMS: corrigir o erro

Tipo Outros erros

Nome do erro Certificado personalizado nao funciona no Tutor LMS EN: Tutor LMS custom certificate not working

Severidade Atenção

Descrição O certificado personalizado no Tutor LMS depende do addon Certificates do Tutor LMS Pro e do plugin Certificate Builder. Quando um deles esta inativo, desatualizado ou o template não foi atribuido ao curso, o certificado some, não salva no construtor ou não chega ao aluno.

O que é certificado personalizado no Tutor LMS?

O certificado personalizado no Tutor LMS e um modelo de certificado desenhado por você no Certificate Builder, em vez dos templates prontos que acompanham o plugin. Segundo a documentação oficial da Themeum, ele exige três pecas funcionando juntas: o Tutor LMS Pro, o addon Certificates ativado em Tutor LMS Pro -> Add-ons, e o plugin Certificate Builder, que e um download separado da sua conta na Themeum. So com as três ativas o menu Certificate Builder aparece no admin e você consegue montar o template com as seções Templates, Elements, Media, Library, Backdrops e Layers.

O erro acontece quando esse encadeamento quebra. Se o Certificate Builder não foi instalado ou o addon esta desligado, o menu de construcao nem aparece e o template personalizado some. Se o template foi criado mas não foi atribuido na seção Certificate Template dentro do curso, o aluno termina o curso e não ve o botão View Certificate. E quando o toggle de instrutores esta mal configurado, instrutores deixam de enxergar os modelos feitos pelo admin. O resultado pratico e sempre o mesmo: o certificado que você desenhou não chega a quem concluiu o curso.

Como identificar

O menu Certificate Builder não aparece no admin do Tutor LMS, mesmo com o Tutor LMS Pro ativo.
Após concluir o curso, o aluno não ve o botão View Certificate na Course Overview Page.
O template personalizado não consta na lista da seção Certificate Template ao editar o curso, so aparecem os modelos padrão.
O Certificate Builder abre mas o template não salva, ou volta em branco ao reabrir para edição.
Instrutores relatam que não conseguem usar os modelos criados pelo admin, apenas os próprios.
O curso entrega um certificado genérico padrão em vez do modelo personalizado que você desenhou.

Antes de começar: Antes de instalar ou atualizar o Certificate Builder e de mexer nas configurações de certificado em producao, faça um backup completo do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para reverter caso a ativacao de um addon pago entre em conflito com a versão do core.

Como prevenir

Mantenha o Tutor LMS Pro e o Certificate Builder sempre na mesma geração de versão, atualizando os dois juntos, já que são produtos pagos com versões acopladas.
Documente em qual curso cada certificado personalizado esta atribuido, para um ajuste de template não deixar cursos com a opção None sem querer.
Após criar ou editar um template, conclua um curso de teste com um usuário aluno e confirme que o botão View Certificate aparece na Course Overview Page.
Padronize o fluxo de criadores de curso: se instrutores publicam cursos, deixe o toggle de modelos do admin sempre ligado para evitar certificados faltando.

Causa

O plugin Certificate Builder não esta instalado: ele e um download separado da conta Themeum (https://tutorlms.com/account/downloads/) e precisa ser instalado a parte do Tutor LMS Pro para o menu de construcao existir.
O addon Certificates esta desligado em Tutor LMS Pro -> Add-ons, entao toda a funcionalidade de certificado, incluindo o builder, fica indisponivel.
O template personalizado foi criado mas não foi atribuido ao curso: na edição do curso, a seção Certificate Template continua no modelo padrão ou na opção None em vez do template novo.
O toggle 'Allow Instructors To Use Templates Built by the Admins' esta desativado em Tutor LMS Pro -> Settings -> Certificate, fazendo os instrutores não enxergarem os modelos do admin.
O Tutor LMS Pro ou o Certificate Builder estão desatualizados: por serem produtos pagos com versões acopladas, uma versão defasada do builder pode não casar com a versão do core e impedir o salvamento do template.

Como resolver

Ative o addon Certificates: O addon Certificates e a base de tudo. Sem ele, nem o builder nem a atribuicao por curso funcionam. Ative-o na lista de add-ons do Tutor LMS Pro, conforme a documentação oficial da Themeum.
```
Painel WP -> Tutor LMS Pro -> Add-ons
Localize o card Certificates e ligue o toggle para Ativado
```
Instale o plugin Certificate Builder: O construtor de certificados personalizados e um plugin separado, baixado da sua conta Themeum. Sem ele instalado e ativo, o menu de construcao não aparece e você so tem os templates prontos.
```
Acesse https://tutorlms.com/account/downloads/ e baixe o Tutor LMS Certificate Builder
Painel WP -> Plugins -> Adicionar novo -> Enviar plugin -> selecione o .zip baixado
Instale e clique em Ativar
```
Crie o certificado no Certificate Builder: Com addon e plugin ativos, surge o menu Certificate Builder no admin. Monte o modelo usando as seções Templates, Elements, Media, Backdrops e Layers, e salve ao final para que ele fique disponível na lista de templates do curso.
```
Painel WP -> Tutor LMS Pro -> Certificate Builder
Escolha um Template inicial e edite Elements, Media, Backdrops e Layers
Clique em Salvar para gerar o certificado personalizado
```
Atribua o template ao curso: Criar o certificado não basta: ele precisa ser escolhido dentro do curso. Edite o curso, va até a seção Certificate Template e selecione o seu modelo personalizado, nunca a opção None, antes de atualizar.
```
Painel WP -> Cursos -> abra o curso -> role até Certificate Template
Clique na miniatura do seu certificado personalizado e em Use This
Clique em Atualizar (Update) para salvar a atribuicao
```
Libere os modelos do admin para instrutores: Se quem cria os cursos são instrutores e não o admin, eles precisam de permissão para usar os modelos do admin. Ligue o toggle correspondente na aba Certificate das configurações do Tutor LMS Pro.
```
Painel WP -> Tutor LMS Pro -> Settings -> Certificate
Ligue 'Allow Instructors To Use Templates Built by the Admins'
Clique em Salvar (Save Changes)
```

PHP

<?php
// Diagnostico rapido: confirma se as pecas do certificado personalizado estao ativas.
add_action( 'admin_notices', 'full_tutor_certificate_health_check' );
function full_tutor_certificate_health_check() {
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    $pro    = function_exists( 'tutor_pro' );
    $addon  = function_exists( 'tutor_utils' ) && tutor_utils()->is_addon_enabled( 'tutor-certificate/tutor-certificate.php' );
    $builder = defined( 'TUTOR_CERT_BUILDER_VERSION' ) || class_exists( 'TUTOR_CERT\Init' );
    if ( $pro && $addon && $builder ) {
        return; // tudo certo, nada a avisar
    }
    $faltando = array();
    if ( ! $pro )     { $faltando[] = 'Tutor LMS Pro'; }
    if ( ! $addon )   { $faltando[] = 'addon Certificates (Tutor LMS Pro -> Add-ons)'; }
    if ( ! $builder ) { $faltando[] = 'plugin Certificate Builder'; }
    echo '<div class="notice notice-error"><p>Certificado personalizado do Tutor LMS indisponivel. Ative/instale: ' . esc_html( implode( ', ', $faltando ) ) . '.</p></div>';
}

Perguntas frequentes

Por que o menu Certificate Builder não aparece no Tutor LMS

Porque ele depende de duas pecas separadas. Você precisa ativar o addon Certificates em Tutor LMS Pro -> Add-ons e instalar o plugin Certificate Builder, que e um download a parte da conta Themeum. Com os dois ativos, o menu Certificate Builder surge no admin.

Preciso do Tutor LMS Pro para usar certificado personalizado

Sim. O addon Certificates e o Certificate Builder fazem parte do Tutor LMS Pro. Na versão gratuita não ha o construtor de certificados personalizados, apenas o que o core oferece, entao a licenca Pro e obrigatoria para esse recurso.

Criei o certificado mas o aluno não recebe, o que falta

Quase sempre falta atribuir o template ao curso. Edite o curso, va até a seção Certificate Template e selecione o modelo personalizado em vez da opção None ou do padrão. Sem essa atribuicao, o aluno conclui o curso e não ve o botão View Certificate.

Onde baixo o plugin Certificate Builder do Tutor LMS

Ele fica na área de Downloads da sua conta Themeum, em https://tutorlms.com/account/downloads/. Baixe o arquivo, envie em Plugins -> Adicionar novo -> Enviar plugin e ative. So depois disso o menu Certificate Builder aparece no admin.

Meus instrutores não veem os modelos que criei como admin

Esse comportamento e controlado por um toggle. Va em Tutor LMS Pro -> Settings -> Certificate e ligue 'Allow Instructors To Use Templates Built by the Admins'. Sem ele ativo, cada instrutor so enxerga os próprios modelos, não os do admin.

Como troco o certificado padrão por um personalizado num curso

Abra o curso na edição, role até a seção Certificate Template, clique na miniatura do seu certificado personalizado e em Use This, depois clique em Atualizar. O próximo aluno que concluir o curso recebe o novo modelo.

Posso definir um certificado diferente para cada curso

Sim. A atribuicao do certificado e feita por curso, na seção Certificate Template do editor. Você pode desenhar vários modelos no Certificate Builder e escolher um específico para cada curso, ou usar a opção None para não emitir certificado.

Atenção

Como corrigir o progresso do aluno que não atualiza no Tutor LMS

O progresso do aluno no Tutor LMS não atualiza quando a página de curso fica em cache e a barra continua mostrando a porcentagem antiga mesmo depois de o aluno concluir a aula. Cache de página, requisição AJAX bloqueada e modo de conclusão sequencial são as causas mais comuns.

Atenção

Como corrigir HTTP error ao enviar imagem

O HTTP error ao enviar imagem é a mensagem genérica que o WordPress mostra quando o envio falha já dentro da Biblioteca de Mídia, depois de o arquivo chegar ao servidor. Na maioria dos casos é falta de memória PHP ou um problema no processador de imagem (ImageMagick) que trava na hora de gerar as miniaturas.

Atenção

Como corrigir o recurso Multi-instructor que não funciona no Tutor LMS

O Multi-instructor do Tutor LMS deixa de funcionar quando o addon Multi Instructors está desligado, o Marketplace não foi ativado ou o instrutor que você tenta adicionar ainda está com status Pending, fazendo a seção Instructors sumir do Course Builder.

Grave

Como corrigir instrutores sem permissão para criar cursos no Tutor LMS

A falta de permissão de instrutor no Tutor LMS faz o usuário abrir o painel sem o botão Create a New Course ou receber acesso negado ao salvar. A causa quase sempre é o Marketplace desligado, a conta de instrutor ainda Pending ou a role tutor_instructor não aplicada ao usuário.

Atenção

Como corrigir o CSS personalizado que não aplica no WPForms

O CSS do WPForms que não aplica acontece quando o estilo personalizado e ignorado e o formulário mantem a aparencia padrão. A causa quase sempre e a especificidade do seletor padrão do plugin (div.wpforms-container-full) vencendo o seu, ou o cache servindo a folha antiga.

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 o certificado personalizado no Tutor LMS

O que é certificado personalizado no Tutor LMS?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o progresso do aluno que não atualiza no Tutor LMS

Como corrigir HTTP error ao enviar imagem

Como corrigir o recurso Multi-instructor que não funciona no Tutor LMS

Como corrigir instrutores sem permissão para criar cursos no Tutor LMS

Como corrigir o CSS personalizado que não aplica no WPForms

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