Documentação
Imprimir Página

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 plugin 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 plugin de agendamento SuperSaaS é compatível com Joomla 3.1 ou mais recente. Se você estiver usando uma versão mais antiga,então, por favor use o tutorial anterior para o Módulo Joomla! o qual funciona em versões mais antigas do Joomla.

O botão gerada pelo plugin 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 plugin no Joomla

  1. Instalar o plugin. Na página de administrador do Joomla vá em Extensões>Gerenciador de extensões. Você pode instalar o plugin, 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: http://cdn.supersaas.net/plugins/plg_supersaas_joomla_12.zip
    • Para versões mais antigas do Joomla use o Módulo Joomla!
    Se você deseja modificar o módulo você também pode fazer o download do nosso repositório GitHub.
  2. Configurar o plugin. Em Extensões> tela de Gerenciador de Plugin pesquise por SuperSaaS e habilite alterando o status para "habilitado". Agora prossiga para configurar o plugin, 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 Plugin 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 adiciona-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 Booking Plugin

Instalar extensão Joomla!

Para Joomla! 3.2+ é fácil de implementar o plugin SuperSaaS usando a opção "Instalar a partir da Web".
  • Em "Instalar a partir da Web" pesquise por "Plugin de Agendamento SuperSaaS".
  • Abra o "Plugin 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 radio button do endereço de Email que aparece Opcional (ou Obrigatório)
  • Alterne o radio button 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=“http://example.com/book_now.gif”]
Colocar multiplos botões de agendamentos 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