Yleiskatsaus

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.

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.

Milloin sitä käytetään

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

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

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.
• Ei rakennusvaihetta, niputtajaa tai paketinhallintaa. Kirjasto on yksi script-tunniste.

Minne seuraavaksi

• Asiakasohjelman asentaminen – komentosarjan lataaminen ja instanssin luominen.
• Konstruktorin asetukset – kaikki asetukset ja niiden oletusarvot.
• Kassan avaaminen – book()-metodi ja kutsukohtaiset ohitukset.
• Tapahtumat – reagointi kassan avautumiseen, sulkeutumiseen ja valmistumiseen.