Login único para sites em Drupal
Esta página explica como integrar uma agenda do SuperSaaS a um site baseado em Drupal para que seus usuários precisem fazer login apenas uma vez para acessar tanto o seu site quanto a agenda do SuperSaaS dentro dele. Para poder usar isso, primeiro você precisa criar uma conta gratuita do SuperSaaS.
- Usar o login do Drupal nas agendas do SuperSaaS
- Instalar e configurar o módulo no Drupal
- Alterar configurações no SuperSaaS
- Adicionar botão de agendamento às suas páginas
- Dicas de solução de problemas
Usar nomes de login do Drupal para a sua agenda do SuperSaaS
O módulo Drupal do SuperSaaS exibe um botão “Agende agora” que conecta automaticamente o usuário a uma agenda do SuperSaaS usando o nome de usuário do Drupal. Se você não estiver usando o sistema de cadastro de usuários do Drupal, então deve seguir as instruções gerais sobre como integrar uma agenda ao seu site.
O botão gerado pelo módulo repassa ao SuperSaaS as informações do banco de dados de usuários do Drupal, criando o usuário no banco de dados do SuperSaaS ou atualizando seus dados conforme necessário. Isso poupa os usuários de criar um login separado para o sistema de reservas e evita a necessidade de fazer login duas vezes.
Instalação e configuração do módulo no Drupal
Siga as etapas abaixo para configurar o módulo no Drupal:
-
Instale o módulo (Drupal 10.2 & 11).
Na página do projeto do módulo Drupal do SuperSaaS, siga as instruções de instalação em ‘Releases’.
Em seguida, na página Extender, marque a caixa ao lado do nome do módulo para habilitá-lo e clique em .Agora vá em Gerenciar>Configuração e clique em Configurações do SuperSaaS.
Preencha ou limpe os campos e marque ou desmarque ‘Ativar HTTPS’ conforme as suas configurações.No menu de administração do Drupal, clique em Gerenciar>Estrutura e depois em Layout de blocos. Depois do elemento do bloco onde deseja colocar o módulo SuperSaaS, clique em Posicionar bloco. Encontre o bloco ‘SuperSaaS login’ e clique no botão Posicionar bloco ao lado dele. Em ‘Configurar bloco’ você pode editar o título, desativar o título exibido e ajustar várias configurações.
Para compatibilidade com versões mais antigas do Drupal, baixe uma release na página GitHub releases. -
Configure o módulo. Vá até a tela Configurações do SuperSaaS e preencha os campos:
- Nome da conta SuperSaaS – Este é o nome da sua conta (não o seu endereço de e-mail)
- Chave de API do SuperSaaS – Você pode encontrar a chave de API da sua conta do SuperSaaS no fim da página Informações da Conta.
- Nome da agenda – Você pode informar o nome de uma agenda ou fornecer uma URL completa se quiser adicionar parâmetros específicos para direcionar o usuário a uma visualização específica. Se estiver usando mais de uma agenda, veja abaixo.
- Rótulo do botão – O rótulo do botão. O padrão será “Agende agora” ou o equivalente nos idiomas suportados. Se o botão tiver uma imagem de fundo, esse será o valor do texto alternativo.
- Imagem do botão – A URL da imagem de fundo. Esse campo não tem valor padrão. Portanto, o botão não terá imagem de fundo se isso não for configurado. Exemplo:
- Nome de domínio personalizado – Se você criou um nome de domínio personalizado apontando para a sua agenda, pode informá-lo aqui para direcionar seus usuários corretamente.
- Ativar HTTPS – Marque esta opção se você ativou “Criptografar conexão com SSL/TLS” para sua(s) agenda(s) do SuperSaaS.
(Veja 
Alterar configurações da conta do SuperSaaS para funcionar com Drupal
O banco de dados de usuários do Drupal é a fonte principal, então qualquer alteração nas informações dos usuários no seu site Drupal será refletida no SuperSaaS, mas não o contrário. Por isso, recomendamos que você não permita que seus usuários alterem suas informações no SuperSaaS, pois isso pode facilmente gerar confusão. Por exemplo, se um usuário puder alterar a senha no SuperSaaS, provavelmente não perceberá que a senha do Drupal continuará a mesma.
Faça as seguintes alterações na sua conta do SuperSaaS para evitar inconsistências:
- Na página Controle de acesso, selecione
- Na página Controle de acesso, selecione
- Na página Configurações de layout, preencha o campo Seu URL com a URL da página do seu site em que os usuários podem fazer login
Além disso, você precisa garantir que os campos do banco de dados no Drupal correspondam aos do banco de dados de usuários do SuperSaaS. Faça as seguintes alterações na página Controle de acesso:
- Desmarque
- Altere o botão de opção de Endereço de e-mail para Opcional (ou Obrigatório)
- Altere todos os outros campos para Não perguntar (você também pode desativar o campo Senha se tiver selecionado )
Agora você já pode testar o botão no seu site. Como administrador, você ainda precisará fazer login pela página principal do SuperSaaS, então vale a pena testar fingindo ser um usuário comum. Se quiser definir superusuários no SuperSaaS, certifique-se de que eles tenham feito login pelo botão pelo menos uma vez antes de alterar a função deles na página Gestão de usuários.
Configurar o SuperSaaS
Esta imagem mostra a página Controle de acesso da sua conta do SuperSaaS depois das configurações descritas acima.Adicionar o botão às suas páginas
No menu principal, vá para Estrutura (Drupal 10.2 ou 11) e selecione a opção Layout de blocos. Depois, clique em Posicionar bloco em um local apropriado da página. Você pode clicar em configurar para personalizar ainda mais o título e as páginas em que o botão deve aparecer.
Dicas de solução de problemas
- Observe que o botão só aparece para usuários que estão logados no seu site Drupal
- Se você vir o erro “O e-mail não é um endereço de e-mail válido”, releia o parágrafo anterior para confirmar que aplicou as configurações corretas na sua conta do SuperSaaS
- Se o botão redirecionar o usuário, mas não parecer conectá-lo de fato, e você tiver usado uma URL no campo Nome da agenda ou URL, confirme que o domínio dessa URL foi informado no campo Nome de domínio personalizado