Integre o SuperSaaS a um site WordPress

Fornecemos um plug-in do WordPress gratuito que pode conectar automaticamente seus usuários ao SuperSaaS usando o nome de usuário do WordPress. Assim, os usuários só precisam fazer login uma vez para acessar tanto o seu site quanto a agenda do SuperSaaS dentro dele.

Mostrar sua agenda dentro do site WordPress
Instalar e configurar o plug-in
Alterar configurações da conta no SuperSaaS
Adicionar botão de agendamento ao seu site
Dicas de solução de problemas

Se você não exige que seus usuários façam login no seu site WordPress, pode seguir as instruções normais sobre como integrar uma agenda ao seu site. O plug-in fornecido aqui ainda funcionará, mas seus usuários não serão conectados automaticamente nesse caso.

Mostrar a agenda dentro do site, ou redirecionar usuários para o SuperSaaS

Dependendo da sua preferência, o plug-in do WordPress do SuperSaaS exibe um botão Agende agora que redireciona o usuário para sua agenda no site do SuperSaaS, ou exibe um “widget” de reserva incorporado ao site por JavaScript, para que os usuários permaneçam no seu site. Se você escolher a opção do widget, poderá especificar ainda se a agenda deve aparecer em um quadro no seu site, ou escondida atrás de um botão que mostra a agenda quando clicado.

O plug-in também pode, opcionalmente, repassar as informações do usuário do WordPress ao 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 que precisem fazer login duas vezes. Se você não estiver usando o sistema de cadastro de usuários do WordPress, então o plug-in não acrescenta tanto valor. Nesse caso, basta seguir as instruções gerais sobre como integrar uma agenda ao seu site.

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

Etapas para configurar o plug-in do WordPress

Instale o plug-in. Vá para Painel>Plug-ins e escolha “Adicionar novo”, depois pesquise por SuperSaaS. Clique em “Instalar agora” e ative o plug-in.
Configure o plug-in. Selecione Configurações>SuperSaaS no menu para abrir a tela de Configurações do SuperSaaS:
- Nome da conta SuperSaaS – Este é o nome da sua conta (não o seu endereço de e-mail).
- Como você quer mostrar sua agenda do SuperSaaS? – Escolha entre um botão que redireciona o usuário para o calendário do SuperSaaS ou uma integração direta ao seu site, seja como botão ou em um quadro
- Conectar automaticamente usuários do WordPress ao SuperSaaS? – Quando esta opção estiver marcada e o usuário já estiver conectado ao WordPress, ele será conectado à sua conta do SuperSaaS com o nome de usuário do WordPress
- Chave de API do SuperSaaS – (Obrigatória para login automático.) Você encontra a chave de API da sua conta do SuperSaaS no fim da página Informações da Conta.
- Código do widget – (Obrigatório quando a opção ‘integrado’ estiver selecionada.) Cole o código JavaScript do widget gerado na página de widget de reservas.
- Nome da agenda – (Opcional) Você pode informar o nome de uma agenda ou fornecer uma URL completa. Uma URL pode ser útil se você quiser adicionar parâmetros extras para direcionar o usuário a uma visualização específica. Veja abaixo informações sobre múltiplas agendas.
- Configurações do botão – (Visível apenas ao redirecionar para o SuperSaaS.)
  - O rótulo do botão, por padrão, será “Agende agora” ou equivalente nos idiomas suportados.
  - A URL de uma imagem de botão, se informada, será usada no lugar do texto do botão. (Veja botões de exemplo)
- Nome de domínio personalizado – (Visível apenas ao redirecionar para o SuperSaaS.) Se você usa um nome de domínio personalizado apontando para sua agenda, pode informá-lo aqui para enviar seus usuários corretamente para ele.

Alterar configurações da conta do SuperSaaS para funcionar com WordPress

O banco de dados de usuários do WordPress é a fonte principal, o que significa que as alterações de dados de usuários no seu site WordPress serão refletidas no SuperSaaS, mas não o contrário. Por isso, recomendamos que você não permita que seus usuários alterem seus próprios dados no SuperSaaS, pois isso pode confundi-los facilmente. Por exemplo, se um usuário puder alterar a senha no SuperSaaS, provavelmente não perceberá que a senha do WordPress continua sendo a mesma.

Faça as seguintes alterações na sua conta do SuperSaaS para evitar inconsistências:

Na página Controle de acesso, selecione Login e cadastro gerenciados no seu site
Na página Controle de acesso, selecione Impedir que os usuários atualizem suas próprias informações
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 do WordPress correspondam aos do banco de dados de usuários do SuperSaaS. Faça as seguintes alterações na página Controle de acesso:

Desmarque Usar endereço de e-mail como nome de login
Altere o botão de opção de Endereço de e-mail para Opcional (ou Obrigatório)
Altere o botão de opção de Nome completo para Opcional
Altere todos os outros campos para Não perguntar (você também pode desativar o campo Senha se selecionou O login não é tratado aqui)

Configurar o SuperSaaS

Esta imagem mostra a página Controle de acesso da sua conta do SuperSaaS depois das alterações descritas acima.

Adicionar o botão às suas páginas

Coloque o shortcode [supersaas] em suas páginas em todos os lugares onde você deseja que o botão apareça. O shortcode pode receber os parâmetros opcionais schedule, label, image, options e after (apelido para schedule) 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 schedule="schedule1" label="Agendar na Agenda 1"]

[supersaas schedule="schedule2" label="Agendar na Agenda 2" image="https://example.com/book_now.gif"]

Ao usar o “widget” integrado, os parâmetros do shortcode também podem sobrescrever parâmetros do widget, como view, menu, menu_pos, etc. Um exemplo de botão que abre um widget para nome_da_agenda, exibido como cartões com o menu no topo:

[supersaas schedule="schedule_name" label="Escolha um horário!" view="card" menu_pos="top"]

Inserindo vários botões de reserva em uma postagem do WordPress — Shortcode no editor clássico (WordPress < 5,6)

Adicionar bloco de shortcode a uma postagem do WordPress — Adicionar bloco de shortcode (WordPress ≥ 5,6)

Renderização de uma postagem com vários botões — Resultado com botão

Testar

Agora você deve testar a integração no seu site, fingindo ser um usuário, para ver se tudo funciona como esperado. Observe que o login automático funciona apenas para usuários comuns do SuperSaaS, ele não conecta você como administrador. Se quiser definir superusuários no SuperSaaS, certifique-se de que eles tenham feito login pelo menos uma vez pelo seu site WordPress antes de alterar o papel deles na página Gestão de usuários.

Dicas de solução de problemas

Se você vir o erro “O e-mail não é um endereço de e-mail válido”, releia o parágrafo sobre as configurações necessárias na sua conta do SuperSaaS para confirmar se as alterações corretas foram feitas
Se você não vir o botão, certifique-se de que está logado no WordPress, ou de que desativou a configuração de login automático
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, confirme que o domínio dessa URL foi preenchido no campo Nome de domínio personalizado