Pārskats

Entase JavaScript klients ir neliela bibliotēka, ko ielādējat no mūsu CDN. Tā jūsu tīmekļa vietnei nodrošina vienu funkciju, ko tā pati nevar veikt: atvērt Entase norēķināšanos uz vietas, lai apmeklētājs varētu iegādāties biļeti, neatstājot lapu, kurā atrodas.

Tas pārvalda paneli vai uznirstošo logu, fonu, lapas ritināšanas bloķēšanu, piekrišanas darbību, lokalizāciju un izsekošanas parametrus. Jūsu kods nosaka, kad atvērt norēķināšanos un kuram pasākumam.

Kas tas nav

Klients nerāda pasākumu sarakstus, datumus, cenas vai pieejamību. Ja vēlaties gatavu logrīku savas programmas rādīšanai, izmantojiet iegulšanas kodus – tos var kopēt un ielīmēt, un tiem nav nepieciešami izstrādes darbi. Skatiet Pasākumu iegulšana savā tīmekļa vietnē.

Tomēr tie nav savstarpēji aizstājami. Iegulšanas logrīks fonā ielādē šo pašu klientu, lai atvērtu norēķināšanos, tāpēc klienta opcijas varat nodot, izmantojot iegulšanas konfigurāciju. Skatiet Papildu iegulšanas opcijas.

Kad to izmantot

Izmantojiet klientu tieši, ja jums ir savas pasākumu lapas un vēlaties, lai jūsu poga "Buy tickets" atver Entase norēķināšanos:

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

Tā ir visa integrācija. Viss pārējais šajā sadaļā ir pilnveidošana: kādas opcijas ir pieejamas, kā norēķināšanās izvēlas starp paneli un uznirstošo logu un kādus notikumus varat klausīties.

Divi norēķināšanās režīmi

Norēķināšanās tiek atvērta vienā no diviem veidiem:

• Panelis – iekļauts panelis jūsu lapā, kas darbvirsmā ieslīd no labās puses, bet mobilajās ierīcēs – no apakšas. Apmeklētājs nekad neatstāj jūsu vietni.
• Uznirstošais logs – atsevišķs pārlūkprogrammas logs.

Paneļa režīms nodrošina labāku pieredzi, taču tas ir pieejams tikai domēniem, ko esat pievienojis kā uzticamas izcelsmes vietnes Entase iestatījumos. Klients nosaka, kuru režīmu tam ir atļauts izmantot, un, ja iekļautā norēķināšanās nav atļauta, izmanto uznirstošo logu. Šī ir vissvarīgākā darbība, kas jāsaprot pirms integrēšanas – skatiet Norēķināšanās režīmi.

Prasības

• Lapa, kas tiek nodrošināta, izmantojot HTTPS. Izmantojot parastu HTTP, klients vienmēr lieto uznirstošo logu.
• Jūsu domēns ir pievienots uzticamajām izcelsmes vietnēm sadaļā Iestatījumi → Integrācijas, ja vēlaties iekļauto norēķināšanos. Skatiet Integrācijas un norēķināšanās pielāgošana.
• Nav nepieciešams būvēšanas solis, komplektētājs vai pakotņu pārvaldnieks. Bibliotēka ir viena skripta taga.

Ko darīt tālāk

• Klienta instalēšana – skripta ielāde un instances izveide.
• Konstruktora opcijas – katra opcija un tās noklusējuma vērtība.
• Norēķināšanās atvēršana – metode book() un katra izsaukuma pārrakstīšanas opcijas.
• Notikumi – reaģēšana uz norēķināšanās atvēršanu, aizvēršanu un pabeigšanu.