# Speciális beágyazási beállítások

> A beágyazási widget a másolható kódrészletben szereplőknél több konfigurációs lehetőséget is elfogad, többek között a megnyitott pénztárhoz továbbított kliensbeállításokat.

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](/organizers/sharing-and-embedding/embedding-events-on-your-website.md).

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ó:

```html
<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:

```js
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](/developers/js-client/constructor-options.md).

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](/developers/js-client/tracking-and-consent.md).
