Ako pridat Asyntai AI chatbota do Concrete CMS

Návod krok za krokom pre webove stránky Concrete CMS (predtym Concrete5)

Platforma:

Krok 1: Získajte svoj vkladací kód

Najprv prejdite na svoj Asyntai Dashboard a prejdite nadol k sekcii „Vkladací kód“. Skopírujte svoj jedinečný vkladací kód, ktorý bude vyzerať takto:

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

Poznámka: Kód vyššie je len príklad. Musíte skopírovať svoj vlastný jedinečný vkladací kód zo svojho Dashboardu, pretože obsahuje vaše osobné ID widgetu.

Krok 2: Pridanie kodu do paty temy (odporúčané)

Najlepší sposob pridania chatbota na všetky stránky vasej webovej stránky Concrete CMS je uprava súboru paty vasej temy:

Prístupte k svojej inštalácii Concrete CMS cez FTP alebo Správcu súborov
Prejdite do priečinka /application/themes/nazov_vasej_temy/
Najdite a otvorte súbor footer.php (alebo ekvivalentnu šablónu paty)
Najdite riadok s uzatvaracim tagom </body>
Vložte svoj vkladací kód Asyntai tesne pred tag </body>
Uložte súbor a nahrajte ho spat na vas server, ak upravujete lokalne
Vymažte cache Concrete CMS: Dashboard → System & Settings → Clear Cache

Tip: Pridanie kodu pred uzatvaraci tag </body> zabezpeci, ze sa chatbot nacita po obsahu vasej stránky, co poskytuje lepší výkon nacitania stránky. Tato metoda automaticky prida chatbota na kazdu stránku používajúcu tuto temu.

Alternativna metoda 1: HTML blok (najjednoduchší pre nevyvojarov)

Ak nechcete upravovat súbory temy, môžete pouzit vstavany HTML blok Concrete CMS:

Prihlaste sa do svojho Dashboardu Concrete CMS
Prejdite na stránku, kde chcete pridat chatbota
Kliknite na Edit Page (ikona ceruzky v paneli nástrojov)
Kliknite na Pridat blok v oblasti, kde chcete umiestnit kod
Vyhladajte a vyberte blok HTML
Vložte svoj vkladací kód Asyntai do HTML editora
Kliknite na Pridat na uloženie bloku
Kliknite na Publikovat na zverejnenie zmien

Poznámka: Metoda s HTML blokom je skvela na pridanie chatbota na konkretne stránky. Pre inštaláciu na celom webe budete musiet pridat HTML blok na kazdu stránku, alebo pouzit metodu s patou temy popísanu vyššie. Vizualne umiestnenie bloku nema vplyv na to, kde sa chatbot zobrazi - stale sa zobrazi v pravom dolnom rohu.

Alternativna metoda 2: Súbor hlavičky temy

Kod môžete tiež pridat do súboru hlavičky vasej temy pre inštaláciu na celom webe:

Prístupte k súborom Concrete CMS cez FTP alebo Správcu súborov
Prejdite do /application/themes/nazov_vasej_temy/
Otvorte súbor header.php (alebo elements/header.php)
Najdite uzatvaraci tag </head>
Vložte svoj vkladací kód Asyntai tesne pred tag </head>
Uložte a nahrajte súbor
Vymažte vyrovnávaciu pamat z Dashboardu

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

Tip: Uistite sa, ze ste zahrnuli pozadovane elementy hlavičky pomocou <?php View::element('header_required'); ?> vo vasom subore header.php, aby Concrete CMS fungoval správne.

Alternativna metoda 3: Vlastna šablóna (pokročilé)

Pre vývojárov, ktori chcu väčšiu kontrolu, môžete vytvorit vlastnú šablónu stránky:

Vytvorte novy súbor šablóny stránky v /application/themes/nazov_vasej_temy/
Alebo skopirujte existujucu šablónu (napr. default.php) a premenujte ju
Pridajte svoj vkladací kod Asyntai do súboru šablóny pred </body>
V Dashboarde Concrete CMS prejdite na Stránky a temy
Kliknite na Typy stránok
Vyberte typ stránky, s ktorym chcete pouzit tuto šablónu
Priradte svoju vlastnú šablónu typu stránky
Všetky stránky pouzivajuce tento typ stránky teraz budu obsahovat chatbota

Dôležité: Vzdy si zálohujte súbory temy pred vykonanim zmien. Ak je to možné, najprv otestujte svoje upravy na testovacej stránke. Nespravne upravy súborov temy mozu narusit rozloženie alebo funkčnosť vasej stránky.

Krok 3: Overenie inštalácie

Po vykonani zmien a vymazani vyrovnávacej pamate otvorte svoju webovú stránku v novej karte prehliadača alebo v okne inkognito. Mali by ste vidiet tlačidlo chatoveho widgetu v pravom dolnom rohu. Kliknite nan, aby ste sa uistili, ze sa otvara a funguje správne.

Nevidíte widget? Uistite sa, ze ste vymazali vyrovnávaciu pamat Concrete CMS (Dashboard → System & Settings → Clear Cache). Skuste zobrazit svoj web v okne inkognito. Skontrolujte, ze ste uložili a nahrali všetky zmeny súborov. Otvorte konzolu prehliadača (F12) a skontrolujte pripadne chyby JavaScriptu.