Como corrigir o Social Login que não funciona no Tutor LMS
O que é Social Login no Tutor LMS?
O Social Login do Tutor LMS é um addon exclusivo do Tutor LMS Pro que adiciona botões de entrada com Google, Facebook e X (Twitter) à tela de login do aluno. Em vez de digitar usuário e senha, o aluno autentica pela conta da rede social e o Tutor LMS cria ou vincula o usuário no WordPress. A autenticação acontece via OAuth: o provedor verifica a identidade e devolve o usuário ao site por uma URL de redirecionamento previamente cadastrada.
O recurso deixa de funcionar quando algum elo dessa cadeia quebra. Os botões somem da tela de login quando o addon está desabilitado ou o Tutor LMS Pro está inativo. Quando os botões aparecem mas o login falha, o problema costuma estar nas credenciais (Client ID, App ID ou API Key digitados errados) ou na URL de redirecionamento que o provedor exige e que precisa bater exatamente com o domínio do site, incluindo o esquema https e a barra final.
Como identificar
- Os botões de Entrar com Google ou Entrar com Facebook não aparecem na tela de login do Tutor LMS, mesmo após salvar as configurações.
- Ao clicar no botão social, o provedor retorna a mensagem ‘redirect_uri_mismatch’ ou ‘The redirect URI in the request does not match’.
- O Facebook exibe ‘URL Blocked: This redirect failed because the redirect URI is not whitelisted in the app’s Client OAuth Settings’.
- O login social inicia, abre a janela do provedor, mas o usuário volta ao site deslogado, sem criar conta nem iniciar sessão.
- A aba de configuração do Social Login não aparece em Tutor LMS Pro porque o addon não foi habilitado em Add-ons.
Como prevenir
- Mantenha o Tutor LMS Pro com a licença ativa e renovada, já que o Social Login deixa de existir se a versão Pro for desativada.
- Cadastre a URL de redirecionamento no provedor já no formato final do site (https com ou sem www, definido pelo seu domínio canônico) para evitar o erro redirect_uri_mismatch após migrações.
- Documente em local seguro quais credenciais pertencem a qual provedor para não trocar Client ID por App ID nos campos.
- Após publicar o site, lembre de mudar o app do Facebook para Live e publicar a tela de consentimento do Google, saindo do modo de teste antes de liberar o login para os alunos.
Causa
- O addon Social Login não foi habilitado em Tutor LMS Pro > Add-ons; sem isso a aba de autenticação social e os botões de login não são gerados.
- O Tutor LMS Pro está inativo ou com licença não renovada, e o Social Login é um recurso exclusivo da versão Pro, então o addon nem fica disponível na versão gratuita.
- O Client ID do Google ou o App ID do Facebook foi colado com espaços extras, incompleto ou trocado entre provedores no campo da aba Authentication, fazendo o OAuth retornar credencial inválida.
- A URL de redirecionamento cadastrada no console do provedor (Google Cloud Console ou Facebook for Developers) não casa exatamente com a do site, divergindo no https, no www ou na barra final, gerando o erro redirect_uri_mismatch.
- No Facebook for Developers o app está em modo de Desenvolvimento ou sem a Login do Facebook configurada, então só contas de teste conseguem autenticar e usuários reais voltam deslogados.
- A tela de login padrão do Tutor LMS foi substituída por um formulário de outro plugin (membership ou page builder), e esse formulário não renderiza os botões sociais do addon.
Como resolver
- Confirme o Tutor LMS Pro ativo e habilite o addon: O Social Login é um recurso exclusivo do Tutor LMS Pro. Confirme que o plugin Pro está ativo com a licença válida e habilite o addon na tela de Add-ons. Sem habilitar o addon, a aba de autenticação social e os botões de login não existem.
Painel WP -> Plugins -> confirme que o Tutor LMS Pro está Ativo Painel WP -> Tutor LMS Pro -> Add-ons Localize o card 'Social Login' e ligue o botão de ativação - Ative o provedor e cole as credenciais corretas: Abra a aba de autenticação e habilite só os provedores que vai usar, colando a credencial certa de cada um. O Google exige o Client ID, o Facebook exige o App ID e o X (Twitter) exige API Key e API Secret Key. Cole cada valor no campo do provedor correspondente, sem espaços no início ou no fim.
Painel WP -> Tutor LMS Pro -> Settings -> aba Authentication Na seção Social Login, ative o provedor desejado (Google, Facebook ou X) Cole o Client ID (Google) ou App ID (Facebook) no campo do provedor e clique em Save Changes - Cadastre a URL de redirecionamento exata no provedor: No console do provedor, cadastre como URI de redirecionamento autorizada exatamente a URL do seu site. Qualquer divergência no https, no www ou na barra final dispara o erro redirect_uri_mismatch. Copie a URL de retorno mostrada pelo Tutor LMS e cole sem alterar.
Google Cloud Console -> APIs e Serviços -> Credenciais -> OAuth 2.0 Client ID -> Authorized redirect URIs Facebook for Developers -> seu app -> Login do Facebook -> Settings -> Valid OAuth Redirect URIs Cole a URL de retorno exata do site (com https e barra final) e salve - Coloque o app do provedor em produção: Tire o app do modo de desenvolvimento para que usuários reais consigam autenticar. No Facebook, mude o app de Development para Live; no Google, publique a tela de consentimento OAuth para sair do modo de teste, que só permite contas adicionadas manualmente.
Facebook for Developers -> seu app -> alterne o modo de Development para Live no topo Google Cloud Console -> APIs e Serviços -> Tela de consentimento OAuth -> Publicar app - Garanta que a tela de login renderiza os botões: Se outro plugin de membership ou page builder substituiu o formulário de login do Tutor LMS, os botões sociais podem não ser exibidos. Use a página de login padrão do Tutor LMS e teste em uma aba anônima do navegador para validar sem cache nem sessão antiga.
Painel WP -> Tutor LMS Pro -> Settings -> confirme a página de login do Tutor LMS Abra a tela de login em uma janela anônima e teste o botão social Desative temporariamente plugins que substituem o login para isolar o conflito
<?php
// Reseta a tela de login do WordPress para a página de login do Tutor LMS,
// garantindo que os botões de Social Login do addon sejam renderizados.
add_filter( 'login_url', 'full_tutor_login_redirect', 10, 3 );
function full_tutor_login_redirect( $login_url, $redirect, $force_reauth ) {
if ( ! function_exists( 'tutor_utils' ) ) {
return $login_url;
}
$tutor_login = tutor_utils()->get_option( 'login_url' );
if ( empty( $tutor_login ) ) {
return $login_url;
}
$url = $tutor_login;
if ( ! empty( $redirect ) ) {
$url = add_query_arg( 'redirect_to', rawurlencode( $redirect ), $url );
}
return $url;
}














