# Soluzzjoni ta’ problemi

> Il-problemi li jinqalgħu l-aktar spiss meta tintegra l-client – il-checkout inline jaqa’ lura għal pop-up, twieqi mblukkati, containers nieqsa u twissijiet fil-console.

Il-client jirreġistra fil-console tal-browser dak kollu li jirrapporta, bil-prefiss `[Entase API]`. Iftaħ il-console l-ewwel.

## Il-checkout jinfetaħ bħala pop-up minflok bħala panel

Il-kawża tas-soltu, fl-ordni li ta’ min tivverifika:

1. **Id-domain mhuwiex oriġini fdata.** Żidu f’Settings → Integrations, billi tqabbel il-prefiss `www.` li s-sit tiegħek fil-fatt juża – ara [Integrazzjonijiet u personalizzazzjoni tal-checkout](/organizers/settings/integrations-and-checkout-customization.md).
2. **Il-paġna mhijiex servuta fuq HTTPS.** Il-checkout inline qatt ma jintuża fuq paġna mhux sigura.
3. **Ebda ċavetta pubblikabbli.** Mingħajr `pk`, il-client ma jistax jivverifika jekk il-checkout inline huwiex permess, għalhekk jibqa’ b’pop-up.
4. **`book()` tħaddmet kmieni wisq.** Il-verifika tal-permess hija asinkrona, u l-modalità hija pop-up sakemm twieġeb. Checkout miftuħ awtomatikament meta titgħabba l-paġna jista’ jaqbeżha – ara [Modalitajiet tal-checkout](/developers/js-client/checkout-modes.md).
5. **`connect-src` huwa mblukkat mill-Content Security Policy tiegħek**, għalhekk il-verifika qatt ma titlesta. Il-console turi t-talba mblukkata.

`entase.getCheckoutMode()` jirrapporta l-modalità riżolta u huwa l-aktar mod rapidu biex tiddistingwi problemi ta’ konfigurazzjoni minn dawk ta’ ħin.

## "Il-modalità pane checkout attivata għal localhost"

Mistenni waqt l-iżvilupp. Il-client jassumi l-modalità pane fuq `localhost` u `127.0.0.1` sabiex tkun tista’ tiżviluppa bil-layout inline, u jwissi għaliex din l-assunzjoni ma tgħid xejn dwar il-produzzjoni. Żid id-domain reali tiegħek mal-oriġini fdati qabel tniedi.

## Il-pop-up huwa mblukkat

Il-browsers jippermettu li tinfetaħ tieqa biss waqt ġest tal-utent. Sejjaħ `book()` b’mod sinkronu ġewwa l-click handler, mhux wara `await`, `fetch` jew `setTimeout`. Ara [Modalitajiet tal-checkout](/developers/js-client/checkout-modes.md).

## Il-panel jinfetaħ vojt

L-iframe tal-checkout ġie mblukkat. Ħalli `https://www.entase.com` fid-direttiva `frame-src` tal-Content Security Policy tiegħek – ara [Installazzjoni tal-client](/developers/js-client/installing-the-client.md).

## "Entase mhuwiex definit"

L-iskritt ma kienx għadu lesta jgħabbi meta tħaddem il-kodiċi tiegħek. Dan jiġri meta `client.js` jitgħabba b’`async` jew `defer`, jew jitqiegħed wara l-iskritt li jużah. Stenna l-avveniment `entase:ready` – ara [Installazzjoni tal-client](/developers/js-client/installing-the-client.md).

## "Qed tipprova tibbukkja avveniment wara li l-Client ġie meqrud"

`destroy()` ġiet imsejħa fuq l-istanza u ma tistax tibqa’ tintuża. F’applikazzjoni b’paġna waħda, dan normalment ifisser li komponent żarma l-client tiegħu filwaqt li referenza kondiviża baqgħet fis-seħħ. Oħloq istanza ġdida għall-veduta l-ġdida.

## "L-inizjalizzazzjoni tal-frame ta’ Entase falliet. Il-container ma nstabx."

Għall-widget inkorporat biss. Il-kodiċi `obj` fil-konfigurazzjoni ma jaqbilx ma’ ebda element fuq il-paġna. L-id tal-container irid ikun `entase_` segwit mill-istess kodiċi, u jrid jeżisti fid-DOM qabel ma l-widget jiġi inizjalizzat – iċċekkja jekk hemmx żball fit-tajpjar, jew container mogħti aktar tard mill-iskripts tiegħek stess.

## Jaħdem biss l-aħħar event listener

`on()` iżomm callback wieħed għal kull isem ta’ avveniment, u r-reġistrazzjoni ta’ wieħed ieħor tissostitwixxi l-ewwel wieħed. Irreġistra darba u qassam minn ġewwa dak il-callback – ara [Avvenimenti](/developers/js-client/events.md).

## Il-pop-up jinfetaħ fuq l-iskrin ħażin

Il-punt ċentrali jiġi kkalkulat meta tinħoloq l-istanza u ma jiġix aġġornat meta l-viżitatur iċċaqlaq it-tieqa tal-browser. Ikkalkulah mill-ġdid qabel tibbukkja b’`setTopWindowCenter()` – ara [Referenza tal-metodi](/developers/js-client/methods.md).

## Il-parametri tat-traċċar huma nieqsa mill-ordnijiet

Il-client awtonomu ma jaqrax il-URL tal-paġna tiegħek. Għaddi l-parametri int stess f’`tprm` – ara [Traċċar u kunsens](/developers/js-client/tracking-and-consent.md). Innota li `setTracking()` tissostitwixxi l-oġġett kollu minflok ma tgħaqqad miegħu, għalhekk sejħa sussegwenti tista’ tneħħi b’mod sieket parametri preċedenti.