Az Entase-fiókjában létrehozott beágyazási kódok egy kész eseménywidgetet illesztenek az oldalba. Úgy tervezték őket, hogy fejlesztői munka nélkül másolhatók és beilleszthetők legyenek – a létrehozásukról lásd: Események beágyazása a webhelyére.
Ez az oldal ismerteti, milyen beállításokat adhat hozzá ehhez a kódrészlethez, valamint hogyan konfigurálhatja az általa megnyitott pénztárat.
A widget maga tölti be a JavaScript-klienst, ezért nem kell mellé hozzáadnia a client.js fájlt. Közzétehető kulcsra sincs szüksége: a widgetet az Entase szolgáltatja, így a pénztár hitelesítése a widgeten keresztül történik, nem az oldalán lévő kulccsal.
Konfiguráció
Minden widget egy beállítási objektummal konfigurálható:
<div id="entase_OBJ_CODE"></div>
<script>
window.entase = window.entase || { o: [] };
window.entase.o.push({
obj: 'OBJ_CODE',
theme: 'dark',
ext: true
});
</script>
<script src="https://js.entase.com/embed.js" async></script>Az obj a konfigurációt a tárolójához köti: a widget abba az elembe jelenik meg, amelynek azonosítója entase_, majd ugyanaz a kód követi. Ha ez az elem hiányzik, a widget figyelmeztetést naplóz, és nem jelenít meg semmit.
Ha több widgetet szeretne elhelyezni egy oldalon, widgetenként adjon hozzá egy bejegyzést.
| Név | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
obj | string | — | A beágyazási kódrészlet objektumkódja. Kötelező. |
width | string | 'auto' | A tároló szélessége CSS-értékként. Az 'auto' teljes szélességet jelent. |
height | string | 'auto' | A tároló magassága CSS-értékként. Az 'auto' 200 px-ről indul, és a widget automatikusan átméretezi magát, hogy illeszkedjen a tartalmához. |
theme | string | 'light' | 'light' vagy 'dark'. |
locale | string | 'auto' | A widget nyelve. Az 'auto' az <html> elem lang attribútumát olvassa. |
ext | boolean | false | Kibővített elrendezés – az időpontok fölött hozzáadja az esemény nevét és plakátját. |
attribution | boolean | true | Megjeleníti az Entase hozzárendelési sorát. Az elrejtéséhez állítsa false értékre. |
client | object | {} | A pénztárat megnyitó JavaScript-kliensnek átadott beállítások. |
A tároló a width értékétől függetlenül legalább 200 px szélességet kap; ez alatt a widget nem tud megfelelően elrendeződni.
A pénztár konfigurálása
A client ugyanazokat a beállításokat fogadja el, mint a klienskonstruktor, így a widgetből megnyitott pénztár ugyanúgy formázható és méretezhető, mint az Ön által közvetlenül megnyitott:
window.entase.o.push({
obj: 'OBJ_CODE',
client: {
checkoutMode: 'pane',
pane: { width: '60vw' },
backdrop: true,
backdropColor: '#101014'
}
});A teljes listát lásd: Konstruktorbeállítások.
Két figyelmeztetés. A tprm értékét maga a widget állítja be az oldal URL-jéből (lásd alább), ezért az itt megadott érték felülíródik. Továbbá, ha több widget osztozik egy oldalon, egy klienspéldányt használnak – az utoljára inicializált widget client beállításai lesznek érvényben, ezért az azonos oldalon lévő widgeteknél tartsa ezeket azonosan.
Kampányparaméterek automatikus továbbítása
Az önálló klienssel ellentétben a widget beolvassa az oldala lekérdezési karakterláncát, és az ismert kampányparamétereket továbbítja a widgetnek és a pénztárnak is:
sgm, utm_source, utm_medium, utm_campaign, utm_term, utm_content, utm_id, utm_source_platform, utm_creative_format, fbclid
Ha egy látogató a yoursite.com/concert?utm_source=facebook&sgm=SOCIAL címen érkezik, ez a hozzárendelés további konfiguráció nélkül rögzítésre kerül minden ebből létrejövő rendelésnél. A listán kívüli paramétereket a rendszer figyelmen kívül hagyja – ha saját paramétereket szeretne továbbítani, nyissa meg közvetlenül a pénztárat a klienssel, és állítsa be saját maga a tprm értékét. Lásd: Követés és hozzájárulás.