# Omówienie

> Klient JavaScript Entase otwiera proces zakupu z poziomu Twojej własnej strony internetowej – jako panel wbudowany lub wyskakujące okno – bez przekierowywania odwiedzającego na inną stronę.

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](/organizers/sharing-and-embedding/embedding-events-on-your-website.md).

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](/developers/js-client/embed-advanced-options.md).

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

```html
<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](/developers/js-client/checkout-modes.md).

## 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](/organizers/settings/integrations-and-checkout-customization.md).
- Brak potrzeby stosowania etapu budowania, bundlera ani menedżera pakietów. Biblioteka to pojedynczy znacznik skryptu.

## Co dalej

- [Instalowanie klienta](/developers/js-client/installing-the-client.md) – ładowanie skryptu i tworzenie instancji.
- [Opcje konstruktora](/developers/js-client/constructor-options.md) – każda opcja i jej wartość domyślna.
- [Otwieranie procesu zakupu](/developers/js-client/opening-the-checkout.md) – metoda `book()` i nadpisywania dla poszczególnych wywołań.
- [Zdarzenia](/developers/js-client/events.md) – reagowanie na otwarcie, zamknięcie i zakończenie procesu zakupu.