WPForms Tutor LMS: inscricao não funciona, como corrigir

Tipo Outros erros

Nome do erro Formulario de inscricao do WPForms nao matricula aluno no Tutor LMS EN: WPForms registration form does not enroll student in Tutor LMS

Severidade Grave

Descrição O formulário de inscricao do WPForms não funciona no Tutor LMS quando o WPForms cria a conta WordPress por fora do fluxo de cadastro do Tutor LMS: o usuário nasce sem o papel de estudante e sem passar pelo hook de signup, entao não aparece como aluno nem consegue se matricular nos cursos.

O que é WPForms inscricao Tutor LMS não funciona?

A integração entre WPForms e Tutor LMS junta dois sistemas que cadastram usuários de formas diferentes. O WPForms, com o addon User Registration, cria contas WordPress reais a partir do envio do formulário, mapeando campos como nome de usuário, e-mail e senha para o perfil e atribuindo um papel definido em Default User Role. Já o Tutor LMS, segundo a própria documentação, transforma alguem em estudante automaticamente quando essa pessoa se cadastra pelo signup padrão do tema ou pela página de registro do Tutor LMS. São dois caminhos de cadastro que precisam se encontrar.

O problema aparece porque o usuário criado pelo WPForms entra por um terceiro caminho, que não e o signup nativo do Tutor LMS. Resultado: a conta existe no WordPress, mas o gatilho que marca a pessoa como aluno do Tutor LMS nunca dispara. O perfil fica com um papel genérico, o painel do aluno não reconhece a conta e a matricula no curso falha. Em casos pagos, o WPForms registra o pagamento mas a matricula do Tutor LMS não acontece, deixando o aluno sem acesso ao conteúdo que comprou.

Como identificar

O formulário do WPForms exibe a confirmacao de envio, mas o aluno não aparece em Tutor LMS -> Estudantes no painel administrativo.
A conta foi criada em Usuários -> Todos os Usuários, porém com um papel como Assinante (Subscriber) em vez do papel de aluno reconhecido pelo Tutor LMS.
Ao fazer login, o aluno cai numa página generica e o painel frontend do Tutor LMS (Meus Cursos, Painel) não carrega para aquela conta.
A matricula no curso não se completa: o botão continua mostrando ‘Inscrever-se’ ou ‘Comprar’ mesmo após a inscricao pelo formulário.
O envio do WPForms aparece em WPForms -> Entradas, mas nenhuma matricula correspondente surge nos relatórios do Tutor LMS.
Em formulários pagos, o WPForms registra o pagamento via Stripe ou PayPal, mas o curso não e liberado para o aluno.

Antes de começar: Antes de adicionar o snippet em functions.php ou de mudar o papel padrão do formulário em producao, faca um backup completo (arquivos e banco) ou teste primeiro em um ambiente de staging. Atribuir papel e matricula via código afeta contas reais de usuários, entao valide com uma conta de teste antes de liberar o formulário.

Como prevenir

Sempre use o addon User Registration do WPForms para cadastro que precisa virar aluno: formulários de contato comuns não criam usuário WordPress e nunca matriculam no Tutor LMS.
Padronize um único caminho de cadastro de aluno no site, evitando manter ao mesmo tempo o registro nativo do Tutor LMS e um formulário do WPForms competindo pela mesma jornada.
Documente no código o ID do formulário e o ID do curso usados na matricula automática, para que uma troca de formulário não quebre a integração silenciosamente.
Após atualizar WPForms ou Tutor LMS, refaca o teste de ponta a ponta de criação de conta e matricula em staging, já que mudancas de hook ou de papel podem afetar a integração.

Causa

O addon User Registration do WPForms cria o usuário por fora do fluxo de signup do Tutor LMS, entao o gatilho que converte a conta em estudante (documentado como automático apenas no signup do tema ou na página de registro do Tutor LMS) nunca dispara para esse usuário.
O campo Default User Role do formulário User Registration esta definido como Assinante ou Editor, e não como o papel de aluno que o Tutor LMS espera, deixando a conta sem as capacidades do painel do estudante.
A opção User Activation do WPForms exige confirmacao por e-mail ou aprovacao manual do administrador, entao a conta fica inativa e o Tutor LMS não a trata como aluno ativo até a ativacao acontecer.
O formulário foi montado sem o addon User Registration (so um formulário de contato comum), entao nenhum usuário WordPress e criado e não ha conta para o Tutor LMS matricular.
A página de Registro de Estudante em Tutor LMS -> Configurações -> Avancado não esta apontada para a página que contem o formulário, ou foi substituida por uma página com o formulário do WPForms que ignora o cadastro nativo do Tutor LMS.
Em formulários pagos, o WPForms processa o pagamento mas não chama a função de matricula do Tutor LMS, porque não existe código ligando o envio do formulário a inscricao no curso específico.

Como resolver

Confirme que o addon User Registration esta ativo: O formulário so cria contas WordPress se usar o addon User Registration do WPForms, um recurso dos planos avancados (Pro/Elite). Um formulário de contato comum não gera usuário, entao não ha como o Tutor LMS matricular ninguem. Instale e ative o addon e monte o formulário a partir do modelo de registro de usuário.
```
Painel WP -> WPForms -> Addons -> localize 'User Registration Addon' e clique em Install Addon
WPForms -> Adicionar Novo -> selecione o modelo 'User Registration Form'
```
Ajuste o Default User Role para o papel de aluno: Na aba de registro do formulário, defina o Default User Role para o papel que o Tutor LMS usa para estudantes em vez de Assinante. Sem o papel correto, a conta não recebe as capacidades do painel do aluno e não e reconhecida como estudante.
```
WPForms -> edite o formulário -> Configurações -> User Registration
No campo 'Default User Role' selecione o papel de aluno do Tutor LMS (ex.: Tutor Instructor não; use o papel de estudante)
Salve o formulário
```
Desative a ativacao manual que trava a conta: Se o User Activation estiver exigindo confirmacao por e-mail ou aprovacao do administrador, a conta nasce inativa e o Tutor LMS não a trata como aluno até ser ativada. Para inscricao imediata em curso, deixe a conta ativa no envio (ou garanta que o aluno conclua a ativacao antes de tentar acessar o curso).
```
WPForms -> edite o formulário -> Configurações -> User Registration
Em 'User Activation', desmarque a exigencia de ativacao por e-mail/admin para liberar a conta no envio
Salve o formulário
```
Marque o usuário como estudante e matricule via hook: Como o usuário nasce por fora do signup do Tutor LMS, use o hook wpforms_user_registered para forcar o papel de aluno e chamar a matricula do Tutor LMS no curso desejado quando o formulário for enviado. Esse e o ponto que liga os dois sistemas (código no campo abaixo).
```
Adicione o snippet do campo 'código' ao functions.php do tema filho ou a um plugin de snippets
Troque o ID do formulário e o ID do curso pelos valores reais do seu site
```
Aponte a página de registro de estudante no Tutor LMS: Em Tutor LMS -> Configurações -> Avancado, confirme qual página esta definida como Registro de Estudante. Use a página que contem o formulário do WPForms (ou mantenha o bloco nativo Tutor Student Registration) para não misturar dois cadastros conflitantes na mesma jornada.
```
Painel WP -> Tutor LMS -> Configurações -> Avancado
No campo 'Página de Registro de Estudante', selecione a página correta do formulário
Salve as configurações
```
Teste o fluxo completo de ponta a ponta: Crie uma conta de teste pelo formulário e verifique se o usuário aparece como estudante no Tutor LMS e se a matricula no curso foi feita. Confirme também o login e o acesso ao painel frontend do aluno antes de liberar para o público.
```
Envie o formulário com um e-mail de teste em janela anonima
Painel WP -> Usuários -> confirme o papel da conta criada
Painel WP -> Tutor LMS -> Estudantes -> confirme a presenca e a matricula no curso
```

PHP

<?php
// Liga o cadastro do WPForms (User Registration) a matricula no Tutor LMS.
add_action( 'wpforms_user_registered', 'full_wpforms_tutor_enroll', 10, 4 );
function full_wpforms_tutor_enroll( $user_id, $fields, $form_data, $login ) {
    // Ajuste para o ID do seu formulario de inscricao.
    $form_inscricao_id = 123;
    // Ajuste para o ID do curso em que o aluno deve ser matriculado.
    $course_id = 456;

    if ( (int) $form_data['id'] !== $form_inscricao_id ) {
        return;
    }

    // 1) Garante o papel de aluno reconhecido pelo Tutor LMS.
    $user = new WP_User( $user_id );
    $user->set_role( 'subscriber' ); // base padrao do estudante no Tutor LMS
    update_user_meta( $user_id, '_is_tutor_student', 1 );

    // 2) Matricula o usuario no curso, se a funcao do Tutor LMS existir.
    if ( function_exists( 'tutor_utils' ) && method_exists( tutor_utils(), 'do_enroll' ) ) {
        tutor_utils()->do_enroll( $course_id, 0, $user_id );
    }
}

Perguntas frequentes

Por que o WPForms cria o usuário mas o aluno não aparece no Tutor LMS

Porque o WPForms cria a conta por fora do fluxo de signup do Tutor LMS. A documentação do Tutor LMS diz que a conversao em estudante e automática apenas no cadastro pelo tema ou pela página de registro do Tutor LMS, entao o gatilho não dispara para o usuário do WPForms. Marque o papel e a matricula via hook do formulário.

Preciso de um plano pago do WPForms para criar aluno no Tutor LMS

Sim para criar contas. O addon User Registration, que cria usuários WordPress a partir do formulário, e um recurso dos planos avancados do WPForms (Pro/Elite). Um formulário de contato gratuito não cria usuário e por isso não consegue matricular ninguem no Tutor LMS.

Qual papel de usuário o formulário deve atribuir para funcionar no Tutor LMS

O papel de estudante que o Tutor LMS reconhece, e não Assinante. No formulário User Registration, ajuste o campo Default User Role e, como reforco, force o papel de aluno via hook no envio para garantir que a conta tenha as capacidades do painel do estudante.

A conta fica inativa após o envio do formulário, isso atrapalha a matricula

Sim. Se o User Activation do WPForms exigir confirmacao por e-mail ou aprovacao do administrador, a conta nasce inativa e o Tutor LMS não a trata como aluno ativo. Desative essa exigencia para inscricao imediata ou garanta que o aluno conclua a ativacao antes de acessar o curso.

Como matricular o aluno automaticamente num curso específico ao enviar o formulário

Use o hook wpforms_user_registered para chamar a função de matricula do Tutor LMS com o ID do usuário recem criado e o ID do curso. Assim a conta e criada pelo WPForms e a inscricao no curso acontece no mesmo envio, ligando os dois sistemas.

O pagamento pelo WPForms foi processado mas o curso não liberou, o que houve

O WPForms processou o pagamento mas não chamou a matricula do Tutor LMS, pois não existe código ligando o envio ao curso. Dispare a matricula do Tutor LMS após a confirmacao do pagamento no formulário, usando o ID do curso correto, para liberar o acesso ao aluno.

Devo manter o registro nativo do Tutor LMS junto com o formulário do WPForms

Não e recomendado manter os dois competindo. Escolha um único caminho de cadastro: ou o bloco Tutor Student Registration nativo, ou o formulário do WPForms apontado como página de registro em Tutor LMS -> Configurações -> Avancado. Dois fluxos na mesma jornada geram contas inconsistentes.

Onde verifico se a integração entre WPForms e Tutor LMS funcionou

Crie uma conta de teste pelo formulário e confira três pontos: o papel em Usuários, a presenca do aluno em Tutor LMS -> Estudantes e a matricula no curso. Se os três estiverem corretos e o login abrir o painel do aluno, a integração esta funcionando.

Atenção

Como corrigir avaliações de curso que não funcionam no Tutor LMS

A avaliação de curso no Tutor LMS deixa de funcionar quando a opção de aprovação manual segura os reviews como pendentes, quando o addon de relatórios está desativado ou quando o aluno não concluiu o curso e por isso não recebe o convite para avaliar.

Grave

Como corrigir o cálculo de comissões do Revenue Sharing no Tutor LMS

A comissão errada no Revenue Sharing do Tutor LMS acontece quando o Sharing Percentage está mal configurado, a opção Deduct Fees desconta a taxa antes da divisão ou o ganho foi gravado com um percentual antigo, fazendo o valor pago ao instrutor divergir do esperado.

Grave

Como corrigir o formulário multi-página que não avanca no WPForms

Quando o WPForms multi-page não avanca, o visitante clica em Next e o formulário fica parado na mesma página. As duas causas reais são um campo obrigatório não preenchido na página atual ou o JavaScript do WPForms quebrado por cache ou minificacao.

Atenção

Como corrigir relatórios que não exibem progresso no Tutor LMS

O relatório do Tutor LMS não mostra progresso quando o addon Reports (exclusivo do Tutor LMS Pro) está desativado, quando o aluno enviado é anterior à instalação do plugin ou quando o modo de conclusão Strict deixa cursos sem 100% por lições e quizzes pendentes.

Atenção

Como corrigir o redirecionamento que não funciona no WPForms

O redirecionamento do WPForms não funciona quando a confirmacao do formulário esta no tipo Mensagem em vez de Go to URL ou Show Page, quando a URL de destino esta invalida, ou quando cache e conflitos de JavaScript impedem o envio AJAX de concluir o redirect após o envio.

Atenção

Como corrigir upload de arquivos em tarefas no Tutor LMS

O Tutor LMS assignment não aceita upload quando o addon Assignments tem o File Upload Limit em zero, quando o tamanho do arquivo passa do Maximum File Size Limit configurado, ou quando limites de PHP do servidor barram o envio antes de o Tutor LMS processar a tarefa.

Setores

Extensões

Integrações

Como corrigir formulários de inscricao do WPForms que não funcionam no Tutor LMS no WordPress

O que é WPForms inscricao Tutor LMS não funciona?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir avaliações de curso que não funcionam no Tutor LMS

Como corrigir o cálculo de comissões do Revenue Sharing no Tutor LMS

Como corrigir o formulário multi-página que não avanca no WPForms

Como corrigir relatórios que não exibem progresso no Tutor LMS

Como corrigir o redirecionamento que não funciona no WPForms

Como corrigir upload de arquivos em tarefas no Tutor LMS

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