Jak přidat AI chatbota Asyntai do Backdrop CMS

Průvodce krok za krokem pro weby Backdrop 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řidejte do šablony motivu (doporučeno)

Backdrop CMS používá v motivech soubory šablon .tpl.php. Doporučený přístup je přidat vkládací kód přímo do šablony stránky aktivního motivu:

Přistupte k instalaci Backdrop CMS přes FTP nebo Správce souborů
Přejděte do adresáře aktivního motivu: themes/yourtheme/
Otevřete soubor page.tpl.php (nebo layout.tpl.php v závislosti na motivu)
Najděte uzavírací značku </body> nebo řádek <?php print $page_bottom; ?>
Vložte svůj vkládací kód Asyntai těsně před tento řádek
Uložte soubor

<!-- Asyntai AI Chatbot -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
<?php print $page_bottom; ?>
</body>

Tip: Umístění kódu těsně před <?php print $page_bottom; ?> nebo uzavírací značku </body> zajistí, že se chatbot načte po obsahu stránky, čímž se zlepší výkon načítání stránky. Tato metoda automaticky přidá chatbota na každou stránku používající tento motiv.

Alternativní metoda 1: Použití vlastního modulu

Můžete vytvořit jednoduchý modul Backdrop CMS, který vloží skript chatbota pomocí backdrop_add_js():

Vytvořte adresář modulu: modules/custom/asyntai_widget/
Vytvořte soubor modulu asyntai_widget.module s následujícím kódem:
// modules/custom/asyntai_widget/asyntai_widget.module function asyntai_widget_init() { backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array( 'type' => 'external', 'scope' => 'footer', 'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'), )); }
Vytvořte soubor asyntai_widget.info:
name = Asyntai AI Chatbot Widget description = Adds the Asyntai AI chatbot widget to all pages. backdrop = 1.x package = Custom type = module
Přejděte na Functionality (admin/modules) v administračním panelu Backdrop
Najděte "Asyntai AI Chatbot Widget" pod balíčkem Custom a povolte ho
Klikněte na "Save configuration"

Poznámka: Nahraďte YOUR_WIDGET_ID v kódu modulu vaším skutečným ID widgetu z ovládacího panelu Asyntai. Přístup s vlastním modulem je bezpečný při aktualizacích a nebude přepsán při aktualizaci motivu.

Alternativní metoda 2: Použití modulu "Add to Head" pro Backdrop

Komunitní modul "Add to Head" poskytuje snadný způsob vkládání skriptů bez úpravy kódu:

Stáhněte a nainstalujte komunitní modul „Add to Head" z webu Backdrop CMS
Přejděte na Configuration > Development > Add to Head
Přidejte svůj vkládací kód Asyntai do sekce patičky
Klikněte na "Save configuration"

Tip: Použití modulu "Add to Head" je nejjednodušší metoda, pokud nechcete upravovat soubory motivu nebo vytvářet vlastní moduly. Poskytuje jednoduché administrační rozhraní pro správu vkládaných skriptů.

Alternativní metoda 3: Použití systému bloků

Systém rozvržení a bloků Backdrop CMS lze také použít pro přidání chatbota:

Přihlaste se do administračního panelu Backdrop CMS
Přejděte na Structure > Layouts
Vyberte rozvržení, které chcete upravit (např. výchozí rozvržení)
Klikněte na "Add block" v oblasti patičky
Zvolte "Custom block"
Nastavte formát bloku na "Full HTML" nebo "Raw HTML"
Vložte svůj vkládací kód Asyntai do těla bloku
Pojmenujte blok (např. "Asyntai Chatbot") a volitelně zaškrtněte "Hide title"
Klikněte na "Save block" a poté "Save layout"

Důležité: Ujistěte se, že formát textu je nastaven na "Full HTML" nebo "Raw HTML", aby nebyla odstraněna značka script. Výchozí formát "Filtered HTML" odstraní značky script z bezpečnostních důvodů.

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

Po provedení změn vymažte mezipaměť Backdrop CMS a ověřte instalaci:

Přejděte na Configuration > Performance v administračním panelu
Klikněte na "Clear all caches"
Otevřete svůj web v nové záložce prohlížeče nebo v anonymním okně
Měli byste vidět tlačítko chatovacího widgetu v pravém dolním rohu
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ěť Backdrop CMS na Configuration > Performance. Zkuste si web prohlédnout v anonymním okně nebo vymažte mezipaměť prohlížeče. Otevřete konzoli prohlížeče (F12) a zkontrolujte případné chyby JavaScriptu. Pokud jste použili metodu vlastního modulu, ověřte, že je modul povolen pod Functionality.