Как да добавите Asyntai AI чатбот към Umbraco
Ръководство стъпка по стъпка за уебсайтове с Umbraco CMS
Стъпка 1: Вземете вашия код за вграждане
Първо отидете на вашето Табло за управление на Asyntai и превъртете надолу до секцията "Код за вграждане". Копирайте уникалния си код за вграждане, който ще изглежда така:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Забележка: Кодът по-горе е само пример. Трябва да копирате собствения си уникален код за вграждане от вашето Табло за управление, тъй като съдържа вашия личен ID на уиджета.
Стъпка 2: Редактиране на Master шаблон (Препоръчително)
Най-лесният начин да добавите чатбота на всички страници е чрез редактиране на вашия Master шаблон:
- Влезте в Umbraco Backoffice
- Отидете на Settings в лявата странична лента
- Разгънете Templates
- Щракнете върху вашия Master шаблон (или основния шаблон за оформление, който вашият сайт използва)
- Намерете затварящия таг
</body> - Поставете вашия Asyntai код за вграждане точно преди тага
</body> - Натиснете "Save"
Съвет: Добавянето на скрипта преди затварящия таг </body> гарантира, че той се зарежда след съдържанието на страницата, което е препоръчително за чат уиджети и няма да забави зареждането на страницата ви.
Алтернатива: Използване на тип документ Site Settings
За повече гъвкавост можете да добавите персонализирано поле за управление на скриптове във футъра:
- Отидете на Settings → Document Types
- Редактирайте типа документ Site Settings (или създайте такъв, ако не съществува)
- Добавете ново свойство, наречено "Footer Scripts", с тип данни Textarea
- Запазете типа документ
- Отидете на Content и редактирайте възела Site Settings
- Поставете вашия Asyntai код за вграждане в полето Footer Scripts
- Във вашия Master шаблон добавете този код преди
</body>:@Html.Raw(Model.Value("footerScripts")) - Запазете както съдържанието, така и шаблона
Забележка: Използването на @Html.Raw() е важно за правилно визуализиране на script таговете без HTML кодиране.
Алтернатива: Използване на папка Scripts
Можете също да създадете JavaScript файл в Umbraco Backoffice:
- Отидете на Settings → Scripts
- Щракнете с десен бутон върху Scripts и изберете "Create"
- Създайте нов файл, наречен asyntai-chatbot.js
- Добавете следния код:
(function() {
var script = document.createElement('script');
script.async = true;
script.src = 'https://asyntai.com/static/js/chat-widget.js';
script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
document.body.appendChild(script);
})(); - Заменете
YOUR_WIDGET_IDс вашия действителен ID на уиджета - Запазете файла
- Включете този скрипт във вашия Master шаблон преди
</body>:<script src="/scripts/asyntai-chatbot.js"></script>
Алтернатива: За конкретна страница с RenderSection
Ако искате чатбота само на конкретни страници:
- Във вашия Master шаблон добавете преди
</body>:@RenderSection("footerScripts", required: false) - В конкретния шаблон на страницата, където искате чатбота, добавете:
@section footerScripts {
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
}
Стъпка 3: Проверка на инсталацията
След като запазите промените, посетете уебсайта си в нов раздел на браузъра или в инкогнито прозорец. Трябва да видите бутона на чат уиджета в долния десен ъгъл. Кликнете върху него, за да се уверите, че се отваря и работи правилно.
Не виждате уиджета? Уверете се, че сте запазили шаблона след направените промени. Опитайте да изчистите кеша на браузъра или да разгледате в прозорец инкогнито. Ако използвате Umbraco Cloud, промените трябва да се деплойнат автоматично. За самостоятелно хостван Umbraco може да се наложи да рестартирате приложението или да изчистите кеша.
Weebly