Klient JavaScript Entase to niewielka biblioteka ładowana z naszego CDN. Daje Twojej stronie możliwość, której nie ma ona sama: otwieranie procesu zakupu Entase na miejscu, dzięki czemu odwiedzający kupuje bilet bez opuszczania aktualnie wyświetlanej strony.
Obsługuje panel lub wyskakujące okno, tło, blokowanie przewijania strony, etap zgody, ustawienia regionalne i parametry śledzenia. Twój kod decyduje, kiedy otworzyć proces zakupu i dla którego wydarzenia.
Czym nie jest
Klient nie wyświetla list wydarzeń, dat, cen ani dostępności. Jeśli chcesz skorzystać z gotowego widżetu prezentującego Twój program, użyj zamiast tego kodów osadzania – wystarczy je skopiować i wkleić, bez żadnych prac programistycznych. Zobacz Osadzanie wydarzeń na swojej stronie internetowej.
Nie są to jednak rozwiązania alternatywne. Widżet osadzany korzysta wewnętrznie z tego samego klienta, aby otwierać proces zakupu, dlatego możesz przekazywać opcje klienta w konfiguracji osadzania. Zobacz Zaawansowane opcje osadzania.
Kiedy go używać
Użyj klienta bezpośrednio, gdy masz własne strony wydarzeń i chcesz, aby Twój własny przycisk „Kup bilety” otwierał proces zakupu 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 cała integracja. Wszystko inne w tej sekcji to dopracowanie: dostępne opcje, sposób, w jaki proces zakupu wybiera między panelem a wyskakującym oknem, oraz zdarzenia, których możesz nasłuchiwać.
Dwa tryby procesu zakupu
Proces zakupu otwiera się na jeden z dwóch sposobów:
- Panel – panel wbudowany w Twoją stronę, wysuwany z prawej strony na komputerze i od dołu na urządzeniach mobilnych. Odwiedzający nigdy nie opuszcza Twojej witryny.
- Wyskakujące okno – osobne okno przeglądarki.
Tryb panelu zapewnia lepsze wrażenia, ale jest dostępny tylko dla domen dodanych jako zaufane źródła w ustawieniach Entase. Klient wykrywa, którego trybu może użyć, i przełącza się na wyskakujące okno, gdy wbudowany proces zakupu nie jest dozwolony. To najważniejsze zachowanie, które należy zrozumieć przed integracją – zobacz Tryby procesu zakupu.
Wymagania
- Strona udostępniana przez HTTPS. W przypadku zwykłego HTTP klient zawsze używa wyskakującego okna.
- Twoja domena dodana do zaufanych źródeł w Ustawienia → Integracje, jeśli chcesz korzystać z wbudowanego procesu zakupu. Zobacz Integracje i dostosowywanie procesu zakupu.
- Brak potrzeby stosowania etapu budowania, bundlera ani menedżera pakietów. Biblioteka to pojedynczy znacznik skryptu.
Co dalej
- Instalowanie klienta – ładowanie skryptu i tworzenie instancji.
- Opcje konstruktora – każda opcja i jej wartość domyślna.
- Otwieranie procesu zakupu – metoda
book()i nadpisywania dla poszczególnych wywołań. - Zdarzenia – reagowanie na otwarcie, zamknięcie i zakończenie procesu zakupu.