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

# Joomla: Osadzenie Asystent AI

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

<Frame>
  <iframe width="100%" height="420" src="https://www.youtube.com/embed/wnIZ0PFcvgI" title="Joomla: Osadzenie Asystent AI" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />
</Frame>

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

<Note>
  **Kod do wklejenia** — podmień `TWOJ_KOD` na swój kod z panelu Asystent AI:
</Note>

<Tip>
  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".
</Tip>

```html theme={null}
<script async src="https://widget.wenetasystent.ai/?code=TWOJ_KOD"></script>
```

## Metoda 1: Custom Module (ZALECANA) ⭐

Widget pojawi się automatycznie na wszystkich stronach witryny.

<Steps>
  <Step title="Zaloguj się do panelu administratora">
    Przejdź na swoją stronę → dodaj `/administrator` na końcu URL
    Zaloguj się przy użyciu danych administratora
  </Step>

  <Step title="Utwórz nowy moduł">
    W górnym menu wybierz **Extensions → Modules** (Joomla 4) lub **Content → Site Modules** (Joomla 5)
    Kliknij **New** (Nowy) w lewym górnym rogu
  </Step>

  <Step title="Wybierz typ modułu">
    Znajdź i wybierz **Custom** (w Joomla 3: Custom HTML)
    Jeśli nie widzisz tej opcji, może być nazwana **HTML**
  </Step>

  <Step title="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)
  </Step>

  <Step title="Wklej kod widgetu">
    W trybie HTML wklej kod widgetu:

    ```html theme={null}
    <script async src="https://widget.wenetasystent.ai/?code=TWOJ_KOD"></script>
    ```
  </Step>

  <Step title="Ustaw gdzie ma się wyświetlać">
    Przewiń w dół do sekcji **Menu Assignment**
    Wybierz **On all pages** (Na wszystkich stronach)
  </Step>

  <Step title="Zapisz i sprawdź">
    Ustaw **Status** na **Published** (Opublikowany)
    Kliknij **Save & Close** (Zapisz i zamknij)
    Odśwież swoją stronę — widget powinien się pojawić
  </Step>
</Steps>

<Tip>
  Ta metoda działa z każdym szablonem Joomla i automatycznie dodaje widget do wszystkich stron!
</Tip>

## Metoda 2: Edycja szablonu

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

<Warning>
  Ta metoda wymaga edycji plików szablonu. Zmiany mogą zniknąć po aktualizacji szablonu. Zalecamy **Metodę 1** jako bardziej bezpieczną.
</Warning>

<Steps>
  <Step title="Przejdź do edytora szablonów">
    W panelu administratora wybierz **System** → **Site Templates** (Szablony witryny)
    Kliknij na aktywny szablon (ten oznaczony gwiazdką lub napisem "Default")
  </Step>

  <Step title="Znajdź plik index.php">
    W lewym panelu (lista plików) znajdź i kliknij **index.php**
    To główny plik szablonu
  </Step>

  <Step title="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:

    ```html theme={null}
    <!-- Asystent AI widget -->
    <script async src="https://widget.wenetasystent.ai/?code=TWOJ_KOD"></script>
    ```
  </Step>

  <Step title="Zapisz plik">
    Kliknij **Save** (Zapisz) lub **Save & Close**
    Odśwież swoją stronę — widget powinien się pojawić
  </Step>
</Steps>

## Najczęstsze problemy

<AccordionGroup>
  <Accordion title="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)
  </Accordion>

  <Accordion title="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)
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Wklejam skrypt, a on się nie wyświetla (edytor usuwa kod)">
    Kod `<script>` mogą usuwać **dwa niezależne mechanizmy**: edytor TinyMCE (domyślny edytor Joomla) oraz filtry tekstu Joomla. Jeśli kod znika po zapisaniu, przejdź poniższe kroki.

    **1. Najpewniejsze rozwiązanie — wyłącz edytor na czas wklejania:**

    * Przejdź do **System → Global Configuration → Site** i ustaw **Default Editor** na **Editor - None** (albo zmień edytor tylko dla siebie: **Users → Manage → Twój profil → Basic Settings → Editor**)
    * Otwórz moduł, wklej kod widgetu, zapisz
    * Przywróć TinyMCE — zapisany kod już nie zniknie

    **2. Albo pozwól na element `script` w TinyMCE:**

    * Przejdź do **System → Plugins** i otwórz **Editor - TinyMCE**
    * W zestawie uprawnień (Set) przypisanym do Twojej grupy znajdź pole **Prohibited Elements** — domyślnie zawiera `script,applet,iframe`. Usuń z listy `script`
    * Do pola **Extended Valid Elements** dopisz: `script[src|type|async|defer]`
    * Zapisz i wklejaj kod w trybie źródłowym (przycisk **\<>**)

    **3. Sprawdź też filtry tekstu Joomla:**

    * Przejdź do **System → Global Configuration → Text Filters**
    * Dla grupy **Super Users** ustaw **Filter Type** na **No Filtering**
    * Włączaj "No Filtering" tylko dla zaufanych grup administracyjnych — nigdy dla Public/Registered

    <Note>
      TinyMCE filtruje kod **niezależnie** od ustawień Text Filters — jeśli kod nadal znika, upewnij się, że poprawiłeś oba miejsca (kroki 2 i 3), albo po prostu użyj kroku 1.
    </Note>
  </Accordion>

  <Accordion title="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).
  </Accordion>

  <Accordion title="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ń.
  </Accordion>
</AccordionGroup>

## 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 `&lt;script async src="https://widget...`
* Zapisz plik
* Wyczyść cache

## Gotowy kod do skopiowania

```html theme={null}
<!-- Asystent AI widget -->
<script async src="https://widget.wenetasystent.ai/?code=TWOJ_KOD"></script>
```

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