Suporte
Documentação

Adicionar CSS ou JavaScript à sua agenda

Esta página explica como personalizar suas mensagens na tela usando HTML, permitindo incorporar CSS e scripts JavaScript. O CSS permite estilizar páginas, enquanto scripts JavaScript podem adicionar recursos visuais e funcionais ao seu site, alterar conteúdo, registrar informações e muito mais.
Esta página é voltada à personalização técnica com HTML, CSS ou JavaScript. Se você só quer alterar texto normal ou o conteúdo das mensagens, comece por Personalizando mensagens na tela.

Adicionar HTML dentro de campos de texto

No SuperSaaS, HTML, CSS e JavaScript só podem ser inseridos em campos de texto que permitam conteúdo HTML. Há quatro lugares onde você pode adicionar HTML:
  • Na caixa de mensagem em Configurações de layout
  • Nas caixas de mensagem localizadas em cada agenda na página Configurar > Layout
  • Na caixa de comentário HTML em formulários personalizados, acessando Configurar > Design
  • Nas caixas de mensagem de e-mail da página Configurar > Layout, se o HTML estiver ativado para e-mails
Nem todas as contas têm permissão para usar JavaScript. Se você tiver uma conta gratuita, talvez precise entrar em contato com o suporte para solicitar liberação para adicionar JavaScript à página. Não é possível adicionar JavaScript a mensagens de e-mail.

Alterar a aparência da sua agenda com CSS

Se você quiser adicionar estilos específicos a determinadas páginas da agenda para combiná-las com o seu site, por exemplo, pode usar CSS. Assim como os scripts, o CSS pode ser adicionado a cada caixa de mensagem que permite HTML. Clique no botão < > na barra de ferramentas da caixa de mensagem para abrir o campo de código-fonte e inserir seu CSS. Você precisará de algum conhecimento técnico básico para aplicar isso à sua agenda. Há duas maneiras de usar CSS no SuperSaaS: com CSS embutido ou com uma folha de estilo externa.

CSS embutido

CSS embutido é um método que permite aplicar estilos diretamente a elementos HTML individuais dentro da sua agenda. Isso é feito usando o atributo style na tag de abertura de um elemento HTML. Por exemplo, se quiser mudar a cor do texto de um parágrafo para verde e definir a fonte em 16 píxeis, você faria assim:

<p style="color: green; font-size: 16px;"> Este é um parágrafo com texto verde e tamanho de fonte de 16 píxeis.</p>

Este é um parágrafo com texto verde e tamanho de fonte de 16 píxeis.

CSS embutido é ótimo para alterar rapidamente o estilo de um elemento específico sem afetar o restante da página. No entanto, ele se torna menos prático quando você precisa aplicar o mesmo estilo a muitos elementos, porque terá de repetir o código diversas vezes.

CSS embutido em e-mails

O SuperSaaS oferece dois formatos de e-mail: texto simples e HTML. Por padrão, os e-mails são enviados em texto simples, o que só permite texto básico. Se quiser incluir imagens, HTML ou estilos como CSS, ative a formatação HTML para e-mails na página Configurações de layout. Em e-mails, você precisa usar CSS embutido, porque clientes de e-mail não suportam folhas de estilo da mesma forma que páginas da web. Depois de ativar o formato HTML para mensagens de e-mail, você poderá aplicar CSS embutido como explicado acima.

Usando uma folha de estilo externa

Embora o CSS embutido seja útil para pequenas mudanças, ele se torna difícil de manter quando você tem muito CSS. Nesses casos, pode ser melhor usar uma folha de estilo externa. Para vinculá-la, é importante que essa folha de estilo esteja acessível em outro servidor, já que não é possível armazenar arquivos CSS diretamente no SuperSaaS. A estrutura básica para vincular uma folha de estilo externa é:

<link rel="stylesheet" href="https://{www.inseraseusite}/css/estilo.css">

Depois de aplicar o CSS no código-fonte das caixas de mensagem que aceitam HTML, clique em “Salvar” e visite a página para confirmar que o estilo foi aplicado corretamente.

Adicionando CSS ao seu widget

Você também pode adicionar CSS a um widget de agenda incorporado ao seu site. Se quiser personalizar o estilo do widget, poderá adicionar seu próprio CSS, que será inserido entre tags de estilo em cada frame, ou vincular uma folha de estilo externa. No entanto, lembre-se de que a estrutura e os identificadores do widget podem mudar com futuras atualizações, então não conte com eles como se fossem fixos.

var supersaas = new SuperSaaS("demo", "Therapist", {"custom_css": "h1 {color:red}"})
var supersaas = new SuperSaaS("demo", "Therapist", {"custom_css": "https://….css"})

Para mais informações sobre a personalização do widget do SuperSaaS, consulte nossa documentação para desenvolvedores.

Usando scripts no SuperSaaS

Scripts JavaScript podem ser úteis para integrar recursos dinâmicos às páginas da sua agenda ou aos formulários, enriquecendo o processo de reserva. Você pode integrar diferentes serviços ou funções, como chat ao vivo, botões, contadores regressivos ou códigos de rastreamento para serviços como Google Analytics ou Bing.

Por exemplo, o trecho abaixo adiciona um botão pop-up como este , que pode ser usado para mostrar informações adicionais quando clientes reservam pela sua página.

<input onclick="window.open('//static.supersaas.net/img/demo_room.jpg', 'Popup', 'width=400,height=300')" type="button" value="Pop-up">

Como inserir um script

  1. Encontre sua caixa de mensagem: Vá até a caixa de mensagem onde deseja adicionar o script JavaScript. Ela pode estar em qualquer um dos locais mencionados acima
  2. Abra o campo de código-fonte: Clique no botão < > da barra de ferramentas para abrir o campo de código-fonte
  3. Copie o seu script: Pegue o trecho de código do serviço ou da função que deseja integrar, como um botão de chat ao vivo para atendimento ou um serviço de analytics, como Google Analytics
  4. Adicione ao campo de código-fonte e salve: cole o trecho de código no campo de código-fonte no SuperSaaS e clique em salvar. Depois, role até o fim da página de layout e clique em salvar alterações
  5. Teste: Depois de salvar, visite a página em que o trecho foi aplicado para garantir que o script esteja funcionando corretamente. Se precisar do mesmo código em várias páginas, repita o processo em cada caixa de mensagem personalizada
Cada campo de texto pode conter até 3000 caracteres. Se precisar incluir mais código, use uma tag src no seu script para apontar para um arquivo HTML externo e coloque essa tag no código-fonte. Isso permite adicionar bastante JavaScript sem ultrapassar o limite de caracteres. Para garantir carregamento rápido da página, é uma boa ideia adicionar também um atributo defer à tag src.

Opções extras dentro do SuperSaaS

Usando autotexto com scripts

As sequências de autotexto são um conjunto de “palavras mágicas” substituídas automaticamente por outra informação quando a mensagem é gerada. Autotextos são úteis em e-mails e mensagens na tela, mas também podem ser usados em HTML em conjunto com scripts. Na página de personalização de mensagens na tela você encontra todas as instruções de autotexto que podem ser usadas com HTML.

Autotexto também pode ser usado para adicionar scripts condicionalmente. Por exemplo, para incluir um script apenas se um pagamento tiver sido concluído com sucesso. Para isso, basta colocar o trecho de código dentro das chaves da instrução condicional.

$if paid {Obrigado pela compra, $name <script>…</script>}

Graças à instrução condicional $if, o trecho de código neste caso só será executado se alguém tiver pago. Se o pagamento falhar, ou se um administrador ou superusuário criar um compromisso sem pagar, o script não será executado. Você também pode usar autotexto para mostrar um botão de chatbot apenas quando um usuário estiver logado e ocultá-lo quando um superusuário estiver logado.

Outras formas de rastrear reservas

Outra forma de rastrear reservas concluídas com sucesso é adicionar uma URL de uma página do seu site em Configurar > Processo, em Para onde enviamos o usuário após criar uma reserva com sucesso?. Nessa página de “Obrigado”, você pode adicionar seu próprio script com código de analytics, que os clientes verão apenas depois de concluir a reserva. Você pode usar as “palavras mágicas” $name, $id, $price, $slot_id, $email, $lang ou $full_name na URL. Elas serão substituídas pelo nome de login do compromisso, ID, preço, ID do horário, e-mail, idioma ou nome completo, respectivamente. O script nessa página poderá então coletar essas informações quando o usuário chegar até ela.