Joomla: Osadzenie Asystent AI

Jak dodać widget czatu Asystent AI do Twojej strony Joomla w kilku prostych krokach

Te instrukcje dotyczą Joomla 4 i Joomla 5. Jeśli korzystasz ze starszej wersji, nazwy menu mogą się nieznacznie różnić.

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

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

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

Metoda 1: Custom Module (ZALECANA) ⭐

Widget pojawi się automatycznie na wszystkich stronach witryny.

1. Zaloguj się do panelu administratora

   Przejdź na swoją stronę → dodaj /administrator na końcu URL Zaloguj się przy użyciu danych administratora

2. Utwórz nowy moduł

   W górnym menu wybierz Extensions (Rozszerzenia) → Modules (Moduły) Kliknij New (Nowy) w lewym górnym rogu

3. Wybierz typ modułu

   Znajdź i wybierz Custom (w Joomla 3: Custom HTML) Jeśli nie widzisz tej opcji, może być nazwana HTML

4. Skonfiguruj moduł

   • Title: wpisz “Asystent AI Widget” (tytuł nie będzie widoczny dla odwiedzających)
   • Show Title: ustaw na Hide (Ukryj)
   • Position: wybierz footer (stopka) lub dowolną pozycję
   • W edytorze tekstu kliknij przycisk <> (tryb HTML/kod źródłowy)
5. Wklej kod widgetu

   W trybie HTML wklej kod widgetu:

   <script async src="https://widget.wenetasystent.ai/?code=TWOJ_KOD"></script>
   
6. Ustaw gdzie ma się wyświetlać

   Przewiń w dół do sekcji Menu Assignment Wybierz On all pages (Na wszystkich stronach)

7. Zapisz i sprawdź

   Ustaw Status na Published (Opublikowany) Kliknij Save & Close (Zapisz i zamknij) Odśwież swoją stronę — widget powinien się pojawić

Ta metoda działa z każdym szablonem Joomla 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 szablonu. Zmiany mogą zniknąć po aktualizacji szablonu. Zalecamy Metodę 1 jako bardziej bezpieczną.

1. Przejdź do edytora szablonów

   W panelu administratora wybierz System → Site Templates (Szablony witryny) Kliknij na aktywny szablon (ten oznaczony gwiazdką lub napisem “Default”)

2. Znajdź plik index.php

   W lewym panelu (lista plików) znajdź i kliknij index.php To główny plik szablonu

3. Dodaj kod przed zamknięciem body

   Przewiń na sam dół pliku 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 plik

   Kliknij Save (Zapisz) lub Save & Close Odśwież swoją stronę — widget powinien się pojawić

Najczęstsze problemy

Widget się nie pojawia

Sprawdź kolejno:

• Czy podmieniłeś TWOJ_KOD na prawdziwy kod z panelu?
• Czy moduł ma status Published (Metoda 1)?
• Czy Menu Assignment jest ustawiony na “On all pages”?
• Wyczyść cache Joomla: System → Clear Cache
• Wyczyść cache przeglądarki (Ctrl+Shift+R lub Cmd+Shift+R)

Nie mogę znaleźć Custom Module

Jeśli nie widzisz opcji Custom (w Joomla 3: Custom HTML) przy tworzeniu modułu:

• Sprawdź czy moduł Custom nie został wyłączony
• Przejdź do Extensions → Plugins i wyszukaj “Custom”
• Upewnij się, że plugin jest Enabled (Włączony)

Widget zniknął po aktualizacji szablonu

To dotyczy Metody 2 — zmiany w plikach szablonu znikają po aktualizacji.

Rozwiązanie: Użyj Metody 1 (Custom Module) — ta metoda jest odporna na aktualizacje szablonu.

Edytor HTML zmienia mój kod

Jeśli edytor w Custom Module modyfikuje lub usuwa Twój kod:

• Kliknij przycisk <> aby przełączyć się w tryb kodu źródłowego
• Lub wyłącz filtrowanie HTML: System → Global Configuration → Text Filters → ustaw na “No Filtering”

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

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

Jak usunąć widget?

Metoda 1 (Custom Module):

• Przejdź do Extensions → Modules
• Znajdź moduł “Asystent AI Widget”
• Kliknij na niego i ustaw Status na Unpublished (Nieopublikowany)
• Lub usuń moduł całkowicie (ikona kosza)
• Wyczyść cache: System → Clear Cache

Metoda 2 (edycja szablonu):

• Wróć do System → Site Templates → Twój szablon → index.php
• Usuń linijkę z kodem <script async src="https://widget...
• Zapisz plik
• Wyczyść cache

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!