Přehled

Klient Entase JavaScript je malá knihovna, kterou načtete z našeho CDN. Umožní vašemu webu dělat jednu věc, kterou sám nedokáže: otevřít pokladnu Entase přímo na stránce, aby si návštěvník koupil vstupenku, aniž by opustil stránku, na které se nachází.

Zajišťuje panel nebo vyskakovací okno, překryvné pozadí, uzamčení posouvání stránky, krok se souhlasem, národní prostředí a parametry sledování. Váš kód rozhoduje, kdy pokladnu otevřít a pro kterou událost.

Čím není

Klient nevykresluje přehledy událostí, termíny, ceny ani dostupnost. Pokud chcete hotový widget zobrazující váš program, použijte místo toho kódy pro vložení – stačí je zkopírovat a vložit a nevyžadují žádnou vývojářskou práci. Viz Vkládání událostí na váš web.

Tyto dvě možnosti však nejsou alternativami. Widget pro vložení na pozadí načítá stejného klienta pro otevření pokladny, proto můžete předávat možnosti klienta prostřednictvím konfigurace vložení. Viz Pokročilé možnosti vložení.

Kdy ho použít

Použijte klienta přímo, pokud máte vlastní stránky událostí a chcete, aby vaše vlastní tlačítko „Koupit vstupenky“ otevřelo pokladnu 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á integrace. Vše ostatní v této části je doladění: jaké možnosti jsou k dispozici, jak pokladna rozhoduje mezi panelem a vyskakovacím oknem a kterým událostem můžete naslouchat.

Dva režimy pokladny

Pokladna se otevírá jedním ze dvou způsobů:

• Panel – vložený panel na vaší stránce, který se na počítači vysouvá zprava a na mobilu ze spodní části. Návštěvník nikdy neopustí váš web.
• Vyskakovací okno – samostatné okno prohlížeče.

Režim panelu poskytuje lepší uživatelský zážitek, je však dostupný pouze pro domény, které jste v nastavení Entase přidali jako důvěryhodné zdroje. Klient rozpozná, kterou možnost smí použít, a pokud není vložená pokladna povolena, použije vyskakovací okno. Toto je zdaleka nejdůležitější chování, kterému je třeba před integrací porozumět – viz Režimy pokladny.

Požadavky

• Stránka poskytovaná přes HTTPS. Při běžném HTTP klient vždy použije vyskakovací okno.
• Vaše doména přidaná mezi důvěryhodné zdroje v Nastavení → Integrace, pokud chcete vloženou pokladnu. Viz Integrace a přizpůsobení pokladny.
• Žádný krok sestavení, bundler ani správce balíčků. Knihovna se skládá z jediného tagu skriptu.

Kam dál

• Instalace klienta – načtení skriptu a vytvoření instance.
• Možnosti konstruktoru – všechny možnosti a jejich výchozí hodnoty.
• Otevření pokladny – metoda book() a přepsání nastavení pro jednotlivá volání.
• Události – reakce na otevření, zavření a dokončení pokladny.