# Ħarsa ġenerali

> Il-klijent JavaScript ta’ Entase jiftaħ il-checkout mis-sit web tiegħek stess, jew bħala panew inline jew tieqa pop-up, mingħajr ma jibgħat lill-viżitatur għal paġna oħra.

Il-klijent JavaScript ta’ Entase huwa librerija żgħira li tgħabbi mis-CDN tagħna. Jagħti lis-sit web tiegħek funzjoni waħda li ma jistax iwettaq waħdu: **jiftaħ il-checkout ta’ Entase direttament fil-post**, sabiex viżitatur jixtri biljett mingħajr ma jitlaq mill-paġna li jkun fiha.

Jimmaniġġja l-panew jew it-tieqa pop-up, is-saff ta’ sfond, l-imblukkar tal-iskrolljar tal-paġna, il-pass tal-kunsens, il-lokalità u l-parametri tat-traċċar. Il-kodiċi tiegħek jiddeċiedi *meta* jiftaħ il-checkout u *għal liema avveniment*.

## X'mhuwiex

Il-klijent ma jirrendix listi ta’ avvenimenti, dati, prezzijiet jew disponibbiltà. Jekk trid widget lest li juri l-programm tiegħek, uża l-kodiċijiet ta’ inkorporazzjoni minflok – dawk huma sempliċement biex tikkopjahom u twaħħalhom u ma jeħtieġu l-ebda xogħol ta’ żvilupp. Ara [L-inkorporazzjoni ta’ avvenimenti fis-sit web tiegħek](/organizers/sharing-and-embedding/embedding-events-on-your-website.md).

Madankollu, it-tnejn mhumiex alternattivi. Il-widget tal-inkorporazzjoni jgħabbi dan l-istess klijent fl-isfond biex jiftaħ il-checkout tiegħu, u għalhekk tista’ tgħaddi l-għażliet tal-klijent permezz tal-konfigurazzjoni tal-inkorporazzjoni. Ara [Għażliet avvanzati tal-inkorporazzjoni](/developers/js-client/embed-advanced-options.md).

## Meta tużah

Uża l-klijent direttament meta jkollok il-paġni tal-avvenimenti tiegħek stess u trid li l-buttuna "Ixtri biljetti" tiegħek tiftaħ il-checkout ta’ 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>
```

Dik hija l-integrazzjoni kollha. Kull ħaġa oħra f’din it-taqsima hija rfinar: liema għażliet jeżistu, kif il-checkout jiddeċiedi bejn panew u pop-up, u liema avvenimenti tista’ tissorvelja.

## Żewġ modi ta’ checkout

Il-checkout jiftaħ b’wieħed minn żewġ modi:

- **Panew** – panew inline fil-paġna tiegħek, li jiżżerżaq mil-lemin fuq id-desktop u minn isfel fuq il-mowbajl. Il-viżitatur qatt ma jitlaq mis-sit tiegħek.
- **Pop-up** – tieqa separata tal-browser.

Il-mod Panew joffri esperjenza aħjar, iżda huwa disponibbli biss għal dominji li żidt bħala oriġini fdati fis-settings ta’ Entase tiegħek. Il-klijent jidentifika liema mod huwa permess juża u jaqleb għal pop-up meta checkout inline ma jkunx permess. Din hija l-aktar imġiba importanti li għandek tifhem qabel tintegra – ara [Modi ta’ checkout](/developers/js-client/checkout-modes.md).

## Rekwiżiti

- Paġna pprovduta permezz ta’ **HTTPS**. Fuq HTTP sempliċi, il-klijent dejjem juża pop-up.
- Id-dominju tiegħek miżjud ma’ **oriġini fdati** f’Settings → Integrations, jekk trid checkout inline. Ara [Integrazzjonijiet u personalizzazzjoni tal-checkout](/organizers/settings/integrations-and-checkout-customization.md).
- L-ebda pass ta’ build, bundler jew package manager. Il-librerija hija tikketta script waħda.

## Fejn tmur wara

- [L-installazzjoni tal-klijent](/developers/js-client/installing-the-client.md) – it-tagħbija tal-iskritt u l-ħolqien ta’ istanza.
- [Għażliet tal-kostruttur](/developers/js-client/constructor-options.md) – kull għażla u l-valur awtomatiku tagħha.
- [Il-ftuħ tal-checkout](/developers/js-client/opening-the-checkout.md) – il-metodu `book()` u l-override għal kull sejħa.
- [Avvenimenti](/developers/js-client/events.md) – ir-reazzjoni għall-ftuħ, l-għeluq u t-tlestija tal-checkout.