Documentation Index
Fetch the complete documentation index at: https://pomoc.wenetasystent.ai/llms.txt
Use this file to discover all available pages before exploring further.
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: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:
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)
Metoda 2: Edycja szablonu
Jeśli preferujesz dodanie kodu bezpośrednio do szablonu strony.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.twigDodaj kod przed zamknięciem body
Znajdź tag
</body> (zamykający tag body)
Tuż przed tym tagiem wklej kod widgetu:Najczęstsze problemy
Widget się nie pojawia
Widget się nie pojawia
Sprawdź kolejno:
- Czy podmieniłeś
TWOJ_KODna prawdziwy kod z panelu? - Czy blok jest umieszczony w regionie i widoczny? (Metoda 1)
- Wyczyść cache Drupal: Configuration → Performance → Clear all caches
- Wyczyść cache przeglądarki (Ctrl+Shift+R lub Cmd+Shift+R)
- Sprawdź czy blok nie jest ograniczony do konkretnych stron w ustawieniach Visibility
Nie mogę znaleźć Source/HTML mode w edytorze
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
Widget zniknął po aktualizacji motywu
To dotyczy Metody 2 — zmiany w plikach motywu znikają po aktualizacji.Rozwiązanie: Użyj Metody 1 (Custom Block) — ta metoda jest odporna na aktualizacje motywu.
Blok nie pojawia się w Block Layout
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ął
Widget pojawił się raz i zniknął
To normalne zachowanie! Widget automatycznie otwiera się przy pierwszej wizycie (po 3 sekundach). Przy kolejnych odwiedzinach w ciągu 15 minut trzeba kliknąć ikonę czatu ręcznie.Aby przetestować ponowne auto-otwarcie, otwórz stronę w nowym oknie prywatnym (incognito).
Używam adblocka lub rozszerzenia prywatności
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)
Widget zablokowany przez Content Security Policy (CSP)
Jeśli w konsoli przeglądarki (F12) widzisz błąd “Refused to load the script”:
- Sprawdź czy masz zainstalowany moduł SecKit lub inne zabezpieczenia CSP
- Dodaj
widget.wenetasystent.aido dozwolonych źródeł skryptów (script-src) - Jeśli nie wiesz jak — skontaktuj się z administratorem serwera
Jak usunąć widget?
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
- 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
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
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
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.
