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

Vaiheittainen opas Concrete CMS (aiemmin Concrete5) -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ää koodi teeman alatunnisteeseen (Suositeltu)

Paras tapa lisätä chatbot kaikille Concrete CMS -verkkosivustosi sivuille on muokata teemasi alatunnistetiedostoa:

Käytä Concrete CMS -asennustasi FTP:n tai tiedostonhallinnan kautta
Siirry /application/themes/your_theme_name/ -hakemistoon
Etsi ja avaa footer.php-tiedosto (tai vastaava alatunnistemalli)
Etsi rivi, jossa on sulkeva </body>-tagi
Liitä Asyntai-upotuskoodisi juuri ennen </body>-tagia
Tallenna tiedosto ja lataa se takaisin palvelimellesi, jos muokkaat sitä paikallisesti
Tyhjennä Concrete CMS -välimuisti: Hallintapaneeli → Järjestelmä ja asetukset → Tyhjennä välimuisti

Vinkki: Koodin lisääminen ennen 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: HTML-lohko (Helpoin ei-kehittäjille)

Jos et halua muokata teematiedostoja, voit käyttää Concrete CMS:n sisäänrakennettua HTML-lohkoa:

Kirjaudu Concrete CMS -hallintapaneeliin
Siirry sivulle, jolle haluat lisätä chatbotin
Napsauta Edit Page (kynäkuvake työkalupalkissa)
Napsauta Add Block alueella, johon haluat sijoittaa koodin
Hae ja valitse HTML-lohko
Liitä Asyntai-upotuskoodisi HTML-editoriin
Napsauta Add tallentaaksesi lohkon
Napsauta Publish ottaaksesi muutokset käyttöön

Huomautus: HTML-lohkomenetelmä on erinomainen chatbotin lisäämiseen tietyille sivuille. Koko sivuston kattavaa asennusta varten sinun on lisättävä HTML-lohko jokaiselle sivulle tai käytettävä yllä kuvattua teeman alatunnistemenetelmää. Lohkon visuaalinen sijainti ei vaikuta chatbotin näkymispaikkaan - se näkyy silti oikeassa alakulmassa.

Vaihtoehtoinen tapa 2: Teeman header-tiedosto

Voit myös lisätä koodin teemasi header-tiedostoon koko sivuston kattavaa asennusta varten:

Käytä Concrete CMS -tiedostojasi FTP:n tai tiedostonhallinnan kautta
Siirry kohtaan /application/themes/your_theme_name/
Avaa header.php-tiedosto (tai elements/header.php)
Etsi sulkeva </head>-tagi
Liitä Asyntai-upotuskoodi juuri ennen </head>-tagia
Tallenna ja lataa tiedosto palvelimelle
Tyhjennä välimuisti hallintapaneelista

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

Vinkki: Varmista, että sisällytät vaaditut otsikkoelementit käyttämällä <?php View::element('header_required'); ?> header.php-tiedostossasi, jotta Concrete CMS toimii oikein.

Vaihtoehtoinen tapa 3: Mukautettu malli (edistynyt)

Kehittäjille, jotka haluavat enemmän hallintaa, voit luoda mukautetun sivumallin:

Luo uusi sivumallitiedosto kansioon /application/themes/your_theme_name/
Tai kopioi olemassa oleva malli (esim. default.php) ja nimeä se uudelleen
Lisää Asyntai-upotuskoodi mallitiedostoon ennen </body>-tagia
Siirry Concrete CMS -hallintapaneelissa kohtaan Pages & Themes
Napsauta Page Types
Valitse sivutyyppi, jonka kanssa haluat käyttää tätä mallia
Määritä mukautettu mallisi sivutyypille
Kaikki tätä sivutyyppiä käyttävät sivut sisältävät nyt chatbotin

Tärkeää: Varmuuskopioi teematiedostot aina ennen muutosten tekemistä. Testaa muutoksesi ensin testiympäristössä, jos mahdollista. Virheelliset muutokset teematiedostoihin voivat rikkoa sivustosi ulkoasun tai toiminnallisuuden.

Vaihe 3: Vahvista asennus

Kun olet tehnyt muutokset ja tyhjentänyt välimuistin, avaa 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ä olet tyhjentänyt Concrete CMS:n välimuistin (Dashboard → System & Settings → Clear Cache). Kokeile katsella sivustoasi incognito-ikkunassa. Tarkista, että olet tallentanut ja ladannut kaikki tiedostomuutokset. Avaa selaimen konsoli (F12) tarkistaaksesi mahdolliset JavaScript-virheet.