Panoramica

Il client JavaScript di Entase è una piccola libreria che carichi dalla nostra CDN. Offre al tuo sito web una funzionalità che non può svolgere da solo: aprire il checkout Entase direttamente nella pagina, così un visitatore può acquistare un biglietto senza lasciare la pagina in cui si trova.

Gestisce il pannello o la finestra pop-up, lo sfondo, il blocco dello scorrimento della pagina, il passaggio relativo al consenso, la lingua e i parametri di tracciamento. Il tuo codice decide quando aprire il checkout e per quale evento.

Cosa non è

Il client non visualizza elenchi di eventi, date, prezzi o disponibilità. Se desideri un widget già pronto che mostri il tuo programma, usa invece i codici di incorporamento – sono da copiare e incollare e non richiedono lavoro di sviluppo. Consulta Incorporare eventi sul tuo sito web.

Tuttavia, i due non sono alternative. Il widget incorporato carica internamente questo stesso client per aprire il relativo checkout, motivo per cui puoi passare le opzioni del client tramite la configurazione di incorporamento. Consulta Opzioni avanzate di incorporamento.

Quando usarlo

Usa direttamente il client quando hai le tue pagine evento e desideri che il tuo pulsante "Acquista biglietti" apra il checkout Entase:

<button id="buy">Buy tickets</button>

<script src="https://js.entase.com/client.js"></script>
<script>
  const entase = new Entase({ pk: 'YOUR_PUBLISHABLE_KEY' });
  document.getElementById('buy').addEventListener('click', () => {
    entase.book('EVENT_ID');
  });
</script>

Questa è l'intera integrazione. Tutto il resto di questa sezione è un affinamento: quali opzioni sono disponibili, come il checkout sceglie tra un pannello e una finestra pop-up e a quali eventi puoi rimanere in ascolto.

Due modalità di checkout

Il checkout si apre in uno di due modi:

• Pannello – un pannello integrato nella tua pagina, che scorre da destra su desktop e dal basso su dispositivi mobili. Il visitatore non lascia mai il tuo sito.
• Popup – una finestra del browser separata.

La modalità pannello offre un'esperienza migliore, ma è disponibile solo per i domini che hai aggiunto come origini attendibili nelle impostazioni di Entase. Il client rileva quale modalità è autorizzato a usare e passa a una finestra pop-up quando il checkout integrato non è consentito. Questo è il comportamento più importante da comprendere prima dell'integrazione – consulta Modalità di checkout.

Requisiti

• Una pagina servita tramite HTTPS. Con il semplice HTTP, il client usa sempre una finestra pop-up.
• Il tuo dominio aggiunto alle origini attendibili in Impostazioni → Integrazioni, se desideri il checkout integrato. Consulta Integrazioni e personalizzazione del checkout.
• Nessun passaggio di build, bundler o gestore di pacchetti. La libreria è costituita da un singolo tag script.

Dove andare ora

• Installare il client – caricare lo script e creare un'istanza.
• Opzioni del costruttore – ogni opzione e il relativo valore predefinito.
• Aprire il checkout – il metodo book() e le sostituzioni per singola chiamata.
• Eventi – reagire all'apertura, alla chiusura e al completamento del checkout.