Pregled

Odjemalec Entase JavaScript je majhna knjižnica, ki jo naložite z našega CDN-ja. Vašemu spletnemu mestu omogoča eno stvar, ki je samo ne more opraviti: odpreti blagajno Entase na mestu, da obiskovalec kupi vstopnico, ne da bi zapustil stran, na kateri je.

Upravlja podokno ali pojavno okno, ozadje, zaklepanje pomikanja strani, korak privolitve, jezikovne nastavitve in parametre sledenja. Vaša koda določi, kdaj odpreti blagajno in za kateri dogodek.

Kaj ni

Odjemalec ne prikazuje seznamov dogodkov, datumov, cen ali razpoložljivosti. Če želite že pripravljen gradnik, ki prikazuje vaš program, namesto tega uporabite vdelavne kode – te samo kopirate in prilepite ter ne zahtevajo razvojnega dela. Glejte Vdelava dogodkov na spletno mesto.

Vendar to nista alternativi. Vdelavni gradnik v ozadju naloži istega odjemalca za odpiranje svoje blagajne, zato lahko možnosti odjemalca posredujete prek konfiguracije vdelave. Glejte Napredne možnosti vdelave.

Kdaj ga uporabiti

Odjemalca uporabite neposredno, kadar imate svoje strani dogodkov in želite, da vaš gumb »Kupi vstopnice« odpre blagajno 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>

To je celotna integracija. Vse drugo v tem razdelku je izpopolnjevanje: katere možnosti obstajajo, kako blagajna izbira med podoknom in pojavnim oknom ter katerim dogodkom lahko prisluhnete.

Dva načina blagajne

Blagajna se odpre na enega od dveh načinov:

• Podokno – vdelano podokno na vaši strani, ki se na namiznih napravah pomakne z desne, na mobilnih pa od spodaj. Obiskovalec nikoli ne zapusti vašega spletnega mesta.
• Pojavno okno – ločeno okno brskalnika.

Način podokna ponuja boljšo izkušnjo, vendar je na voljo le domenam, ki ste jih v nastavitvah Entase dodali kot zaupanja vredne izvore. Odjemalec zazna, katerega sme uporabiti, in uporabi pojavno okno, kadar vdelana blagajna ni dovoljena. To je najpomembnejše vedenje, ki ga morate razumeti pred integracijo – glejte Načini blagajne.

Zahteve

• Stran, dostopna prek HTTPS. Pri navadnem HTTP odjemalec vedno uporabi pojavno okno.
• Vaša domena mora biti dodana med zaupanja vredne izvore v Nastavitve → Integracije, če želite vdelano blagajno. Glejte Integracije in prilagajanje blagajne.
• Brez koraka gradnje, združevalnika ali upravitelja paketov. Knjižnica je ena sama oznaka skripta.

Kam naprej

• Namestitev odjemalca – nalaganje skripta in ustvarjanje primerka.
• Možnosti konstruktorja – vse možnosti in njihove privzete vrednosti.
• Odpiranje blagajne – metoda book() in preglasitve za posamezen klic.
• Dogodki – odzivanje na odpiranje, zapiranje in dokončanje blagajne.