Как да добавите Asyntai AI чатбот към Concrete CMS

Ръководство стъпка по стъпка за Concrete CMS (бивш Concrete5) уебсайтове

Платформа:

Стъпка 1: Вземете вашия код за вграждане

Първо отидете на вашето Табло за управление на Asyntai и превъртете надолу до секцията "Код за вграждане". Копирайте уникалния си код за вграждане, който ще изглежда така:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

Забележка: Кодът по-горе е само пример. Трябва да копирате собствения си уникален код за вграждане от вашето Табло за управление, тъй като съдържа вашия личен ID на уиджета.

Стъпка 2: Добавяне на код в долния колонтитул на темата (Препоръчително)

Най-добрият начин да добавите чатбота към всички страници на вашия Concrete CMS уебсайт е чрез редактиране на файла за долен колонтитул на темата:

Достъпете вашата Concrete CMS инсталация чрез FTP или Файлов мениджър
Навигирайте до директорията /application/themes/your_theme_name/
Намерете и отворете файла footer.php (или еквивалентния шаблон за долен колонтитул)
Намерете реда със затварящия таг </body>
Поставете вашия Asyntai код за вграждане точно преди тага </body>
Запазете файла и го качете обратно на сървъра, ако редактирате локално
Изчистете кеша на Concrete CMS: Табло → Система и настройки → Изчистване на кеша

Съвет: Добавянето на кода преди затварящия таг </body> гарантира, че чатботът се зарежда след съдържанието на страницата, което осигурява по-добра производителност при зареждане. Този метод автоматично добавя чатбота към всяка страница, използваща тази тема.

Алтернативен метод 1: HTML блок (Най-лесно за неразработчици)

Ако предпочитате да не редактирате файлове на темата, можете да използвате вградения HTML блок на Concrete CMS:

Влезте в таблото за управление на Concrete CMS
Навигирайте до страницата, на която искате да добавите чатбота
Натиснете Edit Page (икона молив в лентата с инструменти)
Натиснете Add Block в областта, където искате да поставите кода
Потърсете и изберете блока HTML
Поставете вашия Asyntai код за вграждане в HTML редактора
Натиснете Add, за да запазите блока
Натиснете Publish, за да направите промените активни

Забележка: Методът с HTML блок е чудесен за добавяне на чатбота към конкретни страници. За инсталация на целия сайт ще трябва да добавите HTML блока към всяка страница или да използвате метода с долния колонтитул на темата, описан по-горе. Визуалното позициониране на блока не влияе на това къде се появява чатботът - той пак ще се показва в долния десен ъгъл.

Алтернативен метод 2: Header файл на темата

Можете също така да добавите кода към хедър файла на вашата тема за инсталация на целия сайт:

Достъпете файловете на вашия Concrete CMS чрез FTP или Файлов мениджър
Навигирайте до /application/themes/your_theme_name/
Отворете файла header.php (или elements/header.php)
Намерете затварящия таг </head>
Поставете вашия Asyntai код за вграждане точно преди тага </head>
Запазете и качете файла
Изчистете кеша от таблото за управление

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>
</head>

Съвет: Уверете се, че сте включили задължителните хедър елементи, като използвате <?php View::element('header_required'); ?> във вашия header.php файл, за да работи Concrete CMS правилно.

Алтернативен метод 3: Персонализиран шаблон (За напреднали)

За разработчици, които искат повече контрол, можете да създадете персонализиран шаблон на страница:

Създайте нов файл за шаблон на страница в /application/themes/your_theme_name/
Или копирайте съществуващ шаблон (напр. default.php) и го преименувайте
Добавете вашия Asyntai код за вграждане към файла на шаблона преди </body>
В таблото за управление на Concrete CMS отидете на Pages & Themes
Кликнете върху Page Types
Изберете типа страница, с който искате да използвате този шаблон
Задайте вашия персонализиран шаблон към типа страница
Всички страници, използващи този тип страница, вече ще включват чатбота

Важно: Винаги правете резервно копие на файловете на вашата тема преди да правите промени. Тествайте модификациите си първо на тестов сайт, ако е възможно. Неправилните редакции на файловете на темата могат да нарушат оформлението или функционалността на вашия сайт.

Стъпка 3: Проверка на инсталацията

След като направите промените и изчистите кеша, отворете уебсайта си в нов раздел на браузъра или в инкогнито прозорец. Трябва да видите бутона на чат уиджета в долния десен ъгъл. Кликнете върху него, за да се уверите, че се отваря и функционира правилно.

Не виждате уиджета? Уверете се, че сте изчистили кеша на Concrete CMS (Dashboard → System & Settings → Clear Cache). Опитайте да разгледате сайта си в инкогнито прозорец. Проверете дали сте запазили и качили всички промени по файловете. Отворете конзолата на браузъра (F12), за да проверите за JavaScript грешки.