Documentação

Integre seu site Joomla! com SuperSaaS

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

Se você não pedir a seus usuários para fazer login no seu próprio site, você deve seguir as instruções gerais sobre como integrar um calendário em seu site. O módulo fornecido aqui só funcionará quando o usuário já está conectado em seu próprio site Joomla.

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 gerada pelo plug-in passa as informações do banco de dados do usuário Joomla para SuperSaaS, criando o usuário no banco de dados SuperSaaS ou atualiza suas informações, conforme necessário. Isso poupa os usuários de ter que criar um login separado para o sistema de reservas e evita a necessidade de logar-se 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 baixá-lo 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> tela de Gerenciador de Plug-in pesquise por SuperSaaS e habilite alterando o status para “habilitado”. Agora prossiga para configurar o plug-in, clicando sobre ela. Certifique-se de que “Público” está selecionado nas configurações de “acesso” à direita. Depois preencha a sessão de 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)
Joomla! SuperSaaS Reserva Plug-in

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

Seu banco de dados do usuário Joomla está liderando, o que significa que as mudanças em informações do usuário em seu site Joomla vão propagar para 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 em SuperSaaS ele provavelmente não vai perceber que sua senha Joomla ainda é a mesmo. 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 logar

Em segundo lugar, você precisa se certificar de que os campos de banco de dados em WordPress correspondem àquelas em seu banco de dados de usuário 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 radio do endereço de Email que aparece Opcional (ou Obrigatório)
  • Alterne o botão de radio nome completo paraOpcional
  • Alterne todos os outros campos para Não perguntar (você pode desligar o campo Senha também se você selecionou Login é tratado aqui)
Controle de Acesso SuperSaaS

Configurar SuperSaaS

Esta imagem descreve a página “Controle de Acesso” em suas contas SuperSaaS depois de fazer 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:

[supersaas after="Agenda1" label="Agendar Na Agenda 1"]
[supersaas after="agenda2" label="Agendar Na Agenda 1" image="https://example.com/book_now.gif"]
Coloque vários botões de agendamento em artigos Joomla!
Exibir um artigo com vários botões

Testando

Agora você pode testar o botão em seu site. Como administrador, você ainda precisa fazer login através da página de login principal SuperSaaS,e você pode querer testar isso fingindo ser um usuário regular. Se você quiser definir super usuários no SuperSaaS, certifique-se de terem logado pelo menos uma vez utilizando o botão antes de mudar seu nível na página de Gerenciamento de usuário.

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 você fez as configurações corretas em sua conta SuperSaaS
  • Se você ver um erro Nome de Login é uma palavra reservada, então o nome do seu usuário é uma palavra reservada no SuperSaaS. Tente logar com um nome de usuário diferente.
  • Se o botão redirecionar o usuário, mas não logar o usuário você usou uma URL no campo Nome da Agenda ou URL, em seguida, certifique-se de que o domínio da URL que está inserido no campo de Nome de Domínio Personalizado