# Yleiskatsaus

> Entase JavaScript -asiakasohjelma avaa kassan omalta verkkosivustoltasi joko sivunsisäisenä paneelina tai ponnahdusikkunana lähettämättä kävijää toiselle sivulle.

Entase JavaScript -asiakasohjelma on pieni kirjasto, joka ladataan CDN:stämme. Se antaa verkkosivustollesi yhden tehtävän, johon se ei yksin pysty: **avaa Entase-kassa paikalleen**, jotta kävijä voi ostaa lipun poistumatta sivulta, jolla hän on.

Se hallitsee paneelin tai ponnahdusikkunan, taustapeitteen, sivun vierityksen lukituksen, suostumusvaiheen, kielialueen ja seurantaparametrit. Koodisi määrittää, *milloin* kassa avataan ja *mille tapahtumalle*.

## Mitä se ei ole

Asiakasohjelma ei hahmonna tapahtumaluetteloita, päivämääriä, hintoja tai saatavuutta. Jos haluat valmiin ohjelmaasi esittelevän widgetin, käytä sen sijaan upotuskoodia – ne voi kopioida ja liittää, eivätkä ne vaadi kehitystyötä. Katso [Tapahtumien upottaminen verkkosivustollesi](/organizers/sharing-and-embedding/embedding-events-on-your-website.md).

Nämä kaksi eivät kuitenkaan ole vaihtoehtoja toisilleen. Upotuswidget lataa taustalla tämän saman asiakasohjelman avatakseen kassansa, minkä vuoksi voit välittää asiakasohjelman asetuksia upotuksen määrityksen kautta. Katso [Upotuksen lisäasetukset](/developers/js-client/embed-advanced-options.md).

## Milloin sitä käytetään

Käytä asiakasohjelmaa suoraan, kun sinulla on omat tapahtumasivut ja haluat oman "Osta liput" -painikkeesi avaavan Entase-kassan:

```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>
```

Siinä on koko integraatio. Kaikki muu tässä osiossa on hienosäätöä: mitä asetuksia on käytettävissä, miten kassa valitsee paneelin ja ponnahdusikkunan välillä sekä mitä tapahtumia voit kuunnella.

## Kaksi kassatilaa

Kassa avautuu kahdella tavalla:

- **Paneeli** – sivunsisäinen paneeli, joka liukuu työpöydällä sisään oikealta ja mobiilissa alhaalta. Kävijä ei koskaan poistu sivustoltasi.
- **Ponnahdusikkuna** – erillinen selainikkuna.

Paneelitila tarjoaa paremman käyttökokemuksen, mutta se on käytettävissä vain verkkotunnuksille, jotka olet lisännyt luotetuiksi alkuperiksi Entase-asetuksissasi. Asiakasohjelma tunnistaa, kumpaa se saa käyttää, ja siirtyy ponnahdusikkunaan, kun sivunsisäinen kassa ei ole sallittu. Tämä on ehdottomasti tärkein toiminta, joka on hyvä ymmärtää ennen integrointia – katso [Kassatilat](/developers/js-client/checkout-modes.md).

## Vaatimukset

- **HTTPS**-protokollalla tarjoiltu sivu. Tavallisella HTTP:llä asiakasohjelma käyttää aina ponnahdusikkunaa.
- Verkkotunnuksesi lisättynä **luotettuihin alkuperiin** kohdassa Asetukset → Integraatiot, jos haluat käyttää sivunsisäistä kassaa. Katso [Integraatiot ja kassan mukauttaminen](/organizers/settings/integrations-and-checkout-customization.md).
- Ei rakennusvaihetta, niputtajaa tai paketinhallintaa. Kirjasto on yksi script-tunniste.

## Minne seuraavaksi

- [Asiakasohjelman asentaminen](/developers/js-client/installing-the-client.md) – komentosarjan lataaminen ja instanssin luominen.
- [Konstruktorin asetukset](/developers/js-client/constructor-options.md) – kaikki asetukset ja niiden oletusarvot.
- [Kassan avaaminen](/developers/js-client/opening-the-checkout.md) – `book()`-metodi ja kutsukohtaiset ohitukset.
- [Tapahtumat](/developers/js-client/events.md) – reagointi kassan avautumiseen, sulkeutumiseen ja valmistumiseen.