Takaisin hallintapaneeliin

Dokumentaatio

Opi käyttämään Asyntai

Asyntai AI -chatbotin lisääminen ExpressionEngine-alustalle

Vaiheittainen opas ExpressionEngine CMS:lle

Hae upotuskoodi

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ää mallipohjaan (suositeltu)

Helpoin tapa lisätä chatbot kaikille sivuille on muokata pääasettelumallia ExpressionEnginen ohjauspaneelissa:

  1. Siirry EE-ohjauspaneelissa kohtaan Developer > Templates > Template Groups
  2. Avaa päämalliryhmä (yleensä \"site\") ja muokkaa asettelumallia (tai mallia, joka käärii kaikki sivut)
  3. Etsi sulkeva </body>-tagi
  4. Liitä Asyntai-upotuskoodisi juuri ennen </body>-tagia:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. Tallenna malli

Vinkki: Skriptin lisääminen ennen sulkevaa </body>-tagia varmistaa, että se latautuu sivun sisällön jälkeen, mikä on suositeltavaa chat-widgeteille eikä hidasta sivun latautumista.

Vaihtoehtoinen tapa 1: EE Template Partials -ominaisuuden käyttö

ExpressionEnginen Template Partials -ominaisuus mahdollistaa uudelleenkäytettävien koodinpätkien luomisen, joita voi sisällyttää eri malleihin:

  1. Siirry kohtaan Developer > Templates > Template Partials
  2. Napsauta \"New\" luodaksesi uuden partialin nimeltä _asyntai_widget
  3. Liitä Asyntai-upotuskoodisi partialin sisältöön:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  4. Tallenna partiaali
  5. Sisällytä se asettelumalliin juuri ennen sulkevaa </body>-tagia:
    {embed="_asyntai_widget"} </body>

Huomautus: Template Partials -ominaisuuden käyttö pitää koodisi järjestyksessä ja helpottaa chatbotin upotuskoodin päivittämistä yhdestä paikasta koko sivustollesi.

Vaihtoehtoinen tapa 2: EE:n HTML-ylä-/alatunnisteen käyttö

Joissakin ExpressionEngine-asennuksissa on yleinen alatunnisteosio skriptien lisäämiseen:

  1. Siirry kohtaan Settings > Content & Design > Global Template Preferences
  2. Jos EE-asennuksessasi on yleinen alatunnisteosio, liitä Asyntai-upotuskoodi sinne
  3. Jos yleistä alatunnisteosiota ei ole käytettävissä, muokkaa pääasettelumallia suoraan ja lisää upotuskoodi ennen sulkevaa </body>-tagia:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  4. Tallenna muutoksesi

Vaihtoehtoinen tapa 3: config.php-tiedoston käyttö

Edistyneet käyttäjät voivat lisätä chatbot-skriptin ExpressionEnginen konfiguraation kautta tai luomalla mukautetun lisäosan:

  1. Pääse käsiksi ExpressionEngine-projektitiedostoihisi FTP:n, SSH:n tai koodieditorisi kautta
  2. Siirry system/user/config/-hakemistoon ja avaa config.php
  3. Mukautettua JavaScript-lisäystä varten harkitse yksinkertaisen EE-lisäosan/laajennuksen luomista, joka kiinnittyy template_post_parse-hookiin skriptin lisäämiseksi sivun renderöinnin yhteydessä:
    // In your custom extension public function template_post_parse($final_template, $is_partial, $site_id) { $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>'; $final_template = str_replace('</body>', $script . '</body>', $final_template); return $final_template; }
  4. Korvaa YOUR_WIDGET_ID todellisella widget-tunnuksellasi hallintapaneelista

Tärkeää: Config.php- ja lisäosatapa on tarkoitettu edistyneille käyttäjille, jotka ovat perehtyneet ExpressionEngine-kehitykseen. Useimmille käyttäjille suositellaan mallipohja-tapaa (vaihe 2) tai Template Partials -tapaa (vaihtoehtoinen tapa 1).

Vaihe 3: Vahvista asennus

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

Etkö näe widgetiä? Varmista, että tallensit mallin ja muokkaat oikeaa asettelumallia, jota sivusi käyttävät. Tyhjennä selaimen välimuisti tai katso sivua incognito-ikkunassa. Jos ExpressionEnginen mallien välimuisti on käytössä, tyhjennä välimuisti ohjauspaneelista kohdasta Developer > Utilities > Cache Manager.