Обратно към таблото

Документация

Научете как да използвате Asyntai

Как да добавите Asyntai AI чатбот в ExpressionEngine

Ръководство стъпка по стъпка за ExpressionEngine CMS

Вземете код за вграждане

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

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

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

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

Стъпка 2: Добавете към шаблона за оформление (Препоръчително)

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

  1. В контролния панел на EE отидете на Developer > Templates > Template Groups
  2. Отворете основната група шаблони (обикновено "site") и редактирайте шаблона за оформление (или шаблона, който обвива всички страници)
  3. Намерете затварящия таг </body>
  4. Поставете вашия Asyntai код за вграждане точно преди тага </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. Запазете шаблона

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

Алтернативен метод 1: Използване на Template Partials на EE

Template Partials на ExpressionEngine ви позволяват да създавате фрагменти за повторна употреба, които могат да бъдат включвани в различни шаблони:

  1. Отидете на Developer > Templates > Template Partials
  2. Кликнете "New", за да създадете нов partial с име _asyntai_widget
  3. Поставете вашия Asyntai код за вграждане в съдържанието на partial:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  4. Запазете partial
  5. Включете го в шаблона си за оформление точно преди затварящия таг </body>:
    {embed="_asyntai_widget"} </body>

Забележка: Използването на Template Partials поддържа кода ви организиран и улеснява актуализирането на кода за вграждане на чатбота на едно място в целия ви сайт.

Алтернативен метод 2: Използване на HTML Header/Footer на EE

Някои конфигурации на ExpressionEngine предоставят глобална секция за футър за добавяне на скриптове:

  1. Отидете на Settings > Content & Design > Global Template Preferences
  2. Ако вашата EE конфигурация има глобална секция за футър, поставете кода за вграждане на Asyntai там
  3. Ако няма налична глобална секция за футър, редактирайте основния си шаблон за оформление директно и добавете кода за вграждане преди затварящия таг </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  4. Запазете промените си

Алтернативен метод 3: Използване на config.php

За напреднали потребители можете да инжектирате скрипта на чатбота чрез конфигурацията на ExpressionEngine или като създадете персонализирана добавка:

  1. Достъпете файловете на вашия ExpressionEngine проект чрез FTP, SSH или вашия редактор на код
  2. Навигирайте до директорията system/user/config/ и отворете config.php
  3. За инжектиране на персонализиран JavaScript, помислете за създаване на проста EE добавка/разширение, което се свързва с hook-а template_post_parse за инжектиране на скрипта при визуализиране на страницата:
    // In your custom extension public function template_post_parse($final_template, $is_partial, $site_id) { $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>'; $final_template = str_replace('</body>', $script . '</body>', $final_template); return $final_template; }
  4. Заменете YOUR_WIDGET_ID с вашия действителен ID на уиджета от таблото за управление

Важно: Методът с config.php и добавка е предназначен за напреднали потребители, които се чувстват удобно с разработката на ExpressionEngine. За повечето потребители се препоръчва методът с шаблон за оформление (Стъпка 2) или методът с Template Partials (Алтернативен метод 1).

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

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

Не виждате уиджета? Уверете се, че сте запазили шаблона и че редактирате правилния шаблон за оформление, който вашите страници използват. Изчистете кеша на браузъра или разгледайте в инкогнито прозорец. Ако кеширането на шаблони на ExpressionEngine е активирано, изчистете кеша от контролния панел под Developer > Utilities > Cache Manager.