Drupal: Osadzenie Asystent AI

Te instrukcje dotyczą Drupal 8, 9 i 10. Drupal 7 osiągnął koniec wsparcia (EOL) w styczniu 2025 — zalecamy aktualizację.

Kod do wklejenia — podmień TWOJ_KOD na swój kod z panelu Asystent AI:

<script async src="https://widget.wenetasystent.ai/?code=TWOJ_KOD"></script>

Swój kod widgetu znajdziesz w panelu Asystent AI — przejdź do zakładki Chatbot i skopiuj 8-znakowy kod z sekcji “Umieść chatbota na swojej stronie”.

Metoda 1: Custom Block (ZALECANA) ⭐

Widget pojawi się automatycznie na wszystkich stronach witryny.

Zaloguj się do panelu administratora

Przejdź na swoją stronę → zaloguj się jako administrator Kliknij Manage (Zarządzaj) w górnym menu

Utwórz nowy blok

Przejdź do Structure (Struktura) → Block layout (Układ bloków) Kliknij Custom block library (Biblioteka bloków niestandardowych) Kliknij Add custom block (Dodaj blok niestandardowy)

Wybierz typ bloku

Wybierz Basic block (Podstawowy blok) Jeśli nie widzisz tej opcji, kliknij po prostu Add custom block

Wypełnij formularz

Block description: wpisz “Asystent AI Widget”
Body: kliknij przycisk Source lub <> (tryb HTML)
Wklej kod widgetu:

<script async src="https://widget.wenetasystent.ai/?code=TWOJ_KOD"></script>

Zmień format tekstu na Full HTML (lista rozwijana pod edytorem). Inne formaty (Basic HTML, Restricted HTML) automatycznie usuwają tagi <script> i widget nie zadziała!

Zapisz blok

Kliknij Save (Zapisz) Blok został utworzony, teraz trzeba go dodać do układu strony

Dodaj blok do regionu

Wróć do Structure → Block layout Znajdź region Footer (Stopka) lub Content (Treść) Kliknij Place block (Umieść blok) w wybranym regionie Znajdź i wybierz “Asystent AI Widget”

Skonfiguruj widoczność

W ustawieniach bloku:

Title: usuń tytuł lub ustaw Display title na wyłączony
Visibility: zostaw domyślne ustawienia (blok będzie widoczny wszędzie)
Kliknij Save block (Zapisz blok)

Sprawdź działanie

Odśwież swoją stronę — widget powinien się pojawić w dolnym rogu strony (pozycja zależy od ustawień w panelu)

Ta metoda działa z każdym motywem Drupal i automatycznie dodaje widget do wszystkich stron!

Metoda 2: Edycja szablonu

Jeśli preferujesz dodanie kodu bezpośrednio do szablonu strony.

Ta metoda wymaga edycji plików motywu. Zmiany mogą zniknąć po aktualizacji motywu. Zalecamy Metodę 1 jako bardziej bezpieczną.

Znajdź plik szablonu

Połącz się z serwerem przez FTP lub File Manager Przejdź do folderu: /themes/custom/twoj_motyw/templates/ (dokładna ścieżka zależy od instalacji motywu) Znajdź plik html.html.twig lub page.html.twig

Edytuj plik

Otwórz plik w edytorze tekstowym Przewiń na sam dół pliku

Dodaj kod przed zamknięciem body

Znajdź tag </body> (zamykający tag body) Tuż przed tym tagiem wklej kod widgetu:

<!-- Asystent AI widget -->
<script async src="https://widget.wenetasystent.ai/?code=TWOJ_KOD"></script>

Zapisz i wyczyść cache

Zapisz plik na serwerze W Drupalu przejdź do Configuration → Performance Kliknij Clear all caches (Wyczyść wszystkie cache) Odśwież swoją stronę — widget powinien się pojawić

Strona zbudowana w Drupal Canvas (Drupal CMS)?

Nowy Drupal CMS z włączonym Drupal Canvas (dawniej Experience Builder) nie pozwala dodawać własnych bloków HTML ani skryptów w wizualnym kreatorze stron. Widget da się mimo to zainstalować — poniższe sposoby działają na poziomie samego Drupala, “pod” Canvasem.

Opcja A: Moduł Asset Injector (zalecana)

Zainstaluj moduł Asset Injector

Zainstaluj moduł na serwerze: composer require drupal/asset_injector Następnie przejdź do Extend, znajdź Asset Injector i włącz go

Dodaj JS Injector

Przejdź do Configuration → Development → Asset Injector Otwórz zakładkę JS Injectors i kliknij Add JS Injector

Wklej kod ładujący widget

Label: wpisz “Asystent AI Widget”
W polu Code wklej poniższy kod (bez tagów <script> — pole przyjmuje czysty JavaScript):

var s = document.createElement('script');
s.async = true;
s.src = 'https://widget.wenetasystent.ai/?code=TWOJ_KOD';
document.body.appendChild(s);

Zapisz bez warunków

Sekcję Conditions zostaw pustą — skrypt załaduje się na wszystkich stronach Kliknij Save, wyczyść cache (Configuration → Performance → Clear all caches) i sprawdź stronę

Opcja B: Klasyczny Block Layout

Structure → Block layout działa nadal przy włączonym Canvas (pokazuje ostrzeżenie, ale nie jest zablokowany). Możesz użyć Metody 1 powyżej — blok nie będzie widoczny w edytorze Canvas, ale wyrenderuje się na opublikowanej stronie.

Opcja C: Google Tag Manager

Jeśli korzystasz z GTM, dodaj widget przez tag niestandardowy — działa niezależnie od Canvas. Zobacz instrukcję GTM.

Najczęstsze problemy

Używam Drupal Canvas i nie mogę dodać własnego bloku

To znane ograniczenie Drupal Canvas (Experience Builder) — wizualny kreator nie obsługuje własnych bloków HTML/skryptów, a przy niektórych szablonach blokuje też dodawanie custom blocków w panelu.Rozwiązanie: zobacz sekcję Strona zbudowana w Drupal Canvas powyżej — najprościej przez moduł Asset Injector, który omija Canvas całkowicie.

Widget się nie pojawia

Nie mogę znaleźć Source/HTML mode w edytorze

Jeśli nie widzisz przycisku do trybu HTML w edytorze:

Sprawdź czy używasz Text format: Full HTML (zamiast “Basic HTML”)
Przejdź do Configuration → Text formats i upewnij się, że Full HTML jest włączony
Alternatywnie możesz zainstalować moduł CKEditor CodeMirror dla lepszego edytora kodu

Widget zniknął po aktualizacji motywu

Blok nie pojawia się w Block Layout

Jeśli utworzyłeś blok, ale nie widzisz go w Block Layout:

Upewnij się, że zapisałeś blok po utworzeniu
W Block Layout kliknij Place block → wpisz nazwę bloku w wyszukiwarkę
Sprawdź czy blok nie jest już umieszczony w innym regionie

Widget pojawił się raz i zniknął

Używam adblocka lub rozszerzenia prywatności

Niektóre rozszerzenia przeglądarki (uBlock Origin, Ghostery, AdBlock) mogą blokować skrypty widgetu.Rozwiązanie: Dodaj widget.wenetasystent.ai do wyjątków w ustawieniach rozszerzenia lub otwórz stronę w trybie prywatnym bez rozszerzeń.

Widget zablokowany przez Content Security Policy (CSP)

Metoda 1 (Custom Block):

Przejdź do Structure → Block layout
Znajdź blok “Asystent AI Widget”
Kliknij Remove (Usuń) obok tego bloku
Potwierdź usunięcie
Wyczyść cache: Configuration → Performance → Clear all caches

Metoda 2 (edycja szablonu):

Połącz się z serwerem i otwórz plik szablonu
Usuń linijkę z kodem <script async src="https://widget...
Zapisz plik
Wyczyść cache w Drupalu

Gotowy kod do skopiowania

<!-- Asystent AI widget -->
<script async src="https://widget.wenetasystent.ai/?code=TWOJ_KOD"></script>

Pamiętaj, aby podmienić TWOJ_KOD na swój rzeczywisty kod widgetu z panelu Asystent AI!

Dodatkowe wskazówki dla Drupal

Drupal 8/9/10 - Różnice

Instrukcje powyżej działają dla Drupal 8, 9 i 10. Główne różnice:

Drupal 7 osiągnął koniec wsparcia (EOL) w styczniu 2025. Zalecamy aktualizację do Drupal 10+.
Ścieżki menu mogą się nieznacznie różnić w zależności od wersji

Używanie modułów dodatkowych

Możesz też użyć modułów takich jak:

Insert - pozwala wstawiać kod HTML w różnych miejscach
Możesz też użyć Google Tag Manager — oddzielna instrukcja.

Pierwsze kroki

Instalacja widgetu

Profil firmowy

Konfiguracja chatbota

Integracje

Generowanie ofert

Konwersacje

Konto i zespół

Rozwiązywanie problemów

Drupal: Osadzenie Asystent AI

Metoda 1: Custom Block (ZALECANA) ⭐

Metoda 2: Edycja szablonu

Strona zbudowana w Drupal Canvas (Drupal CMS)?

Opcja A: Moduł Asset Injector (zalecana)

Opcja B: Klasyczny Block Layout

Opcja C: Google Tag Manager

Najczęstsze problemy

Jak usunąć widget?

Gotowy kod do skopiowania

Dodatkowe wskazówki dla Drupal

​Metoda 1: Custom Block (ZALECANA) ⭐

​Metoda 2: Edycja szablonu

​Strona zbudowana w Drupal Canvas (Drupal CMS)?

​Opcja A: Moduł Asset Injector (zalecana)

​Opcja B: Klasyczny Block Layout

​Opcja C: Google Tag Manager

​Najczęstsze problemy

​Jak usunąć widget?

​Gotowy kod do skopiowania

​Dodatkowe wskazówki dla Drupal

Metoda 1: Custom Block (ZALECANA) ⭐

Metoda 2: Edycja szablonu

Strona zbudowana w Drupal Canvas (Drupal CMS)?

Opcja A: Moduł Asset Injector (zalecana)

Opcja B: Klasyczny Block Layout

Opcja C: Google Tag Manager

Najczęstsze problemy

Jak usunąć widget?

Gotowy kod do skopiowania

Dodatkowe wskazówki dla Drupal