Prehľad

JavaScriptový klient Entase je malá knižnica, ktorú načítate z nášho CDN. Vašej webovej stránke poskytuje jednu funkciu, ktorú sama nedokáže vykonať: otvoriť pokladňu Entase priamo na stránke, aby si návštevník kúpil vstupenku bez toho, aby opustil stránku, na ktorej sa nachádza.

Spravuje panel alebo vyskakovacie okno, prekrytie, blokovanie posúvania stránky, krok so súhlasom, miestne nastavenie a parametre sledovania. Váš kód rozhoduje, kedy sa pokladňa otvorí a pre ktoré podujatie.

Čím nie je

Klient nevykresľuje zoznamy podujatí, dátumy, ceny ani dostupnosť. Ak chcete hotový widget zobrazujúci váš program, použite namiesto toho vkladacie kódy – stačí ich skopírovať a vložiť a nevyžadujú žiadnu vývojársku prácu. Pozrite si Vkladanie podujatí na vašu webovú stránku.

Tieto dve možnosti však nie sú alternatívami. Vkladací widget na otvorenie pokladne používa na pozadí toho istého klienta, preto môžete možnosti klienta odovzdať prostredníctvom konfigurácie vloženia. Pozrite si Rozšírené možnosti vloženia.

Kedy ho použiť

Klienta použite priamo, ak máte vlastné stránky podujatí a chcete, aby vaše vlastné tlačidlo „Kúpiť vstupenky“ otvorilo pokladňu 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 celá integrácia. Všetko ostatné v tejto časti je doladenie: aké možnosti sú k dispozícii, ako pokladňa rozhoduje medzi panelom a vyskakovacím oknom a ktoré udalosti môžete sledovať.

Dva režimy pokladne

Pokladňa sa otvorí jedným z dvoch spôsobov:

• Panel – vložený panel na vašej stránke, ktorý sa na počítači vysunie sprava a na mobile zdola. Návštevník nikdy neopustí váš web.
• Vyskakovacie okno – samostatné okno prehliadača.

Režim panela poskytuje lepší zážitok, ale je k dispozícii len pre domény, ktoré ste v nastaveniach Entase pridali ako dôveryhodné zdroje. Klient rozpozná, ktorý režim smie použiť, a ak vložená pokladňa nie je povolená, použije vyskakovacie okno. Toto je najdôležitejšie správanie, ktorému treba pred integráciou porozumieť – pozrite si Režimy pokladne.

Požiadavky

• Stránka poskytovaná cez HTTPS. Pri bežnom HTTP klient vždy použije vyskakovacie okno.
• Vaša doména pridaná medzi dôveryhodné zdroje v časti Nastavenia → Integrácie, ak chcete vloženú pokladňu. Pozrite si Integrácie a prispôsobenie pokladne.
• Žiadny krok zostavenia, bundler ani správca balíkov. Knižnica je jeden značkovací prvok script.

Kam ďalej

• Inštalácia klienta – načítanie skriptu a vytvorenie inštancie.
• Možnosti konštruktora – všetky možnosti a ich predvolené hodnoty.
• Otvorenie pokladne – metóda book() a prepísania pre jednotlivé volania.
• Udalosti – reakcie na otvorenie, zatvorenie a dokončenie pokladne.