Jak přidat Asyntai AI Chatbota na Concrete CMS

Průvodce krok za krokem pro weby Concrete CMS (dříve Concrete5)

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í kódu do zápatí motivu (doporučeno)

Nejlepší způsob, jak přidat chatbota na všechny stránky vašeho Concrete CMS webu, je úprava souborů zápatí vašeho motivu:

Přistupte k instalaci Concrete CMS přes FTP nebo Správce souborů
Přejděte do adresáře /application/themes/your_theme_name/
Najděte a otevřete soubor footer.php (nebo ekvivalentní šablonu zápatí)
Najděte řádek s uzavírací značkou </body>
Vložte svůj Asyntai embed kód těsně před značku </body>
Uložte soubor a pokud upravujete lokálně, nahrajte jej zpět na server
Vymažte mezipaměť Concrete CMS: Dashboard → System & Settings → Clear Cache

Tip: Přidání kódu před uzavírací značku </body> zajistí, že se chatbot načte po obsahu stránky, což poskytuje lepší 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: HTML blok (nejjednodušší pro nevývojáře)

Pokud nechcete upravovat soubory motivu, můžete použít vestavěný HTML blok Concrete CMS:

Přihlaste se do svého Concrete CMS Dashboard
Přejděte na stránku, kam chcete chatbota přidat
Klikněte na Edit Page (ikona tužky na panelu nástrojů)
Klikněte na Add Block v oblasti, kam chcete kód umístit
Vyhledejte a vyberte blok HTML
Vložte svůj Asyntai embed kód do HTML editoru
Klikněte na Add pro uložení bloku
Klikněte na Publish pro zveřejnění změn

Poznámka: Metoda HTML bloku je skvělá pro přidání chatbota na konkrétní stránky. Pro instalaci na celém webu budete muset přidat HTML blok na každou stránku, nebo použít výše popsanou metodu zápatí motivu. Vizuální umístění bloku neovlivňuje, kde se chatbot zobrazí – stále se zobrazí v pravém dolním rohu.

Alternativní metoda 2: Soubor záhlaví motivu

Pro instalaci na celém webu můžete kód také přidat do souborů záhlaví motivu:

Přistupte k souborům Concrete CMS přes FTP nebo Správce souborů
Přejděte na /application/themes/your_theme_name/
Otevřete soubor header.php (nebo elements/header.php)
Najděte uzavírací značku </head>
Vložte svůj Asyntai embed kód těsně před značku </head>
Uložte a nahrajte soubor
Vymažte mezipaměť z Dashboardu

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

Tip: Ujistěte se, že v souborů header.php máte zahrnuty povinné prvky záhlaví pomocí <?php View::element('header_required'); ?>, aby Concrete CMS správně fungoval.

Alternativní metoda 3: Vlastní šablona (pokročilé)

Pro vývojáře, kteří chtějí větší kontrolu, je možné vytvořit vlastní šablonu stránky:

Vytvořte nový soubor šablony stránky v /application/themes/your_theme_name/
Nebo zkopírujte existující šablonu (např. default.php) a přejmenujte ji
Přidejte svůj Asyntai embed kód do souboru šablony před </body>
V Concrete CMS Dashboard přejděte na Pages & Themes
Klikněte na Page Types
Vyberte typ stránky, se kterým chcete tuto šablonu použít
Přiřaďte svou vlastní šablonu k typu stránky
Všechny stránky používající tento typ stránky nyní budou obsahovat chatbota

Důležité: Vždy si před provedením změn zálohujte soubory motivu. Pokud je to možné, otestujte úpravy nejprve na testovacím webu. Nesprávné úpravy souborů motivu mohou narušit rozvržení nebo funkčnost vašeho webu.

Krok 3: Ověřte instalaci

Po provedení změn a vymazání mezipaměti otevřete svůj web 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 vymazali mezipaměť Concrete CMS (Dashboard → System & Settings → Clear Cache). Zkuste zobrazit web v anonymním okně. Ověřte, že jste uložili a nahráli všechny změny souborů. Otevřete konzoli prohlížeče (F12) a zkontrolujte, zda nejsou nějaké JavaScript chyby.