Integre um site Joomla! com o SuperSaaS
Esta página explica como integrar uma agenda do SuperSaaS a um site baseado em Joomla, 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 os nomes de login do Joomla! no SuperSaaS
- Instalar e configurar o plug-in no Joomla!
- Alterar configurações no SuperSaaS para conectar com o Joomla!
- Adicionar botão de reserva às suas páginas
- Dicas de solução de problemas
Usar os nomes de login do Joomla! para a sua agenda do SuperSaaS
O plug-in do Joomla! do SuperSaaS exibe um botão que conecta automaticamente o usuário a uma agenda do SuperSaaS usando o nome de usuário do Joomla.
O botão gerado pelo plug-in envia as informações do banco de dados de usuários do Joomla para o SuperSaaS, 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 plug-in no Joomla
Siga estas etapas para configurar o módulo no Joomla!:
-
Instale o plug-in. Na página de administração do Joomla, vá para Extensões>Gerenciador de extensões. Você pode instalar o plug-in sem baixar nada separadamente:
- Para Joomla 3.2+, escolha a opção Instalar da Web e procure por “SuperSaaS”
- Para Joomla 3.1, escolha a aba Instalar a partir da URL e informe a URL: https://static.supersaas.net/plugins/plg_supersaas_joomla_12.zip
-
Configure o plug-in. Na tela Extensões>Gerenciador de Plug-ins, procure por SuperSaaS e habilite o plug-in mudando o status para “Habilitado”.
Agora siga para a configuração clicando nele. Certifique-se de que “Público” esteja selecionado nas configurações de “Acesso”, à direita.
Em seguida preencha a seção Configurações do plug-in do SuperSaaS:
- 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ê encontra a chave de API da sua conta do SuperSaaS no fim da página Informações da Conta.
- Nome de domínio personalizado – Se você criou um nome de domínio personalizado apontando para a sua agenda, então precisa informá-lo aqui para direcionar seus usuários corretamente
- Nome da agenda ou URL – 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
Instalar extensão Joomla!
Para Joomla! 3.2+ é fácil instalar o plug-in do SuperSaaS usando a opção “Instalar da Web”.- Na aba “Instalar da Web”, procure por “SuperSaaS Booking Plugin”.
- Abra “SuperSaaS Booking Plugin” e clique no botão verde “Instalar”.
- Em seguida, siga as instruções de configuração do passo 2 acima.
Alterar configurações da conta do SuperSaaS para funcionar com Joomla
O banco de dados de usuários do Joomla é a fonte principal, então qualquer alteração nas informações dos usuários no seu site Joomla 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 confundi-los. Por exemplo, se um usuário puder mudar a senha no SuperSaaS, provavelmente não perceberá que a senha do Joomla continua 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
Em seguida, você precisa garantir que os campos do banco de dados no Joomla 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 )
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
Coloque o shortcode [supersaas] em suas páginas em todos os lugares onde quiser que o botão apareça.
O shortcode pode receber os parâmetros opcionais after, label e image para sobrescrever os valores definidos na tela de configurações.
Isso é útil se você quiser adicionar vários botões para agendas diferentes, por exemplo:
[supersaas after="schedule1" label="Agendar na Agenda 1"][supersaas after="schedule2" label="Agendar na Agenda 2" image="https://example.com/book_now.gif"]
Testar
Agora você já pode testar o botão no seu site. Como administrador, você ainda precisará fazer login pela página principal de login 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 menos uma vez usando o botão antes de alterar a função deles na página Gestão de usuários.
Dicas de solução de problemas
- Observe que o botão só aparece para usuários que estão logados no seu site Joomla
- Se você vir o erro “O e-mail não é um endereço de e-mail válido”, releia a seção “Alterar configurações da conta do SuperSaaS para funcionar com Joomla” para confirmar se as configurações corretas foram feitas
- Se você vir o erro “O nome de login é uma palavra reservada”, então o seu nome de usuário é uma palavra reservada no SuperSaaS. Tente entrar com outro nome de usuário.
- 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.