Kódy na vloženie vygenerované vo vašom účte Entase vložia na stránku pripravený widget udalosti. Sú navrhnuté tak, aby ste ich mohli skopírovať a vložiť bez potreby vývojárskych prác – postup získania nájdete v článku Vloženie udalostí na váš web.
Táto stránka dokumentuje možnosti, ktoré môžete pridať do daného úryvku, a spôsob konfigurácie platby, ktorú otvorí.
Widget si sám načíta klienta JavaScriptu, preto k nemu nepridávate client.js. Nepotrebuje ani publikovateľný kľúč: widget poskytuje Entase, takže platba je autorizovaná prostredníctvom widgetu, a nie kľúča na vašej stránke.
Konfigurácia
Každý widget sa konfiguruje pomocou objektu možností:
<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>obj spája konfiguráciu s jej kontajnerom: widget sa vykreslí do prvku, ktorého id je entase_ nasledované rovnakým kódom. Ak tento prvok chýba, widget zaznamená upozornenie a nič nevykreslí.
Ak chcete na stránku umiestniť viac widgetov, pridajte jednu položku pre každý z nich.
| Názov | Typ | Predvolené | Popis |
|---|---|---|---|
obj | reťazec | – | Kód objektu z vášho úryvku na vloženie. Povinné. |
width | reťazec | 'auto' | Šírka kontajnera ako hodnota CSS. 'auto' znamená plnú šírku. |
height | reťazec | 'auto' | Výška kontajnera ako hodnota CSS. Pri 'auto' sa začína na 200 px a widget automaticky zmení svoju veľkosť tak, aby sa prispôsobil obsahu. |
theme | reťazec | 'light' | 'light' alebo 'dark'. |
locale | reťazec | 'auto' | Jazyk widgetu. 'auto' načíta atribút lang vášho prvku <html>. |
ext | boolean | false | Rozšírené rozloženie – pridá názov udalosti a plagát nad dátumy. |
attribution | boolean | true | Zobrazí riadok s uvedením Entase. Nastavte na false, ak ho chcete skryť. |
client | objekt | {} | Možnosti odovzdané klientovi JavaScriptu, ktorý otvorí platbu. |
Kontajner má minimálnu šírku 200 px bez ohľadu na hodnotu width; pod touto hodnotou widget nemôže správne usporiadať rozloženie.
Konfigurácia platby
client prijíma rovnaké možnosti ako konštruktor klienta, takže platbu otvorenú z widgetu možno štýlovať a meniť jej veľkosť rovnako ako platbu, ktorú otvoríte sami:
window.entase.o.push({
obj: 'OBJ_CODE',
client: {
checkoutMode: 'pane',
pane: { width: '60vw' },
backdrop: true,
backdropColor: '#101014'
}
});Úplný zoznam nájdete v článku Možnosti konštruktora.
Dve upozornenia. tprm nastavuje samotný widget z adresy URL stránky (pozrite nižšie), takže tu odovzdaná hodnota sa nahradí. Ak navyše viaceré widgety zdieľajú jednu stránku, zdieľajú jednu inštanciu klienta – platia možnosti client posledného inicializovaného widgetu, preto ich zachovajte rovnaké vo všetkých widgetoch na tej istej stránke.
Automatické odovzdávanie kampaní
Na rozdiel od samostatného klienta widget číta reťazec dopytu vašej stránky a odovzdáva známe parametre kampane widgetu aj platbe:
sgm, utm_source, utm_medium, utm_campaign, utm_term, utm_content, utm_id, utm_source_platform, utm_creative_format, fbclid
Návštevník, ktorý príde na yoursite.com/concert?utm_source=facebook&sgm=SOCIAL, bude mať toto priradenie zaznamenané pri každej výslednej objednávke bez ďalšej konfigurácie. Parametre mimo tohto zoznamu sa ignorujú – ak chcete prenášať vlastné, otvorte platbu priamo pomocou klienta a nastavte si tprm sami. Pozrite si Sledovanie a súhlas.