Wtyczka WordPress

Dodaj chatboty AI ChatReact, formularze kontaktowe i akordeony FAQ do swojej strony WordPress za pomocą naszej oficjalnej wtyczki.

Pobierz

Pobierz wtyczkę ChatReact v1.1.0

Instalacja

Metoda 1: Przesyłanie przez Admin WordPress

Pobierz plik ZIP wtyczki powyżej
Przejdź do Wtyczki → Dodaj nową → Wyślij wtyczkę
Wybierz plik ZIP i kliknij Zainstaluj teraz
Kliknij Aktywuj wtyczkę

Metoda 2: Ręczne przesyłanie przez FTP

Rozpakuj plik ZIP
Prześlij folder chatreact do /wp-content/plugins/
Przejdź do Wtyczki w adminie WordPress
Znajdź "ChatReact" i kliknij Aktywuj

Konfiguracja

Po aktywacji przejdź do Ustawienia → ChatReact po instrukcje użytkowania.

Znajdowanie ID Chatbota

Zaloguj się na chatreact.ai
Przejdź do Panelu swojego chatbota
Kliknij przycisk Kopiuj obok ID Chatbota (wyświetlany na górze)

Znajdowanie ID Formularza

Zaloguj się na chatreact.ai
Przejdź do Forms
Wybierz swój formularz
Skopiuj Form ID

Opcje użytkowania

Wtyczka oferuje wiele sposobów dodawania ChatReact na stronę:

1. Shortcodes

Dodaj do dowolnej strony, wpisu lub obszaru widżetów:

Widget czatu:

[chatreact id="YOUR_CHATBOT_ID"]

Opcjonalne atrybuty: position, language, primary_color, auto_open

Formularz kontaktowy:

[chatreact_form id="YOUR_FORM_ID"]

Opcjonalne atrybuty: language

Akordeon FAQ:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Opcjonalne atrybuty: categories, container, language

2. Bloki Gutenberg

W edytorze bloków:

Kliknij + aby dodać blok
Wyszukaj "ChatReact"
Wybierz Chat Widget, Form Widget lub FAQ Widget
Wprowadź swoje ID w ustawieniach bloku

3. Elementor

Jeśli używasz Elementora:

Edytuj swoją stronę z Elementorem
Wyszukaj "ChatReact" w widżetach
Przeciągnij widżet na swoją stronę
Skonfiguruj w lewym panelu

4. Przypisanie na poziomie strony

Przypisz widżety do konkretnych stron bez shortcodes:

Edytuj dowolną stronę lub wpis
Znajdź meta box "ChatReact Widget"
Wybierz typ widżetu
Wprowadź swoje ID
Zapisz stronę

Przykłady shortcodes

Podstawowy widget czatu

[chatreact id="abc123"]

Widget czatu z opcjami

[chatreact id="abc123" position="bottom-left" language="de" auto_open="true"]

FAQ z filtrem kategorii

[chatreact_faq id="abc123" categories="shipping,returns"]

Stylizowany formularz kontaktowy

[chatreact_form id="form123" language="en"]

Obsługiwane języki

Wtyczka obsługuje 24 języki UE:

Bułgarski, Chorwacki, Czeski, Duński, Holenderski, Angielski
Estoński, Fiński, Francuski, Niemiecki, Grecki, Węgierski
Irlandzki, Włoski, Łotewski, Litewski, Maltański, Polski
Portugalski, Rumuński, Słowacki, Słoweński, Hiszpański, Szwedzki

Rozwiązywanie problemów

Widżet się nie pojawia

Sprawdź czy ID Chatbota jest poprawne
Sprawdź czy chatbot jest aktywny w panelu ChatReact
Wyczyść cache wtyczek cache'ujących (patrz poniżej)
Sprawdź konsolę przeglądarki pod kątem błędów JavaScript

Kompatybilność z wtyczkami cache

Wtyczka jest w pełni kompatybilna z popularnymi wtyczkami cache i optymalizacji, w tym WP Rocket, LiteSpeed Cache, Autoptimize i WP Super Cache. Wtyczka automatycznie zapobiega minifikacji lub cache'owaniu skryptów ChatReact przez te narzędzia.

Jeśli nadal występują problemy (np. błędy 404, widżet nie ładuje się dla niezalogowanych użytkowników):

Wyczyść cache wtyczki cache'ującej
Wyklucz chatreact z minifikacji/łączenia JS w ustawieniach wtyczki cache
Wtyczka używa atrybutów data-api-url jako rozwiązania zastępczego, aby zapewnić poprawną komunikację z API

Konflikty stylów

Jeśli widżet wygląda nieprawidłowo:

Widżet używa izolowanego CSS
Sprawdź reguły CSS !important w motywie
Spróbuj tymczasowo wyłączyć inne wtyczki czatu

Wiele widżetów

Możesz używać różnych chatbotów na różnych stronach, określając unikalne ID w każdym shortcode lub bloku.

Integracja CMS (Smart Sitemap)

Począwszy od wersji 1.1.0, wtyczka WordPress ChatReact zawiera funkcję Smart Sitemap, która dostarcza crawler'owi ChatReact ustrukturyzowane metadane treści bezpośrednio ze strony WordPress.

Jak to działa

Wygeneruj klucz integracji w panelu ChatReact (Knowledge Base → Websites → CMS Integrations)
Wklej klucz w ustawieniach wtyczki WordPress w zakładce Integration
Wybierz typy treści, które chcesz udostępnić (strony, wpisy, niestandardowe typy wpisów)
Ustaw priorytety (High/Medium/Low) per typ treści
Gdy skanujesz stronę, ChatReact automatycznie użyje smart sitemap zamiast odkrywania opartego na linkach

Korzyści

Szybsze crawl'owanie — bezpośrednia lista URL zamiast odkrywania link po linku
Świadomość typu treści — crawler wie, czy URL to strona, wpis czy niestandardowy typ wpisu
Indeksowanie oparte na priorytetach — ważna treść (jak strony) może mieć wyższy priorytet niż wpisy blogowe
Selektywne udostępnianie — udostępniaj tylko wybrane typy treści
Wykluczanie per wpis — wyklucz poszczególne wpisy/strony z sitemap za pomocą meta box

Poziomy priorytetów

Priorytet	Domyślnie dla	Opis
High	Strony	Kluczowa treść biznesowa (O nas, Usługi, Kontakt)
Medium	Wpisy	Artykuły blogowe, aktualności
Low	–	Treść uzupełniająca

Bezpieczeństwo

Endpoint smart sitemap (/wp-json/chatreact/v1/sitemap) jest chroniony kluczem integracji. Nie jest widoczny dla wyszukiwarek ani innych crawler'ów — tylko ChatReact może uzyskać do niego dostęp z prawidłowym kluczem.

Wykluczanie poszczególnych wpisów

W edytorze WordPress każdy wpis/strona ma meta box ChatReact Widget z opcją "Exclude from ChatReact Sitemap". Zaznaczone wpisy nie pojawią się w smart sitemap.

Wymagania

WordPress 5.8 lub nowszy
PHP 7.4 lub nowszy
Konto ChatReact (zarejestruj się za darmo)

Historia zmian

1.1.0

NOWE: Smart Sitemap (Integracja CMS) — strukturyzowane udostępnianie treści z crawler'em ChatReact
NOWE: Zakładka Integration w ustawieniach wtyczki
NOWE: Wybór typu treści z poziomami priorytetów
NOWE: Wykluczanie per wpis z sitemap za pomocą meta box
NOWE: Chroniony endpoint REST API dla smart sitemap
POPRAWKA: Pełna kompatybilność z wtyczkami cache (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
POPRAWKA: Problemy z ładowaniem widżetu dla niezalogowanych użytkowników z wtyczkami cache
ZMIANA: Ustawienia widżetu są teraz zarządzane centralnie w panelu ChatReact — usunięto ustawienia pozycji, języka, koloru głównego i automatycznego otwierania z wtyczki

1.0.24

Wsparcie bloków Gutenberg
Integracja Elementor
Tłumaczenia na 24 języki
Przypisanie widżetu na poziomie strony