Integre seu site Joomla! com SuperSaaS

Esta página explica como integrar uma agenda SuperSaaS a um site baseado em Joomla, para que os usuários precisem fazer login apenas uma vez para acessar tanto o seu site quanto a agenda SuperSaaS dentro dele. Para usá-lo, você primeiro precisa se inscrever em uma conta SuperSaaS gratuita.

Usando nomes de login do Joomla para o seu calendário SuperSaaS

O plug-in SuperSaaS Joomla exibe um botão “Reserve agora” que registra automaticamente o usuário em uma agenda SuperSaaS usando seu nome de usuário Joomla. Se você não estiver usando o sistema de registro de usuário Joomla, então você deve seguir as instruções gerais sobre como integrar um calendário no seu site.

O botão gerado pelo plug-in passa as informações do banco de dados do usuário Joomla para o SuperSaaS, criando o usuário no banco de dados do SuperSaaS ou atualizando suas informações, conforme necessário. Isso poupa os usuários de criar um login separado para o sistema de reservas e evita a necessidade de entrar duas vezes.

Instalação e configuração do plug-in no Joomla

1. Instalar o plug-in. Na página de administrador do Joomla, vá em Extensões>Gerenciador de extensões. Você pode instalar o plug-in sem precisar fazer o download separadamente:
   • Para Joomla 3.2+, escolha a opção Instalar da Web e pesquise por “SuperSaaS”
   • Para Joomla 3.1, escolha a opção Instalar da URL e informe a URL: https://static.supersaas.net/plugins/plg_supersaas_joomla_12.zip
   Se você deseja modificar o módulo você também pode fazer o download do nosso repositório GitHub.
2. Configurar o plug-in. Em Extensões>Gerenciador de Plug-ins, pesquise por SuperSaaS e habilite-o alterando o status para “habilitado”. Agora prossiga para configurar o plug-in, clicando sobre ele. Certifique-se de que “Público” está selecionado nas configurações de acesso à direita. Depois, preencha a seção Configurações do Plug-in SuperSaaS:
   • Nome da conta SuperSaaS* – Este é o nome da sua conta (não seu endereço de email)
   • Senha SuperSaaS* – Esta é a senha que o usuário administrador usa para acessar SuperSaaS.
   • Nome de Domínio Customizado – Se você criou um Nome de Domínio Customizado para apontar para a sua agenda, você pode adicioná-la corretamente aqui para apontar para seus usuários.
   • Nome da Agenda ou URL – Você pode colocar o nome de uma agenda ou você pode fornecer uma URL completa, se você quiser adicionar parâmetros específicos para direcionar o usuário para uma visão específica
   (* – campo obrigatório)

Instalar extensão Joomla!

Para Joomla! 3.2+ é fácil de implementar o plug-in SuperSaaS usando a opção “Instalar a partir da Web”.

• Em “Instalar a partir da Web” pesquise por “plug-in de Agendamento SuperSaaS”.
• Abra o “Plug-in de Agendamento SuperSaaS” e clique no botão verde “Instalar”.
• Depois, siga as instruções de configuração no ponto 2 acima.

Alterar configurações da conta SuperSaaS para trabalhar com Joomla

O banco de dados de usuários do Joomla é a fonte principal, o que significa que as mudanças nas informações do usuário em seu site Joomla vão se propagar para o SuperSaaS, mas não o contrário. Portanto, recomendamos que você não deixe que seus usuários alterem suas informações de usuário em SuperSaaS porque isso poderia facilmente confundi-los. Por exemplo, se um usuário for autorizado a mudar sua senha no SuperSaaS, ele provavelmente não perceberá que sua senha do Joomla ainda é a mesma. Faça as seguintes alterações em suas contas SuperSaaS para evitar essas inconsistências:

• Na página de Controle de acesso, selecione Gestão de Log in e registro no seu site
• Na página de Controle de acesso, selecione Impedir que os usuários atualizem suas próprias informações
• Na página de Configurações de layout, preencha o campo de sua URL com a URL da página do seu site onde os usuários podem entrar

Em segundo lugar, você precisa se certificar de que os campos do banco de dados no Joomla correspondam aos do seu banco de dados de usuários do SuperSaaS. Faça as seguintes alterações na página de Controle de acesso:

• Desmarque Use e-mail como nome de login
• Alterne o botão de rádio do endereço de e-mail para Opcional (ou Obrigatório)
• Alterne o botão de rádio do nome completo para Opcional
• Alterne todos os outros campos para Não perguntar (você pode desligar o campo Senha também se você selecionou Login é tratado aqui)

Configurar SuperSaaS

Esta imagem descreve a página “Controle de acesso” em suas contas SuperSaaS após aplicar as definições descritas acima.

Adicione o botão para suas páginas

Coloque o pequeno trecho de código [supersaas] em suas páginas em todos os lugares que você deseja que o botão apareça. O código pode ter os parâmetros opcionais after(depois), label(etiqueta) e image(imagem) para sobrescrever os valores na tela de configurações. Isso é útil se você quiser adicionar vários botões para horários diferentes, por exemplo:

Testando

Agora você pode testar o botão em seu site. Como administrador, você ainda precisa fazer login por meio da página de login principal SuperSaaS, e você pode querer testar isso fingindo ser um usuário regular. Se você quiser definir superusuários no SuperSaaS, certifique-se de que eles tenham entrado pelo menos uma vez utilizando o botão antes de mudar seu nível na página de Gestão de usuários.

Dicas de solução de problemas

• Note que o botão para usuários que estão logados no seu site Joomla
• Se você ver um erro O Email não é um email valido, então, por favor leia o parágrafo anterior novamente para confirmar que as configurações corretas foram aplicadas em sua conta SuperSaaS
• Se você vir um erro Nome de Login é uma palavra reservada, então o nome do seu usuário é uma palavra reservada no SuperSaaS. Tente entrar com um nome de usuário diferente.
• Se o botão redirecionar o usuário, mas não o conectar, você usou uma URL no campo Nome da Agenda ou URL; nesse caso, certifique-se de que o domínio da URL esteja inserido no campo Nome de Domínio Personalizado