14.2
Widgetin lisääminen sivustolle
Kopioi koodinpätkä widgetin kortista ja liitä se ennen sulkevaa body-tagia jokaiselle sivulle, jolla chat-painikkeen pitää näkyä.
<script src="https://api.ticketsx.xyz/widget.js" data-key="wk_your_key_here" defer></script>Siinä koko asennus. Mitään ei ladata, riippuvuuksia ei tule, ja widget piirtyy shadow rootin sisään, joten se ei voi törmätä omiin tyyleihisi. Se toimii pelkässä HTML:ssä, WordPressissä, Shopifyssa, Webflow'ssa ja missä tahansa JavaScript-kehyksessä.
Valinnaiset attribuutit
| Nimi | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| data-key | string | pakollinen | Widgetin julkinen avain. Kopioi se hallintapaneelista. |
| data-position | left | right | valinnainen | Missä kulmassa painike on. Ohittaa hallintapaneelin asetuksen. |
| data-theme | auto | light | dark | valinnainen | Vaalea tai tumma ikkuna. Oletus seuraa kävijän järjestelmäasetusta. |
| data-locale | string | valinnainen | Pakottaa kielen, esimerkiksi de tai pt-BR. Oletus seuraa selainta. |
| data-launcher | auto | manual | valinnainen | Aseta manual, niin kelluva painike piilotetaan ja avaat chatin omalla elementilläsi. |
Chatin avaaminen omalla painikkeella
Kun data-launcher on manual, widget pysyy näkymättömänä kunnes pyydät sitä.
<script src="https://api.ticketsx.xyz/widget.js" data-key="wk_your_key_here" data-launcher="manual" defer></script>
<button onclick="TicketsXChat.open()">Contact support</button>- TicketsXChat.open() avaa ikkunan.
- TicketsXChat.close() ja TicketsXChat.toggle() tekevät juuri sen mitä nimi lupaa.
- TicketsXChat.isOpen() kertoo, onko ikkuna auki.
- TicketsXChat.on('message', handler) laukeaa, kun tiimisi vastaus saapuu.