Apžvalga

Entase JavaScript klientas yra nedidelė biblioteka, kuri įkeliama iš mūsų CDN. Ji suteikia jūsų svetainei vieną funkciją, kurios ji pati atlikti negali: atidaryti Entase atsiskaitymo langą vietoje, kad lankytojas galėtų nusipirkti bilietą neišeidamas iš puslapio, kuriame yra.

Ji tvarko skydelį arba iššokantįjį langą, foninį sluoksnį, puslapio slinkimo užrakinimą, sutikimo veiksmą, lokalę ir stebėjimo parametrus. Jūsų kodas nusprendžia, kada atidaryti atsiskaitymo langą ir kuriam renginiui.

Kas tai nėra

Klientas neatvaizduoja renginių sąrašų, datų, kainų ar prieinamumo. Jei norite paruošto valdiklio, rodančio jūsų programą, vietoj to naudokite įterpimo kodus – juos galima tiesiog nukopijuoti ir įklijuoti, todėl nereikia jokių programavimo darbų. Žr. Renginių įterpimas į svetainę.

Tačiau šie du sprendimai nėra alternatyvos. Įterpimo valdiklis naudoja tą patį klientą atsiskaitymo langui atidaryti, todėl kliento parinktis galite perduoti per įterpimo konfigūraciją. Žr. Išplėstinės įterpimo parinktys.

Kada jį naudoti

Naudokite klientą tiesiogiai, kai turite savo renginių puslapius ir norite, kad jūsų mygtukas „Pirkti bilietus“ atidarytų Entase atsiskaitymo langą:

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

Tai ir yra visa integracija. Visa kita šiame skyriuje – patikslinimai: kokios parinktys yra, kaip atsiskaitymo langas nusprendžia, ar rodyti skydelį, ar iššokantįjį langą, ir kurių įvykių galite klausytis.

Du atsiskaitymo režimai

Atsiskaitymo langas atidaromas vienu iš dviejų būdų:

• Skydelis – įterptasis skydelis jūsų puslapyje, darbalaukyje įslenkantis iš dešinės, o mobiliajame įrenginyje – iš apačios. Lankytojas niekada neišeina iš jūsų svetainės.
• Iššokantysis langas – atskiras naršyklės langas.

Skydelio režimas suteikia geresnę patirtį, tačiau jis prieinamas tik domenams, kuriuos Entase nustatymuose pridėjote kaip patikimas kilmes. Klientas nustato, kurį režimą leidžiama naudoti, ir grįžta prie iššokančiojo lango, kai įterptasis atsiskaitymo langas neleidžiamas. Tai svarbiausia elgsena, kurią reikia suprasti prieš integruojant – žr. Atsiskaitymo režimai.

Reikalavimai

• Puslapis turi būti pateikiamas per HTTPS. Naudojant paprastą HTTP klientas visada naudoja iššokantįjį langą.
• Jei norite įterptojo atsiskaitymo lango, jūsų domenas turi būti pridėtas prie patikimų kilmių skiltyje Nustatymai → Integracijos. Žr. Integracijos ir atsiskaitymo lango tinkinimas.
• Nereikia kūrimo etapo, rinkiklio ar paketų tvarkytuvės. Biblioteką sudaro viena scenarijaus žyma.

Kur eiti toliau

• Kliento diegimas – scenarijaus įkėlimas ir egzemplioriaus sukūrimas.
• Konstruktoriaus parinktys – visos parinktys ir numatytosios jų reikšmės.
• Atsiskaitymo lango atidarymas – metodas book() ir kiekvieno iškvietimo nepaisymo parinktys.
• Įvykiai – reagavimas į atsiskaitymo lango atidarymą, uždarymą ir užbaigimą.