Pregled

Klijent Entase JavaScript mala je biblioteka koju učitavate s našeg CDN-a. Vašoj web-stranici daje jednu funkciju koju sama ne može obaviti: otvoriti Entase naplatu na istoj stranici, tako da posjetitelj kupi ulaznicu bez napuštanja stranice na kojoj se nalazi.

Upravlja panelom ili skočnim prozorom, pozadinom, zaključavanjem pomicanja stranice, korakom privole, lokalizacijom i parametrima praćenja. Vaš kôd određuje kada otvoriti naplatu i za koji događaj.

Što nije

Klijent ne prikazuje popise događaja, datume, cijene ni dostupnost. Ako želite gotov widget koji prikazuje vaš program, umjesto toga upotrijebite kodove za ugradnju – oni se kopiraju i lijepe te ne zahtijevaju razvojni rad. Pogledajte Ugradnja događaja na vašu web-stranicu.

Ipak, to nisu alternative. Widget za ugradnju u pozadini učitava isti ovaj klijent za otvaranje naplate, zbog čega opcije klijenta možete proslijediti putem konfiguracije ugradnje. Pogledajte Napredne opcije ugradnje.

Kada ga koristiti

Klijent upotrijebite izravno kada imate vlastite stranice događaja i želite da vaš gumb „Kupi ulaznice” otvori Entase naplatu:

<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>

To je cijela integracija. Sve ostalo u ovom odjeljku služi doradi: koje su opcije dostupne, kako naplata odlučuje između panela i skočnog prozora te koje događaje možete pratiti.

Dva načina naplate

Naplata se otvara na jedan od dva načina:

• Panel – ugrađeni panel unutar vaše stranice, koji na stolnim računalima klizi s desne strane, a na mobilnim uređajima odozdo. Posjetitelj nikada ne napušta vašu stranicu.
• Skočni prozor – zaseban prozor preglednika.

Način rada s panelom pruža bolje iskustvo, ali dostupan je samo domenama koje ste dodali kao pouzdane izvore u postavkama Entasea. Klijent prepoznaje koji način smije koristiti i vraća se na skočni prozor kada ugrađena naplata nije dopuštena. Ovo je najvažnije ponašanje koje trebate razumjeti prije integracije – pogledajte Načini naplate.

Zahtjevi

• Stranica poslužena putem HTTPS-a. Na običnom HTTP-u klijent uvijek koristi skočni prozor.
• Vaša domena dodana kao pouzdani izvor u Postavke → Integracije ako želite ugrađenu naplatu. Pogledajte Integracije i prilagodba naplate.
• Nisu potrebni korak izrade, bundler ni upravitelj paketa. Biblioteka je jedna oznaka skripte.

Što dalje

• Instaliranje klijenta – učitavanje skripte i stvaranje instance.
• Opcije konstruktora – svaka opcija i njezina zadana vrijednost.
• Otvaranje naplate – metoda book() i zamjene po pozivu.
• Događaji – reagiranje na otvaranje, zatvaranje i dovršavanje naplate.