Modalitajiet tal-checkout

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.

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:

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

Jew ibdilha għal prenotazzjoni waħda:

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

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.

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