Jak zainstalować agenta na WordPressie i WooCommerce
Trzy sposoby wstawienia kodu na WordPressie, jak agent odczytuje katalog WooCommerce, co zrobić z wtyczkami do buforowania i jak połączyć czat z koszykiem.
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.
- Zainstaluj dowolną wtyczkę do wstawiania skryptów: WPCode, Insert Headers and Footers, Code Snippets.
- Otwórz ustawienia wtyczki i znajdź pole na kod w stopce — zazwyczaj nazywa się ono Footer lub Body (before closing tag).
- Wklej wiersz z panelu administracyjnego i zapisz.
Sposób 2: Plik motywu#
- „Wygląd” → „Edytor plików motywu”.
- Otwórz
footer.php. - Wklej kod przed
</body>. - 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:
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:
- Wyczyść pamięć podręczną wtyczki: WP Rocket, W3 Total Cache, LiteSpeed lub innej, której używasz.
- Wyczyść pamięć podręczną CDN, jeśli korzystasz z Cloudflare.
- 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.