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

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

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

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

Ръководство стъпка по стъпка за уебсайтове с OpenCart

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

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

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

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

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

Стъпка 2: Редактиране на шаблона за футър (Препоръчително)

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

  1. Осъществете достъп до вашите OpenCart файлове чрез FTP или файлов мениджър
  2. Навигирайте до шаблона за футър на вашата тема:
    • OpenCart 3.x/4.x: catalog/view/theme/YOUR_THEME/template/common/footer.twig
    • OpenCart 2.x: catalog/view/theme/YOUR_THEME/template/common/footer.tpl
  3. Отворете файла за футър за редактиране
  4. Намерете затварящия таг </body>
  5. Поставете вашия Asyntai код за вграждане точно преди тага </body>
  6. Запазете файла
  7. Изчистете OpenCart кеша: Dashboard → Синя икона зъбно колело (горе вдясно) → Refresh или изтрийте съдържанието на system/storage/cache/

Съвет: Ако използвате темата по подразбиране, пътят ще бъде catalog/view/theme/default/template/common/footer.twig. Винаги създавайте резервно копие преди редактиране на файловете на шаблона.

Алтернатива: Използване на опцията за персонализиран код на темата

Many modern OpenCart themes include a built-in option for custom code:

  1. Влезте в своя OpenCart административен панел
  2. Отидете на Extensions → Themes (или Extensions → Extensions → Themes)
  3. Щракнете върху Edit на вашата активна тема
  4. Потърсете секция "Custom Code", "Footer Scripts" или "Custom JavaScript"
  5. Поставете вашия Asyntai код за вграждане
  6. Натиснете "Save"
  7. Изчистете кеша

Забележка: Не всички теми имат тази опция. Ако вашата тема не включва полета за персонализиран код, използвайте метода за редактиране на шаблона или инсталирайте разширение.

Алтернатива: Използване на разширение за персонализиран код

Можете да инсталирате безплатно разширение от OpenCart Marketplace, за да добавите персонализирани скриптове:

  1. Отидете на OpenCart Marketplace
  2. Потърсете "Custom Script", "Header Footer Scripts" или "Custom Code"
  3. Изтеглете и инсталирайте подходящо разширение
  4. В административния панел отидете на Extensions → Extensions → Modules
  5. Намерете и инсталирайте модула за персонализиран код
  6. Конфигурирайте модула и поставете вашия Asyntai код за вграждане в секцията за футър
  7. Запазете и изчистете кеша

Важно: Използването на разширения е препоръчително пред редактирането на основни файлове, тъй като те оцеляват при обновявания на OpenCart. Популярните разширения включват "Custom Script in Header & Footer", налично на пазара.

Алтернатива: Използване на метода addScript (За разработчици)

За разработчици OpenCart 3.x/4.x предоставя програмен начин за добавяне на скриптове:

  1. Отворете catalog/controller/common/footer.php
  2. Добавете следния ред преди $data['scripts'] = $this->document->getScripts('footer');:
    $this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
  3. За атрибута data ще трябва да модифицирате footer.twig, за да го включите ръчно, или да добавите вграден JavaScript след цикъла на скриптовете

Забележка: За да работи уиджетът правилно с атрибута data, методът с шаблон е по-прост, тъй като методът addScript не поддържа директно персонализирани атрибути.

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

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

Не виждате уиджета? Уверете се, че сте изчистили кеша на OpenCart. Отидете в административния панел, щракнете върху синята икона зъбно колело в горния десен ъгъл и натиснете бутоните за опресняване. Също опитайте да изчистите кеша на браузъра или да разгледате в прозорец инкогнито. Ако сте модифицирали грешния файл на шаблона, проверете дали вашата тема използва файла, който сте редактирали.