Jak přidat Asyntai AI chatbota do MODX

Podrobný návod pro weby na platformě MODX CMS

Platforma:

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 šablony MODX (Doporučeno)

Doporučený způsob přidání chatbota je úprava šablony MODX přímo v MODX Manageru:

Přihlaste se do svého MODX Manageru (administrační panel)
V levém postranním panelu přejděte na Elements > Templates
Otevřete šablonu svého webu (obvykle nazvanou "BaseTemplate" nebo vaší aktivní šablonu)
Najděte uzavírací tag </body> v kódu šablony
Vložte svůj vložený kód Asyntai těsně před uzavírací tag </body>
Klikněte na "Uložit" pro uložení šablony

<!-- Your existing template content -->

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

Tip: Přidání kódu těsně před uzavírací tag </body> zajišťuje, že se chatbot načte až po veškerém obsahu stránky, což je doporučené umístění pro chatové widgety a nezpomalí načítání stránky.

Alternativní metoda 1: Použití MODX Chunku

Můžete použít MODX Chunk pro oddělení a znovupoužitelnost vloženého kódu:

V MODX Manageru přejděte na Elements > Chunks
Klikněte na \"New Chunk\" pro vytvoření nového chunku
Pojmenujte chunk "asyntaiWidget"
Vložte svůj vložený kód Asyntai do oblasti obsahu chunku
Klikněte na "Save"
Otevřete svou šablonu (pod Elements > Templates)
Přidejte volání chunku [[$asyntaiWidget]] těsně před uzavírací tag </body>
Uložte šablonu

<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

Tip: Použití Chunku usnadňuje správu a aktualizaci vloženého kódu na jednom místě, zejména pokud na svém webu používáte více šablon.

Alternativní metoda 2: Použití systémových nastavení MODX (HTML hlavička/patička)

Některé konfigurace MODX zahrnují zástupné symboly pro skripty v zápatí přes Systémová nastavení:

V MODX Manageru přejděte na System > System Settings
Filtrujte podle "htmlhead" nebo vyhledejte vlastní systémové nastavení pro skripty v zápatí
Pokud vaše konfigurace má zástupný symbol pro skripty v zápatí (například [[++footer_scripts]]), můžete jej použít
Nastavte hodnotu systémového nastavení na svůj vložený kód Asyntai
Ujistěte se, že odpovídající zástupný symbol [[++footer_scripts]] je přítomen ve vaší šabloně před uzavíracím tagem </body>
Uložte systémové nastavení

<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

Poznámka: Tato metoda závisí na tom, zda vaše konfigurace MODX má vlastní systémové nastavení pro skripty v zápatí. Pokud žádné neexistuje, můžete vytvořit vlastní systémové nastavení a odkazovat na něj ve své šabloně pomocí syntaxe [[++setting_key]].

Alternativní metoda 3: Použití pluginu MODX (OnWebPagePrerender)

Pro pokročilý přístup můžete vytvořit plugin MODX, který automaticky vloží kód chatbota na každou stránku:

V MODX Manageru přejděte na Elementy > Pluginy
Klikněte na "Nový plugin" pro vytvoření nového pluginu
Pojmenujte plugin "AsyntaiChatbot"
Vložte následující PHP kód do oblasti kódu pluginu:

$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);

Klikněte na kartu "Systémové události"
Zaskrtnete pole vedle "OnWebPagePrerender" pro spuštění tohoto pluginu při dané udalosti
Klikněte na "Save"

Důležité: Nahraďte YOUR_WIDGET_ID svým skutečným ID widgetu z Asyntai Dashboard. Tento plugin automaticky vloží skript chatbota na každou stránku vašeho webu MODX před jejím vykreslením.

Krok 3: Vymažte mezipaměť a ověřte

Po přidání vloženého kódu jakoukoli z vyse uvedenych metod je třeba vymazat mezipaměť MODX a ověřit instalaci:

V MODX Manageru přejděte na Správa > Vymazat mezipaměť (nebo klikněte na ikonu vymazání mezipaměti v horním menu)
Otevřete svůj web v nové kartě prohlížeče nebo v anonymním okně
V pravém dolním rohu stránky byste měli vidět tlačítko chatové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 vymazali mezipaměť MODX z Správa > Vymazat mezipaměť v MODX Manageru. Zkuste také vymazat mezipaměť prohlížeče nebo web zobrazit v anonymním okně. Pokud jste pouzili metodu pluginu, ověřte, že je u vašeho pluginu zaskrtnuta systemova udalost "OnWebPagePrerender".