Ako pridať Asyntai AI Chatbot do MODX

Podrobný návod pre webové stránky MODX CMS

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 do šablóny MODX (Odporúčané)

Odporúčaný spôsob pridania chatbota je úprava vašej šablóny MODX priamo v MODX Manager:

Prihláste sa do svojho MODX Manager (admin panel)
V ľavom bočnom paneli prejdite na Elements > Templates
Otvorte šablónu vášho webu (zvyčajne nazývanú "BaseTemplate" alebo vašu aktívnu šablónu)
Nájdite uzatváraciu značku </body> v kóde šablóny
Vložte svoj vkladací kód Asyntai tesne pred uzatváraciu značku </body>
Kliknite na "Uložiť" pre uloženie šablóny

<!-- 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: Pridanie kódu tesne pred uzatváraciu značku </body> zabezpečuje, že sa chatbot načíta po celom obsahu stránky, čo je odporúčané umiestnenie pre chatové widgety a nespomalí načítanie vašej stránky.

Alternatívna metóda 1: Pomocou MODX Chunk

Môžete použiť MODX Chunk na oddelenie a opätovné použitie vkladacieho kódu:

V MODX Manager prejdite na Elements > Chunks
Kliknite na "Nový Chunk" pre vytvorenie nového chunku
Pomenujte chunk "asyntaiWidget"
Vložte svoj vkladací kód Asyntai do oblasti obsahu chunku
Kliknite na "Uložiť"
Otvorte svoju šablónu (pod Elements > Templates)
Pridajte volanie chunku [[$asyntaiWidget]] tesne pred uzatváraciu značku </body>
Uložte šablónu

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

Tip: Použitie Chunku uľahčuje správu a aktualizáciu vkladacieho kódu na jednom mieste, najmä ak používate viacero šablón na svojom webe.

Alternatívna metóda 2: Použitie systémových nastavení MODX (HTML hlavička/päta)

Niektoré inštalácie MODX obsahujú zástupné symboly pre skripty pätičky cez systémové nastavenia:

V MODX Manager prejdite na System > System Settings
Filtrujte podľa "htmlhead" alebo vyhľadajte vlastné systémové nastavenie pre skripty pätičky
Ak vaša inštalácia má zástupný symbol pre skripty pätičky (napríklad [[++footer_scripts]]), môžete ho použiť
Nastavte hodnotu systémového nastavenia na svoj vkladací kód Asyntai
Uistite sa, že zodpovedajúci zástupný symbol [[++footer_scripts]] je prítomný vo vašej šablóne pred uzatváracou značkou </body>
Uložte systémové nastavenie

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

Poznámka: Táto metóda závisí od toho, či vaša inštalácia MODX má vlastné systémové nastavenie pre skripty pätičky. Ak neexistuje, môžete vytvoriť vlastné systémové nastavenie a odkazovať naň vo vašej šablóne pomocou syntaxe [[++setting_key]].

Alternatívna metóda 3: Pomocou pluginu MODX (OnWebPagePrerender)

Pre pokročilý prístup môžete vytvoriť plugin MODX, ktorý automaticky vloží kód chatbota na každú stránku:

V MODX Manager prejdite na Elements > Plugins
Kliknite na "Nový Plugin" pre vytvorenie nového pluginu
Pomenujte plugin "AsyntaiChatbot"
Vložte nasledujúci 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);

Kliknite na záložku "System Events"
Zaškrtnite políčko vedľa "OnWebPagePrerender" pre spustenie tohto pluginu pri tejto udalosti
Kliknite na "Uložiť"

Dôležité: Nahraďte YOUR_WIDGET_ID svojím skutočným ID widgetu z ovládacieho panela Asyntai. Tento plugin automaticky vloží skript chatbota na každú stránku vášho webu MODX pred jej vykreslením.

Krok 3: Vymazanie vyrovnávacej pamäte a overenie

Po pridaní vkladacieho kódu pomocou ktorejkoľvek z vyššie uvedených metód musíte vymazať vyrovnávaciu pamäť MODX a overiť inštaláciu:

V MODX Manager prejdite na Manage > Clear Cache (alebo kliknite na ikonu vymazania vyrovnávacej pamäte v hornom menu)
Otvorte svoj web v novej záložke prehliadača alebo okne inkognito
V pravom dolnom rohu stránky by ste mali vidieť tlačidlo chatového widgetu
Kliknite naň, aby ste sa uistili, že sa otvára a funguje správne

Nevidíte widget? Uistite sa, že ste vymazali vyrovnávaciu pamäť MODX cez Manage > Clear Cache v MODX Manager. Tiež skúste vymazať vyrovnávaciu pamäť prehliadača alebo zobraziť stránku v okne inkognito. Ak ste použili metódu pluginu, overte, že systémová udalosť "OnWebPagePrerender" je zaškrtnutá pre váš plugin.