Asyntai AI -chatbotin lisääminen Backdrop CMS:ään

Vaiheittainen opas Backdrop CMS -verkkosivustoille

Alusta:

Vaihe 1: Hanki upotuskoodisi

Siirry ensin Asyntai-hallintapaneeliin ja vieritä alas "Upotuskoodi"-osioon. Kopioi yksilöllinen upotuskoodisi, joka näyttää tältä:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Huomautus: Yllä oleva koodi on vain esimerkki. Sinun on kopioitava oma yksilöllinen upotuskoodisi Hallintapaneelistasi, sillä se sisältää henkilökohtaisen widget-tunnuksesi.

Vaihe 2: Lisää teemamalliin (Suositeltu)

Backdrop CMS käyttää teemoissaan .tpl.php-mallitiedostoja. Suositeltu tapa on lisätä upotuskoodi suoraan aktiivisen teemasi sivumalliin:

Käytä Backdrop CMS -asennustasi FTP:n tai tiedostonhallinnan kautta
Siirry aktiivisen teemasi hakemistoon: themes/yourtheme/
Avaa page.tpl.php-tiedosto (tai layout.tpl.php teemastasi riippuen)
Etsi sulkeva </body>-tagi tai rivi <?php print $page_bottom; ?>
Liitä Asyntai-upotuskoodisi juuri ennen kyseistä riviä
Tallenna tiedosto

<!-- Asyntai AI Chatbot -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
<?php print $page_bottom; ?>
</body>

Vinkki: Koodin sijoittaminen juuri ennen <?php print $page_bottom; ?> tai sulkevaa </body>-tagia varmistaa, että chatbot latautuu sivun sisällön jälkeen, mikä parantaa sivun latausnopeutta. Tämä menetelmä lisää chatbotin automaattisesti jokaiselle tätä teemaa käyttävälle sivulle.

Vaihtoehtoinen tapa 1: Mukautetun moduulin käyttö

Voit luoda yksinkertaisen Backdrop CMS -moduulin, joka lisää chatbot-skriptin käyttämällä backdrop_add_js():

Luo moduulihakemisto: modules/custom/asyntai_widget/
Luo moduulitiedosto asyntai_widget.module seuraavalla koodilla:
// modules/custom/asyntai_widget/asyntai_widget.module function asyntai_widget_init() { backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array( 'type' => 'external', 'scope' => 'footer', 'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'), )); }
Luo asyntai_widget.info-tiedosto:
name = Asyntai AI Chatbot Widget description = Adds the Asyntai AI chatbot widget to all pages. backdrop = 1.x package = Custom type = module
Siirry Functionality-osioon (admin/modules) Backdrop-hallintapaneelissasi
Etsi "Asyntai AI Chatbot Widget" Custom-paketin alta ja ota se käyttöön
Napsauta "Save configuration"

Huomautus: Korvaa YOUR_WIDGET_ID moduulikoodissa todellisella widget-tunnuksellasi Asyntai-hallintapaneelista. Mukautettu moduuli on päivitysturvallinen eikä sitä ylikirjoiteta teemaa päivitettäessä.

Vaihtoehtoinen tapa 2: Backdropin "Add to Head" -moduulin käyttö

Yhteisön "Add to Head" -moduuli tarjoaa helpon tavan lisätä skriptejä ilman koodin muokkaamista:

Lataa ja asenna "Add to Head" -yhteisömoduuli Backdrop CMS -verkkosivustolta
Siirry kohtaan Configuration > Development > Add to Head
Lisää Asyntai-upotuskoodisi alatunniste-osioon
Napsauta "Save configuration"

Vinkki: "Add to Head" -moduulin käyttö on helpoin tapa, jos et halua muokata teematiedostoja tai luoda mukautettuja moduuleja. Se tarjoaa yksinkertaisen hallintakäyttöliittymän lisättyjen skriptien hallintaan.

Vaihtoehtoinen tapa 3: Lohkojärjestelmän käyttö

Backdrop CMS:n asettelu- ja lohkojärjestelmää voidaan myös käyttää chatbotin lisäämiseen:

Kirjaudu Backdrop CMS -hallintapaneeliin
Siirry kohtaan Structure > Layouts
Valitse muokattava asettelu (esim. oletusasettelu)
Napsauta "Add block" alatunnistealueella
Valitse "Custom block"
Aseta lohkon muodoksi "Full HTML" tai "Raw HTML"
Liitä Asyntai-upotuskoodisi lohkon sisältöön
Anna lohkolle otsikko (esim. "Asyntai Chatbot") ja valinnaisesti valitse "Hide title"
Napsauta "Save block" ja sitten "Save layout"

Tärkeää: Varmista, että tekstimuodoksi on asetettu "Full HTML" tai "Raw HTML", jotta script-tagia ei poisteta. Oletus "Filtered HTML" -muoto poistaa script-tagit turvallisuussyistä.

Vaihe 3: Tyhjennä välimuisti ja vahvista

Muutosten tekemisen jälkeen tyhjennä Backdrop CMS:n välimuisti ja vahvista asennus:

Siirry kohtaan Configuration > Performance hallintapaneelissasi
Napsauta "Clear all caches"
Avaa verkkosivustosi uudessa selainvälilehdessä tai incognito-ikkunassa
Chat-widget-painikkeen pitäisi näkyä oikeassa alakulmassa
Napsauta sitä varmistaaksesi, että se avautuu ja toimii oikein

Etkö näe widgetiä? Varmista, että olet tyhjentänyt Backdrop CMS:n välimuistin kohdassa Configuration > Performance. Kokeile tarkastella sivustoasi incognito-ikkunassa tai tyhjennä selaimen välimuisti. Avaa selaimen konsoli (F12) tarkistaaksesi mahdolliset JavaScript-virheet. Jos käytit mukautettua moduulia, varmista että moduuli on käytössä Functionality-kohdassa.