Documentação Técnica

Parâmetros de configuração

Personalize o comportamento do widget com as opções de init()

4 min de leitura

Personalize o widget de reservas com os parâmetros de ReservaHamacas.init().

Configuração básica

ReservaHamacas.init({
  // Obrigatório
  clientId: 'O_SEU_CLIENT_ID',

  // Opcionais
  container: '#reserva-hamacas',
  locale: 'pt',
  zoneId: 'ID_DA_ZONA',
  theme: {
    primaryColor: '#3B82F6'
  }
});
Selecione para copiar

Parâmetros disponíveis

clientId (obrigatório)

O seu identificador único de cliente.

clientId: 'abc123-def456-ghi789'
Selecione para copiar

Encontra-o em WidgetCódigo.

container

Seletor CSS (ou elemento) onde o widget será apresentado.

container: '#reserva-hamacas'
// ou
container: '.widget-container'
Selecione para copiar

Por omissão: #reserva-hamacas

locale

Idioma do widget.

locale: 'pt'  // Português
locale: 'es'  // Español
locale: 'en'  // English
Selecione para copiar

Idiomas disponíveis: es, en, de, fr, it, pt.

Por omissão: o idioma do navegador do visitante.

zoneId

Pré-seleciona uma zona concreta. Útil se tiver uma ligação específica para cada zona.

zoneId: 'zone-123'
Selecione para copiar

Também o pode indicar no próprio contentor com data-zone-id, sem mexer no init():

<div id="reserva-hamacas" data-zone-id="zone-123"></div>
Selecione para copiar

theme

Cor da marca do widget. É um objeto (não um texto):

theme: {
  primaryColor: '#3B82F6',  // Cor principal (botões, seleção)
  accentColor: '#10B981'    // Cor de destaque
}
Selecione para copiar

A cor principal e os textos do widget definem-se em WidgetPersonalização, no painel. O theme do código é um reforço opcional.

onReservationComplete

Função executada quando o visitante conclui uma reserva. Útil para disparar eventos de analítica ou para redirecionar:

onReservationComplete: function (data) {
  console.log('Reserva concluída:', data);
  // O seu código aqui (analítica, redirecionamento, etc.)
}
Selecione para copiar

onError

Função para tratar erros de carregamento ou da reserva:

onError: function (error) {
  console.error('Erro do widget:', error);
}
Selecione para copiar

Exemplo completo

<div id="reserva-hamacas"></div>
<script src="https://cdn.reservadehamacas.com/widget/embed.js"></script>
<script>
  document.addEventListener('DOMContentLoaded', function () {
    ReservaHamacas.init({
      clientId: 'abc123-def456',
      container: '#reserva-hamacas',
      locale: 'pt',
      zoneId: 'zona-vip',
      theme: {
        primaryColor: '#059669'
      },
      onReservationComplete: function (data) {
        console.log('Obrigado pela sua reserva!', data);
      }
    });
  });
</script>
Selecione para copiar

Configuração através do endereço

Se usar a ligação direta ou o iframe, pode passar parâmetros pelo endereço:

https://reservadehamacas.com/embed/O_SEU_CLIENT_ID?zoneId=ID_DA_ZONA&lang=pt
Selecione para copiar

Parâmetros suportados no endereço:

  • clientId
  • zoneId
  • lang (idioma)

Passo seguinte

Aprenda a personalizar o aspeto visual do widget.

Parâmetros de configuração