Az Entase JavaScript-kliens egy kis könyvtár, amelyet a CDN-ünkről tölthet be. Olyan funkcióval bővíti a webhelyét, amelyet az önmagában nem tud ellátni: helyben megnyitja az Entase pénztárat, így a látogató anélkül vásárolhat jegyet, hogy elhagyná az éppen megnyitott oldalt.
Kezeli a panelt vagy a felugró ablakot, a háttérréteget, az oldalgörgetés zárolását, a hozzájárulási lépést, a területi beállítást és a követési paramétereket. Az Ön kódja dönti el, mikor nyíljon meg a pénztár, és melyik eseményhez.
Mi nem tartozik ide
A kliens nem jeleníti meg az eseménylistákat, dátumokat, árakat vagy az elérhetőséget. Ha a programját megjelenítő, használatra kész widgetet szeretne, inkább a beágyazási kódokat használja – ezek másolhatók és beilleszthetők, és nem igényelnek fejlesztői munkát. Lásd: Események beágyazása a webhelyére.
A kettő azonban nem egymást helyettesítő megoldás. A beágyazott widget a háttérben ugyanezt a klienst tölti be a pénztár megnyitásához, ezért a kliens beállításait a beágyazás konfigurációján keresztül is átadhatja. Lásd: Speciális beágyazási beállítások.
Mikor használja
Használja közvetlenül a klienst, ha saját eseményoldalai vannak, és azt szeretné, hogy a saját „Jegyvásárlás” gombja nyissa meg az Entase pénztárat:
<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>Ennyi az egész integráció. A szakasz további része a finomhangolásról szól: milyen lehetőségek állnak rendelkezésre, hogyan választ a pénztár a panel és a felugró ablak között, és mely eseményekre figyelhet.
A pénztár két módja
A pénztár kétféleképpen nyílik meg:
- Panel – egy, az oldalon belüli panel, amely asztali gépen jobbról, mobileszközön pedig alulról csúszik be. A látogató nem hagyja el a webhelyét.
- Felugró ablak – egy külön böngészőablak.
A paneles mód jobb felhasználói élményt nyújt, de csak azoknál a domaineknél érhető el, amelyeket megbízható origin-ként adott hozzá az Entase beállításaiban. A kliens érzékeli, melyiket használhatja, és felugró ablakra vált, ha a beágyazott pénztár nem engedélyezett. Ez a legfontosabb működés, amelyet az integráció előtt meg kell értenie – lásd: Pénztármódok.
Követelmények
- HTTPS-en kiszolgált oldal. Egyszerű HTTP esetén a kliens mindig felugró ablakot használ.
- A domainje hozzáadva megbízható origin-ként a Beállítások → Integrációk menüben, ha beágyazott pénztárat szeretne. Lásd: Integrációk és a pénztár testreszabása.
- Nincs szükség build lépésre, csomagolóra vagy csomagkezelőre. A könyvtár egyetlen scriptcímke.
Következő lépések
- A kliens telepítése – a script betöltése és példány létrehozása.
- Konstruktorbeállítások – minden beállítás és alapértelmezett értéke.
- A pénztár megnyitása – a
book()metódus és a hívásonkénti felülírások. - Események – reagálás a pénztár megnyitására, bezárására és befejezésére.