Skip to main content

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:
<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.
1

Zaloguj się do panelu administratora

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

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)
3

Wybierz typ bloku

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

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!
5

Zapisz blok

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

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”
7

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)
8

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ą.
1

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
2

Edytuj plik

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

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>
4

Zapisz i wyczyść cache

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

Najczęstsze problemy

Sprawdź kolejno:
  • Czy podmieniłeś TWOJ_KOD na 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
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
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.
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
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).
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ń.
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.ai do 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
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

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
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.