Documentazione Tecnica

Parametri di configurazione

Personalizzi il comportamento del widget con le opzioni di init()

4 min di lettura

Personalizzi il widget di prenotazione con i parametri di ReservaHamacas.init().

Configurazione di base

ReservaHamacas.init({
  // Obbligatorio
  clientId: 'IL_SUO_CLIENT_ID',

  // Opzionali
  container: '#reserva-hamacas',
  locale: 'it',
  zoneId: 'ID_DELLA_ZONA',
  theme: {
    primaryColor: '#3B82F6'
  }
});
Seleziona per copiare

Parametri disponibili

clientId (obbligatorio)

Il suo identificativo univoco di cliente.

clientId: 'abc123-def456-ghi789'
Seleziona per copiare

Lo trova in Widget → Codice.

container

Selettore CSS (o elemento) in cui verrà mostrato il widget.

container: '#reserva-hamacas'
// oppure
container: '.widget-container'
Seleziona per copiare

Predefinito: #reserva-hamacas

locale

Lingua del widget.

locale: 'it'  // Italiano
locale: 'es'  // Español
locale: 'en'  // English
Seleziona per copiare

Lingue disponibili: es, en, de, fr, it, pt.

Predefinito: la lingua del browser del visitatore.

zoneId

Preseleziona una zona specifica. Utile se ha un link dedicato per ogni zona.

zoneId: 'zone-123'
Seleziona per copiare

Può anche indicarlo direttamente nel contenitore con data-zone-id, senza toccare init():

<div id="reserva-hamacas" data-zone-id="zone-123"></div>
Seleziona per copiare

theme

Colore del marchio del widget. È un oggetto (non un testo):

theme: {
  primaryColor: '#3B82F6',  // Colore principale (pulsanti, selezione)
  accentColor: '#10B981'    // Colore di accento
}
Seleziona per copiare

Il colore principale e i testi del widget si definiscono da Widget → Personalizzazione nel pannello. Il theme del codice è un rinforzo opzionale.

onReservationComplete

Funzione eseguita quando il visitatore completa una prenotazione. Utile per attivare eventi di analitica o per reindirizzare:

onReservationComplete: function (data) {
  console.log('Prenotazione completata:', data);
  // Il suo codice qui (analitica, redirect, ecc.)
}
Seleziona per copiare

onError

Funzione per gestire errori di caricamento o della prenotazione:

onError: function (error) {
  console.error('Errore del widget:', error);
}
Seleziona per copiare

Esempio 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: 'it',
      zoneId: 'zona-vip',
      theme: {
        primaryColor: '#059669'
      },
      onReservationComplete: function (data) {
        console.log('Grazie per la sua prenotazione!', data);
      }
    });
  });
</script>
Seleziona per copiare

Configurazione tramite URL

Se usa il link diretto o l'iframe, può passare i parametri tramite l'URL:

https://reservadehamacas.com/embed/IL_SUO_CLIENT_ID?zoneId=ID_DELLA_ZONA&lang=it
Seleziona per copiare

Parametri supportati nell'URL:

  • clientId
  • zoneId
  • lang (lingua)

Prossimo passo

Impari a personalizzare l'aspetto visivo del widget.

Parametri di configurazione