Asyntai AI -chatbotin lisääminen OpenCartiin

Vaiheittainen ohje OpenCart-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: Alatunnistemallin muokkaus (suositeltu)

Yksinkertaisin tapa lisätä chatbot on muokata teemasi alatunnistemallia:

Käytä OpenCart-tiedostojasi FTP:n tai tiedostonhallinnan kautta
Siirry teemasi alatunnistemalliin:
- OpenCart 3.x/4.x: catalog/view/theme/YOUR_THEME/template/common/footer.twig
- OpenCart 2.x: catalog/view/theme/YOUR_THEME/template/common/footer.tpl
Avaa alatunnistetiedosto muokattavaksi
Etsi sulkeva </body>-tagi
Liitä Asyntai-upotuskoodisi juuri ennen </body>-tagia
Tallenna tiedosto
Tyhjennä OpenCartin välimuisti: Dashboard → sininen rataskuvake (oikeassa yläkulmassa) → Refresh tai poista kansion system/storage/cache/ sisältö

Vinkki: Jos käytät oletusteemaa, polku on catalog/view/theme/default/template/common/footer.twig. Tee aina varmuuskopio ennen mallitiedostojen muokkaamista.

Vaihtoehto: Teeman mukautettu koodi -vaihtoehdon käyttö

Many modern OpenCart themes include a built-in option for custom code:

Kirjaudu sisään OpenCart Admin Panel -hallintapaneeliin
Siirry kohtaan Extensions → Themes (tai Extensions → Extensions → Themes)
Napsauta Edit aktiivisessa teemassasi
Etsi "Custom Code"-, "Footer Scripts"- tai "Custom JavaScript" -osio
Liitä Asyntai-upotuskoodisi
Napsauta "Save"
Tyhjennä välimuisti

Huomautus: Kaikissa teemoissa ei ole tätä vaihtoehtoa. Jos teemassasi ei ole mukautetun koodin kenttiä, käytä mallin muokkausmenetelmää tai asenna laajennus.

Vaihtoehto: Mukautetun koodin laajennuksen käyttö

Voit asentaa ilmaisen laajennuksen OpenCart Marketplace -kauppapaikasta mukautettujen skriptien lisäämiseksi:

Siirry OpenCart Marketplace -kauppapaikkaan
Etsi hakusanoilla "Custom Script", "Header Footer Scripts" tai "Custom Code"
Lataa ja asenna sopiva laajennus
Siirry hallintapaneelissa kohtaan Extensions → Extensions → Modules
Etsi ja asenna mukautetun koodin moduuli
Määritä moduuli ja liitä Asyntai-upotuskoodisi alatunnisteosioon
Tallenna ja tyhjennä välimuisti

Tärkeää: Laajennusten käyttö on suositeltavampaa kuin ydintiedostojen muokkaaminen, koska ne säilyvät OpenCart-päivitysten yli. Suosittuja laajennuksia ovat esimerkiksi "Custom Script in Header & Footer", joka on saatavilla kauppapaikassa.

Vaihtoehto: addScript-metodin käyttö (kehittäjille)

Kehittäjille OpenCart 3.x/4.x tarjoaa ohjelmallisen tavan lisätä skriptejä:

Avaa catalog/controller/common/footer.php
Lisää seuraava rivi ennen kohtaa $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
Data-attribuuttia varten sinun tulee muokata footer.twig-tiedostoa sisällyttämään se manuaalisesti tai lisätä inline-JavaScript skriptiisilmukan jälkeen

Huomautus: Jotta widget toimisi oikein data-attribuutin kanssa, mallimenetelmä on yksinkertaisempi, koska addScript-metodi ei tue mukautettuja attribuutteja suoraan.

Vaihe 3: Vahvista asennus

Kun olet tallentanut muutoksesi ja tyhjäntänyt välimuistin, avaa kauppasi 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ä tyhjännät OpenCartin välimuistin. Siirry hallintapaneeliin, napsauta sinista rataskuvaketta oikeassa yläkulmassa ja napsauta päivityspainikkeita. Kokeile myös tyhjäntää selaimen välimuisti tai katsoa sivua incognito-ikkunassa. Jos muokkasit väärää mallitiedostoa, tarkista, että teemasi käyttää muokkaamaasi tiedostoa.