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

Vaiheittainen ohje October 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ää layout-malliin (suositeltu)

Suositeltu tapa lisätä chatbot on muokata oletuslayoutia October CMS -hallintapaneelissa:

Kirjaudu sisään October CMS -hallintapaneeliin
Siirry päävalikossa kohtaan CMS > Layouts
Avaa oletuslayoutisi (yleensä default.htm)
Etsi sulkeva </body> tagi ja {% scripts %} paikkamerkki
Lisää Asyntai-upotuskoodisi juuri ennen {% scripts %} ja </body>:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
Napsauta "Save" ottaaksesi muutokset käyttöön

Vinkki: Placing the script before {% scripts %} and </body> ensures it loads after the page content, which is recommended for chat widgets and won't slow down your page loading.

Alternative Method 1: Using {% put scripts %} Block

Voit käyttää October CMS:n scripts-paikkamerkkiä lisätäksesi chatbotin sivulta tai partialista:

Avaa mikä tahansa sivu tai partial CMS-editorissa
Lisää seuraava koodi käyttämällä {% put scripts %} lohko:
{% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
Korvaa YOUR_WIDGET_ID todellisella widget-tunnuksellasi hallintapaneelista
Napsauta "Save"

Huomautus: For this method to work, your layout must include the {% scripts %} placeholder in its markup. This is where October CMS renders all injected scripts. Most default layouts already include this tag.

Vaihtoehtoinen menetelmä 2: Component PHP:n käyttö

Jos suosit ohjelmallista lähestymistapaa, voit lisätä chatbot-skriptin mukautetun komponentin kautta:

Luo tai muokkaa komponenttia October CMS -lisäosassasi
Komponentin onRun()-metodissa käytä addJs()-metodia:
public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
Korvaa YOUR_WIDGET_ID todellisella widget-tunnuksellasi
Rekisteröi komponentti sivuille, joilla haluat chatbotin näkyvän

Vinkki: Komponentin käyttö antaa sinulle ohjelmallisen hallinnan siihen, milloin ja missä chatbot latautuu. Voit lisätä ehdollista logiikkaa onRun()-metodin sisälle hallitaksesi latausta käyttäjäroolien, sivutyyppien tai muiden kriteerien perusteella.

Vaihtoehtoinen menetelmä 3: Partialin käyttö

Voit luoda uudelleenkäytettävän partialin chatbot-widgetille:

Siirry päävalikossa kohtaan CMS > Partials
Napsauta "+ Add" luodaksesi uuden partialin
Nimeä se asyntai-widget.htm
Lisää Asyntai-upotuskoodisi partialiin:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Napsauta "Save"
Avaa layout-mallisi ja sisällytä partial ennen </body>-tagia:
{% partial 'asyntai-widget' %}
Tallenna layout

Vinkki: Partialin käyttö tekee chatbotin käyttöönotosta tai poistamisesta helppoa koko sivustollasi yksinkertaisesti lisäämällä tai poistamalla partial-sisällytys layoutistasi.

Vaihe 3: Vahvista asennus

Kun olet tallentanut muutoksesi, avaa October CMS -verkkosivustosi uudessa selaimen välilehdessä tai incognito-ikkunassa. Chat-widgetin painikkeen pitäisi näkyä oikeassa alakulmassa. Napsauta sitä varmistaaksesi, että se avautuu ja toimii oikein.

Etkö näe widgetiä? Varmista, että olet tallentanut kaikki muutokset CMS-hallintapaneelissa. Tyhjennä selaimen välimuisti tai katso sivua incognito-ikkunassa. Jos sivustosi käyttää välimuistia, tyhjennä October CMS:n välimuisti suorittamalla php artisan cache:clear komentorivilta tai käytä Settings > System > Clear Cache -vaihtoehtoa hallintapaneelissa.

Layoutin valinta: Varmista, että sivut, joilla haluat chatbotin näkyvän, käyttävät oikeaa layoutia. Voit tarkistaa, mitä layoutia sivu käyttää, avaamalla sivun kohdasta CMS > Pages ja katsomalla Layout-pudotusvalikkoa sivun asetuksissa.