Zpět na přehled

Dokumentace

Naučte se používat Asyntai

Jak přidat Asyntai AI chatbota na ExpressionEngine

Podrobný návod pro ExpressionEngine CMS

Získat kód pro vložení

Krok 1: Získejte svůj vkládací kód

Nejprve přejděte na svůj Asyntai Dashboard a přejděte dolů k sekci „Embed Code". Zkopírujte svůj unikátní kód pro vložení, který bude vypadat takto:

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

Poznámka: Kód výše je pouze příklad. Musíte zkopírovat svůj vlastní unikátní kód pro vložení z vašeho Dashboardu, protože obsahuje vaše osobní ID widgetu.

Krok 2: Přidání do rozložení šablony (doporučeno)

Nejjednodušší způsob, jak přidat chatbota na všechny stránky, je úprava hlavní šablony rozložení v ovládacím panelu ExpressionEngine:

  1. V ovládacím panelu EE přejděte na Developer > Templates > Template Groups
  2. Otevřete hlavní skupinu šablon (obvykle "site") a upravte šablonu rozložení (nebo šablonu, která obaluje všechny stránky)
  3. Najděte uzavírací značku </body>
  4. Vložte svůj Asyntai embed kód těsně před značku </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 šablonu

Tip: Přidání skriptu před uzavírací značku </body> zajistí, že se načte po obsahu stránky, což je doporučeno pro chatovací widgety a nezpomalí načítání stránky.

Alternativní metoda 1: Použití částečných šablon EE

Částečné šablony ExpressionEngine vám umožňují vytvářet opakovaně použitelné fragmenty, které lze zahrnout do různých šablon:

  1. Přejděte na Developer > Templates > Template Partials
  2. Klikněte na "New" pro vytvoření nové částečné šablony s názvem _asyntai_widget
  3. Vložte váš Asyntai embed kód do obsahu částečné šablony:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  4. Uložte částečnou šablonu
  5. Zahrňte ji do šablony rozložení těsně před uzavírací značku </body>:
    {embed="_asyntai_widget"} </body>

Poznámka: Použití částečných šablon udržuje váš kód organizovaný a umožňuje snadno aktualizovat embed kód chatbota na jednom místě pro celý web.

Alternativní metoda 2: Použití HTML záhlaví/zápatí EE

Některá nastavení ExpressionEngine poskytují globální sekci zápatí pro přidávání skriptů:

  1. Přejděte na Settings > Content & Design > Global Template Preferences
  2. Pokud vaše nastavení EE má globální sekci zápatí, vložte tam Asyntai embed kód
  3. Pokud není k dispozici globální sekce zápatí, upravte přímo hlavní šablonu rozložení a přidejte embed kód před uzavírací značku </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 změny

Alternativní metoda 3: Použití config.php

Pro pokročilé uživatele můžete skript chatbota vložit přes konfiguraci ExpressionEngine nebo vytvořením vlastního doplňku:

  1. Přistupte k souborům projektu ExpressionEngine přes FTP, SSH nebo váš editor kódu
  2. Přejděte do adresáře system/user/config/ a otevřete config.php
  3. Pro vlastní vložení JavaScriptu zvažte vytvoření jednoduchého doplňku/rozšíření EE, které se napojí na hák template_post_parse pro vložení skriptů při vykreslení 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. Nahraďte YOUR_WIDGET_ID skutečným ID widgetu z dashboardu

Důležité: Metoda config.php a doplňků je určena pro pokročilé uživatele se zkušenostmi s vývojem v ExpressionEngine. Pro většinu uživatelů se doporučuje metoda šablony rozložení (Krok 2) nebo metoda částečných šablon (Alternativní metoda 1).

Krok 3: Ověřte instalaci

Po uložení změn navštivte svůj web ExpressionEngine v nové záložce prohlížeče nebo v anonymním okně. V pravém dolním rohu byste měli vidět tlačítko chatovacího widgetu. Klikněte na něj a ověřte, že se správně otevírá a funguje.

Nevidíte widget? Ujistěte se, že jste šablonu uložili a že upravujete správnou šablonu rozložení, kterou vaše stránky používají. Vymažte mezipaměť prohlížeče nebo web zobrazte v anonymním okně. Pokud je povoleno cachování šablon ExpressionEngine, vymažte mezipaměť z ovládacího panelu pod Developer > Utilities > Cache Manager.