Jak dodać chatbota AI Asyntai do Umbraco
Instrukcja krok po kroku dla stron Umbraco CMS
Krok 1: Pobierz swój kod osadzania
Najpierw przejdź do swojego Panelu Asyntai i przewiń w dół do sekcji "Kod osadzania". Skopiuj swój unikalny kod osadzania, który będzie wyglądał tak:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Uwaga: Powyższy kod to tylko przykład. Musisz skopiować swój własny unikalny kod osadzania z Panelu, ponieważ zawiera on Twój osobisty identyfikator widgetu.
Krok 2: Edycja szablonu głównego (zalecane)
Najłatwiejszym sposobem dodania chatbota do wszystkich stron jest edycja szablonu głównego (Master):
- Zaloguj sie do panelu Umbraco Backoffice
- Przejdź do Settings na lewym pasku bocznym
- Rozwin Templates
- Kliknij szablon Master (lub główny szablon ukladu używany przez Twoja witrynę)
- Znajdź zamykający znacznik
</body> - Wklej kod osadzania Asyntai tuz przed znacznikiem
</body> - Kliknij "Save"
Wskazówka: Dodanie skryptu przed zamykającym znacznikiem </body> zapewnia, że ładuje się on po treści strony, co jest zalecane dla widgetów czatu i nie spowalnia ładowania strony.
Alternatywa: Użycie typu dokumentu Site Settings
Aby uzyskać większą elastyczność, możesz dodać własne pole do zarządzania skryptami w stopce:
- Przejdź do Settings → Document Types
- Edytuj typ dokumentu Site Settings (lub utwórz go, jeśli nie istnieje)
- Dodaj nowa właściwość o nazwie "Footer Scripts" z typem danych Textarea
- Zapisz typ dokumentu
- Przejdź do Content i edytuj wezel Site Settings
- Wklej kod osadzania Asyntai w polu Footer Scripts
- W szablonie Master dodaj ten kod przed
</body>:@Html.Raw(Model.Value("footerScripts")) - Zapisz zarówno treść, jak i szablon
Uwaga: Użycie @Html.Raw() jest ważne, aby prawidlowo wyrenderowac znaczniki skryptu bez kodowania HTML.
Alternatywa: Użycie folderu Scripts
Możesz również utworzyć plik JavaScript w panelu Umbraco Backoffice:
- Przejdź do Settings → Scripts
- Kliknij prawym przyciskiem myszy na Scripts i wybierz "Create"
- Utwórz nowy plik o nazwie asyntai-chatbot.js
- Dodaj następujący kod:
(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);
})(); - Replace
YOUR_WIDGET_IDwith your actual widget ID - Zapisz plik
- Dołącz ten skrypt w szablonie Master przed
</body>:<script src="/scripts/asyntai-chatbot.js"></script>
Alternatywa: Dla konkretnej strony z RenderSection
Jeśli chcesz umieścić chatbota tylko na określonych stronach:
- W szablonie Master dodaj przed
</body>:@RenderSection("footerScripts", required: false) - In the specific page template where you want the chatbot, add:
@section footerScripts {
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
}
Krok 3: Weryfikacja instalacji
Po zapisaniu zmian odwiedź swoja witrynę w nowej karcie przeglądarki lub w oknie incognito. Powinieneś zobaczyć przycisk widgetu czatu w prawym dolnym rogu. Kliknij go, aby upewnić sie, ze otwiera sie i działa poprawnie.
Nie widzisz widgetu? Upewnij sie, ze zapisales szablon po wprowadzeniu zmian. Spróbuj wyczyścić pamięć podręczna przeglądarki lub otworzyc stronę w oknie incognito. Jeśli korzystasz z Umbraco Cloud, zmiany powinny zostac wdrozone automatycznie. W przypadku samodzielnie hostowanego Umbraco może byc konieczne ponowne uruchomienie aplikacji lub wyczyszczenie pamięci podręcznej.
Weebly