De Entase JavaScript-client is een kleine bibliotheek die je vanaf onze CDN laadt. Hij geeft je website één taak die deze niet zelf kan uitvoeren: de Entase-checkout ter plaatse openen, zodat een bezoeker een ticket koopt zonder de huidige pagina te verlaten.
Hij regelt het paneel of pop-upvenster, de achtergrondlaag, het vergrendelen van het scrollen op de pagina, de toestemmingsstap, de landinstelling en trackingparameters. Jouw code bepaalt wanneer de checkout wordt geopend en voor welk evenement.
Wat het niet is
De client rendert geen evenementoverzichten, datums, prijzen of beschikbaarheid. Als je een kant-en-klare widget wilt die je programma toont, gebruik dan in plaats daarvan de embedcodes – die kun je kopiëren en plakken en vereisen geen ontwikkelwerk. Zie Evenementen op je website insluiten.
De twee zijn echter geen alternatieven. De embedwidget laadt onderliggend dezelfde client om de checkout te openen. Daarom kun je clientopties doorgeven via de embedconfiguratie. Zie Geavanceerde embedopties.
Wanneer je deze gebruikt
Gebruik de client rechtstreeks wanneer je eigen evenementpagina's hebt en wilt dat je eigen knop "Tickets kopen" de Entase-checkout opent:
<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>Dat is de volledige integratie. Al het andere in deze sectie is verfijning: welke opties er zijn, hoe de checkout kiest tussen een paneel en een pop-up, en naar welke gebeurtenissen je kunt luisteren.
Twee checkoutmodi
De checkout wordt op een van twee manieren geopend:
- Paneel – een inline paneel in je pagina, dat op desktop vanaf rechts en op mobiel vanaf onderen inschuift. De bezoeker verlaat je site nooit.
- Pop-up – een afzonderlijk browservenster.
De paneelmodus biedt de betere ervaring, maar is alleen beschikbaar voor domeinen die je als vertrouwde origins hebt toegevoegd in je Entase-instellingen. De client detecteert welke modus hij mag gebruiken en valt terug op een pop-up wanneer inline checkout niet is toegestaan. Dit is het allerbelangrijkste gedrag om te begrijpen voordat je integreert – zie Checkoutmodi.
Vereisten
- Een pagina die wordt aangeboden via HTTPS. Bij gewone HTTP gebruikt de client altijd een pop-up.
- Je domein is toegevoegd aan trusted origins in Instellingen → Integraties, als je inline checkout wilt. Zie Integraties en checkoutaanpassing.
- Geen buildstap, bundler of pakketbeheerder. De bibliotheek bestaat uit één script-tag.
Waar je vervolgens naartoe kunt
- De client installeren – het script laden en een instantie maken.
- Constructoropties – elke optie en de standaardwaarde ervan.
- De checkout openen – de methode
book()en overschrijvingen per aanroep. - Gebeurtenissen – reageren op het openen, sluiten en voltooien van de checkout.