Späť na panel

Dokumentácia

Naučte sa používať Asyntai

Ako pridať Asyntai AI chatbota do ExpressionEngine

Návod krok za krokom pre ExpressionEngine CMS

Získať vkladací kód

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 do šablóny rozloženia (odporúčané)

Najjednoduchší sposob pridania chatbota na všetky stránky je uprava vasej hlavnej šablóny rozloženia v ovladacom paneli ExpressionEngine:

  1. V ovladacom paneli EE prejdite na Vyvojar > Šablóny > Skupiny šablón
  2. Otvorte svoju hlavnu skupinu šablón (zvyčajne "site") a upravte šablónu rozloženia (alebo šablónu, ktora obaluje všetky stránky)
  3. Nájdite uzatvárací tag </body>
  4. Vložíte svoj vkladací kod Asyntai tesne pred tag </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. Uložte šablónu

Tip: Pridanie skriptu pred uzatvaraci tag </body> zabezpeci, ze sa nacita po obsahu stránky, co je odporúčané pre chatove widgety a nespomalí nacitanie vasej stránky.

Alternativna metoda 1: Použitie ciastocnych šablón EE

Ciastocne šablóny ExpressionEngine vam umoznuju vytvarat opakovane pouzitelne fragmenty, ktore možno zahrnút naprieč šablónami:

  1. Prejdite na Vyvojar > Šablóny > Ciastocne šablóny
  2. Kliknite na "Novy" na vytvorenie novej ciastocnej šablóny s názvom _asyntai_widget
  3. Vložte svoj vkladací kód Asyntai do obsahu čiastočnej šablóny:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  4. Uložte ciastocnu šablónu
  5. Zahrnte ju do vasej šablóny rozloženia tesne pred uzatvaracim tagom </body>:
    {embed="_asyntai_widget"} </body>

Poznámka: Použitie ciastocnych šablón udrzuje vas kod organizovany a uľahcuje aktualizaciu vkladacieho kodu chatbota na jednom mieste na celom vasom webe.

Alternativna metoda 2: Použitie HTML hlavičky/paty EE

Niektore nastavenia ExpressionEngine poskytuju globalnu sekciu paty na pridávanie skriptov:

  1. Prejdite na Nastavenia > Obsah a dizajn > Globalne predvolby šablón
  2. Ak vase nastavenie EE ma globalnu sekciu paty, vložíte tam vkladací kod Asyntai
  3. Ak nie je dostupna ziadna globalna sekcia paty, upravte priamo svoju hlavnu šablónu rozloženia a pridajte vkladací kod pred uzatvaraci tag </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  4. Uložte vase zmeny

Alternativna metoda 3: Použitie config.php

Pre pokročilých pouzivatelov môžete vlozit skript chatbota cez konfiguráciu ExpressionEngine alebo vytvorenim vlastného doplnku:

  1. Prístupte k súborom vasho projektu ExpressionEngine cez FTP, SSH alebo vas editor kodu
  2. Prejdite do priečinka system/user/config/ a otvorte config.php
  3. Pre vlastné vkladanie JavaScriptu zvazite vytvorenie jednoducheho doplnku/rozsirenia EE, ktore sa napoji na hook template_post_parse na vloženie skriptu pri vykresleni stránky:
    // 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. Nahradte YOUR_WIDGET_ID vasim skutocnym ID widgetu z dashboardu

Dôležité: Metoda s config.php a doplnkom je urcena pre pokročilých pouzivatelov, ktori su obeznámení s vyvojom ExpressionEngine. Pre vacsinu pouzivatelov sa odporúča metoda šablóny rozloženia (Krok 2) alebo metoda ciastocnych šablón (Alternativna metoda 1).

Krok 3: Overenie inštalácie

Po uložení vasich zmien navštívte svoju webovú stránku ExpressionEngine 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 uložili šablónu a ze upravujete spravnu šablónu rozloženia, ktoru pouzivaju vase stránky. Vymažte vyrovnávaciu pamat prehliadača alebo zobrazite web v okne inkognito. Ak je povolene ukladanie šablón ExpressionEngine do vyrovnávacej pamate, vymažte vyrovnávaciu pamat z ovladacieho panelu v casti Vyvojar > Nastroje > Správca vyrovnávacej pamate.