# Modalitajiet tal-checkout

> Kif il-klijent jagħżel bejn il-pannell integrat u tieqa pop-up, għaliex l-oriġnijiet fdati jiddeterminaw dan, u x'għandek tistenna waqt l-iżvilupp lokali.

Il-checkout jinfetaħ f'waħda minn żewġ modalitajiet.

**Pannell** huwa pannell integrat muri ġewwa l-paġna tiegħek. Fuq desktop jiżżerżaq 'il ġewwa mil-lemin, b'wisa' massima ta' `pane.width`; fuq il-mowbajl jiżżerżaq 'il fuq minn isfel. Il-viżitatur jibqa' fis-sit tiegħek, u l-pannell jingħalaq meta jagħfas Escape jew jikklikkja ż-żona mudlama.

**Pop-up** hija tieqa separata tal-browser, iċċentrata fuq l-iskrin tal-viżitatur. Il-klijent josserva jekk it-tieqa tingħalaqx sabiex ikun jista' jneħħi l-overlay.

## Il-checkout integrat jeħtieġ oriġini fdata

Il-modalità tal-pannell turi l-checkout ta' Entase f'iframe fuq id-dominju tiegħek, għalhekk hija permessa biss għal dominji li awtorizzajt espliċitament. Żid kull dominju li jiftaħ il-checkout ma' **Oriġnijiet fdati** f'Settings → Integrations – ara [Integrazzjonijiet u personalizzazzjoni tal-checkout](/organizers/settings/integrations-and-checkout-customization.md).

Jimporta jekk il-prefiss `www.` huwiex inkluż. Jekk m'intix ċert liema forma juża s-sit tiegħek, żid it-tnejn.

Jekk id-dominju tiegħek mhuwiex fil-lista, il-checkout xorta jaħdem – sempliċement jinfetaħ bħala tieqa pop-up.

## Kif jiġi deċiż `'auto'`

Bl-inadempjenza `checkoutMode: 'auto'`, il-klijent jiddeċiedi f'din l-ordni:

1. **Mhux HTTPS** → pop-up. Il-checkout integrat qatt ma jintuża f'paġna mhux sigura.
2. **`localhost` jew `127.0.0.1`** → pannell, b'twissija rreġistrata fil-console. Din hija konvenjenza għall-iżvilupp sabiex tkun tista' tibni bil-layout integrat; ma tgħid xejn dwar jekk id-dominju tal-produzzjoni tiegħek huwiex permess.
3. **Inkella** → il-klijent jistaqsi lil Entase jekk din l-oriġini tistax tuża checkout integrat, u jibgħat `pk` biex jidentifika l-kont. Jekk it-tweġiba tinkludi pane, il-modalità ssir pane.

Sakemm tasal dik it-tweġiba, il-modalità hija **popup**. Din hija l-imġiba li l-aktar x'aktarx tissorprendik: il-verifika hija asinkrona, għalhekk sejħa `book()` li ssir immedjatament meta titgħabba l-paġna – qabel ma l-viżitatur ikollu ċ-ċans jikklikkja xi ħaġa – xorta tista' tiftaħ pop-up fuq dominju kkonfigurat perfettament. Fil-prattika, klikk vera dejjem tasal ħafna wara li l-verifika tkun tlestiet. Jekk tiftaħ il-checkout awtomatikament, impona l-modalità minflok toqgħod fuq id-detezzjoni.

## Imponi modalità

Issettja `checkoutMode` espliċitament biex taqbeż id-detezzjoni għalkollox:

```js
const entase = new Entase({ pk: 'YOUR_PUBLISHABLE_KEY', checkoutMode: 'popup' });
```

Jew ibdilha għal prenotazzjoni waħda:

```js
entase.book('EVENT_ID', { checkoutMode: 'popup' });
```

Li timponi `'pane'` fuq dominju li mhuwiex oriġini fdata ma jagħtix permess – il-pannell jinfetaħ, iżda l-checkout ġewwa fih ma jistax jikkomunika mal-paġna tiegħek. Uża `'popup'` bħala għażla intenzjonata, u ħalli `'auto'` kif inhu meta trid checkout integrat kull fejn huwa permess.

Valur mhux rikonoxxut jiġi injorat u ttrattat bħala `'auto'`.

## Qari u tibdil tal-modalità waqt it-tħaddim

```js
entase.getCheckoutMode();        // 'pane' or 'popup' — never 'auto'
entase.setCheckoutMode('popup'); // applies to every later book() call
```

`getCheckoutMode()` jirritorna l-modalità *riżolta*, għalhekk jirrapporta x'se jiġri fil-fatt. L-issettjar tal-modalità lura għal `'auto'` jerġa' jwettaq id-detezzjoni.

## Imblokkaturi tal-pop-up

Il-browsers jippermettu `window.open()` biss waqt ġest tal-utent. Sejjaħ `book()` direttament ġewwa handler ta' klikk – mhux wara `await`, `fetch`, jew `setTimeout`, sa liema punt il-ġest ikun skada u l-pop-up jiġi mblukkat.

```js
// Blocked: the gesture is gone by the time book() runs.
button.addEventListener('click', async () => {
  const event = await fetch('/api/current-event').then(r => r.json());
  entase.book(event.id);
});

// Fine: resolve the id first, open on the click.
button.addEventListener('click', () => entase.book(button.dataset.eventId));
```

Dan jaffettwa biss il-modalità pop-up. Il-modalità pannell tibni element fil-paġna u mhijiex soġġetta għal dan.