# Como corrigir o certificado personalizado no Tutor LMS

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.

Erros relacionados

- [Como corrigir certificados que não chegam por e-mail no Tutor LMS](https://full.services/wp-fixer/corrigir-certificado-email-tutor-lms/)
- [Como corrigir certificados que não geram PDF no Tutor LMS](https://full.services/wp-fixer/corrigir-certificado-pdf-tutor-lms/)
- [Como corrigir o Course Builder que não carrega no Tutor LMS](https://full.services/wp-fixer/corrigir-course-builder-nao-carrega-tutor-lms/)

## 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

1. 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
```

2. 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
```

3. 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
```

4. 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
```

5. 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)
```


## Código

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

**Fonte:** [Tutor LMS Documentation — Certificate addon e Certificate Builder (Themeum)](https://docs.themeum.com/tutor-lms/)