---
title: Jak zainstalować agenta na WordPressie i WooCommerce
description: Trzy sposoby wstawienia kodu na WordPressie, jak agent odczytuje katalog WooCommerce, co zrobić z wtyczkami do buforowania i jak połączyć czat z koszykiem.
section: platforms
keywords: WordPress, WooCommerce, instalacja agenta WordPress, czat AI na stronie, widget czatu WordPress, wtyczka do wstawiania kodu WordPress, footer.php WordPress, agent sprzedaży AI, integracja czatu z koszykiem, jak dodać czat do sklepu, optymalizacja WordPress dla czatu, buforowanie wtyczki WordPress
updated: 2026-09-06
---
Kod na WordPressie można wstawić na trzy sposoby. Wybierz ten, który najbardziej odpowiada Twoim preferencjom edycji plików motywu.

## Sposób 1: Wtyczka do wstawiania kodu (zalecamy)

Najbezpieczniejsza opcja: zmiany nie znikną po aktualizacji motywu.

1.  Zainstaluj dowolną wtyczkę do wstawiania skryptów: WPCode, Insert Headers and Footers, Code Snippets.
2.  Otwórz ustawienia wtyczki i znajdź pole na kod w stopce — zazwyczaj nazywa się ono **Footer** lub **Body (before closing tag)**.
3.  Wklej wiersz z panelu administracyjnego i zapisz.

## Sposób 2: Plik motywu

1.  „Wygląd” → „Edytor plików motywu”.
2.  Otwórz `footer.php`.
3.  Wklej kod przed `</body>`.
4.  Zaktualizuj plik.

Ważne: edytuj motyw potomny. Podczas aktualizacji motywu nadrzędnego plik zostanie nadpisany wraz z Twoim kodem.

## Sposób 3: Przez functions.php

Dla tych, którzy preferują kod. W `functions.php` motywu potomnego:

```php
add_action('wp_footer', function () {
`echo '<script src="https://comag.vibevox.pro/widget.js" data-slug="twój-slug" async></script>';`
});
```

Dokładny wiersz skryptu znajdziesz w panelu administracyjnym, pod przyciskiem „Kopiuj kod”.

## Katalog z WooCommerce

Podaj adres strony w ustawieniach i uruchom analizę. Crawler odczytuje produkty WooCommerce poprzez ustrukturyzowane dane stron: nazwa, cena, dostępność, opis, zdjęcia, kategorie.

Warto wiedzieć:

-   **Produkty wariantowe** trafiają do karty produktu z zakresem cen i cechami.
-   **Ukryte i robocze** nie są odczytywane — i tak powinno być.
-   **Produkty tylko dla zalogowanych** agent nie zobaczy: porusza się po stronie jak zwykły odwiedzający.
-   Jeśli masz eksport produktów do CSV, możesz go załadować w sekcji „Katalog” — czasem jest to szybsze i dokładniejsze niż crawling.

## Koszyk i płatność

W WooCommerce płatności na czacie zazwyczaj się nie włącza: sklep ma własną kasę z dostawą, podatkami i kuponami.

W ustawieniach podaj link do koszyka, najczęściej `https://twoja-domena/cart` lub `/koszyk`. Agent skieruje tam kupującego.

Aby widzieć, które dialogi zamieniają się w zamówienia, dodaj fragment piksela zakupu na stronę „Dziękujemy za zamówienie”. W WooCommerce jest to szablon `checkout/thankyou.php` lub ta sama wtyczka do wstawiania kodu z warunkiem na stronę zamówienia.

## Przycisk na czacie dodaje produkt do koszyka WooCommerce

Karty produktów w odpowiedziach agenta to nie tylko ładne obrazki. Każda z nich zawiera link do strony produktu w Twoim sklepie, a agent potrafi korzystać ze standardowego mechanizmu WooCommerce do dodawania do koszyka: adresu w formie `?add-to-cart=123`.

Kupujący klika przycisk na czacie, produkt trafia do koszyka, a dalej działa Twoja kasa ze wszystkimi wtyczkami do dostawy, kuponów i podatków. Nie są potrzebne żadne integracje ani klucze: mechanizm jest wbudowany w WooCommerce od początku.

Jeśli link prowadzi do strony produktu wariantowego, agent ją otwiera — kupujący musi sam wybrać rozmiar i kolor, i to jest prawidłowe: podstawianie za niego wariantu jest ryzykowne.

Jeszcze jedna rzecz, którą warto wiedzieć: agent widzi stronę, na której otwarty jest czat. Odczytuje on dane produktu — nazwę, SKU, cenę — i odpowiada w kontekście. Odwiedzający jest na karcie produktu i pisze „czy jest coś tańszego?” — agent rozumie, z czym porównać, i proponuje alternatywę z Twojego katalogu, a nie abstrakcyjną poradę.

Główna przyczyna „widżet się nie pojawił” na WordPressie to pamięć podręczna (cache). Po wklejeniu kodu:

1.  Wyczyść pamięć podręczną wtyczki: WP Rocket, W3 Total Cache, LiteSpeed lub innej, której używasz.
2.  Wyczyść pamięć podręczną CDN, jeśli korzystasz z Cloudflare.
3.  Sprawdź stronę w trybie incognito.

Jeśli wtyczka ma włączone „łączenie i opóźnione ładowanie skryptów”, dodaj nasz skrypt do wyjątków: łączenie skryptów zewnętrznych czasem zakłóca ładowanie.

## Jasny i ciemny motyw

Widżet obsługuje oba tryby. W ustawieniach wybiera się motyw jasny, ciemny lub „jak u odwiedzającego” — ten ostatni podąża za ustawieniami systemowymi urządzenia i jest domyślny.

Jest to wygodne, jeśli Twój motyw WordPress ma przełącznik trybu dziennego i nocnego: zostaw „jak u odwiedzającego”, a czat będzie zgodny z tym, co użytkownik już wybrał.

## Wtyczki do buforowania (cache)

## Sprawdzenie

-   Przycisk czatu pojawia się w prawym dolnym rogu na każdej stronie witryny.
-   Pytanie o produkt wyświetla kartę z ceną.
-   Przycisk finalizacji prowadzi do koszyka WooCommerce.
-   Na urządzeniach mobilnych przycisk nie zasłania menu ani koszyka.

## Często zadawane pytania

### Czy potrzebna jest osobna wtyczka Commerce Agents

Nie. Wystarczy wiersz kodu, osobna wtyczka nie jest wymagana ani instalowana.

### Widżet się nie pojawił, co sprawdzić w pierwszej kolejności

Pamięć podręczna (cache): wtyczka do buforowania i CDN. Następnie — czy kod jest wstawiony w stopce, a nie w dowolnym widżecie paska bocznego, oraz czy motyw faktycznie wyświetla `wp_footer()`.

### Czy agent będzie wiedział o zniżkach i kuponach

O kuponach nie: są one stosowane w koszyku WooCommerce. Agent pokazuje ceny, które były widoczne podczas crawlingu, w tym cenę promocyjną, jeśli jest wyświetlana na stronie produktu.

### Czy to spowolni stronę

Skrypt jest asynchroniczny, waży niewiele i nie blokuje renderowania strony. Wpływ na PageSpeed jest minimalny.

### Czy można wyświetlać widżet tylko w sklepie, a nie na blogu

Tak, jeśli wstawisz kod za pomocą wtyczki z warunkami wyświetlania lub w `functions.php` z kontrolą `is_woocommerce()`. W prostym przypadku agent na wszystkich stronach nie przeszkadza: odpowiada również na pytania dotyczące dostawy z bloga.