WordPress Plugin
Dodaj chatboty AI ChatReact, formularze kontaktowe i akordeony FAQ do swojej strony WordPress za pomocą naszej oficjalnej wtyczki.
Download
Wtyczka jest dostępna w oficjalnym WordPress Plugin Directory, lub jako bezpośrednie pobranie:
Download ChatReact Plugin v1.2.1
Installation
Method 1: WordPress Plugin Directory (Recommended)
- Przejdź do Plugins → Add New w panelu administracyjnym WordPress
- Wyszukaj ChatReact
- Kliknij Install Now, potem Aktywuj
Method 2: Upload via WordPress Admin
- Pobierz plik ZIP wtyczki powyżej
- Przejdź do Plugins → Add New → Upload Plugin
- Wybierz plik ZIP i kliknij Install Now
- Kliknij Activate Plugin
Method 3: Manual Upload via FTP
- Rozpakuj plik ZIP
- Prześlij folder
chatreactdo/wp-content/plugins/ - Przejdź do Plugins w panelu administracyjnym WordPress
- Znajdź "ChatReact" i kliknij Aktywuj
Configuration
Po aktywacji otwórz menu ChatReact w pasku bocznym panelu administracyjnego WordPress, aby uzyskać ustawienia i instrukcje dotyczące użycia.
Finding Your Chatbot ID
- Zaloguj się na chatreact.ai
- Otwórz swojego chatbota i przejdź do zakładki Osadź
- Kliknij Kopiuj kod, aby skopiować fragment do osadzenia, lub odczytaj identyfikator z atrybutu
data-chatbot-idw skopiowanym kodzie
Finding Your Form ID
- Zaloguj się na chatreact.ai
- Przejdź do Formularze
- Kliknij Kopiuj kod osadzania przy swoim formularzu (lub otwórz formularz i przełącz się na kartę Osadź)
- Twój identyfikator formularza to wartość
data-form-idw skopiowanym kodzie do osadzenia
Usage Options
Wtyczka oferuje kilka sposobów dodania ChatReact do witryny:
1. Shortcodes
Dodaj na dowolnej stronie, wpisie lub w obszarze widżetów:
Chat Widget:
[chatreact id="YOUR_CHATBOT_ID"]
Opcjonalne atrybuty: language
Contact Form:
[chatreact_form id="YOUR_FORM_ID"]
Opcjonalne atrybuty: language
FAQ Accordion:
[chatreact_faq id="YOUR_CHATBOT_ID"]
Opcjonalne atrybuty: categories, container, language
Ustawienia wizualne, takie jak pozycja, kolory i automatyczne otwieranie, są zarządzane centralnie w panelu ChatReact i stosowane automatycznie na stronie WordPress. Atrybut language jest opcjonalny we wszystkich shortcode'ach — jeśli go pominiesz, język bieżącej strony jest wykrywany automatycznie (działa na stronach wielojęzycznych).
2. Gutenberg Blocks
W edytorze bloków:
- Kliknij +, aby dodać blok
- Wyszukaj "ChatReact"
- Wybierz ChatReact Chat, ChatReact Form lub ChatReact FAQ
- Wprowadź swój identyfikator w ustawieniach bloku
3. Elementor
Jeżeli korzystasz z Elementora:
- Edytuj stronę za pomocą Elementora
- Wyszukaj "ChatReact" w widgetach
- Przeciągnij widget na stronę
- Skonfiguruj go w lewym panelu
4. Widget Assignments (Plugin Settings)
Pokaż chatbota na wybranych stronach — lub na całej witrynie — bez edytowania treści:
- Otwórz menu ChatReact w pasku bocznym administracji
- Na karcie Chat Widget znajdź Widget Assignments
- Kliknij Add Assignment, wybierz stronę lub wpis (lub wybierz Everywhere) i wpisz swój Chatbot ID
- Kliknij Zapisz zmiany
Dla przypisań Everywhere możesz wykluczyć konkretne adresy URL — jeden na linię, z obsługą wildcardów (np. /blog/* lub /checkout) — aby ukryć widżet na stronach docelowych lub w trakcie procesu płatności.
Domyślnie przy przypisywaniu przeszukiwane są tylko Strony. Kliknij przycisk Post Types, aby udostępnić wyszukiwanie innych typów treści (np. Wpisy lub typy niestandardowe).
5. Page-Level Assignment
Przypisz chatbota do pojedynczej strony bezpośrednio z edytora:
- Edytuj dowolną stronę lub wpis
- Znajdź meta box "ChatReact Widget"
- Zaznacz Enable custom widget for this page
- Wprowadź swój Chatbot ID i opcjonalnie wybierz pozycję (Default, Bottom Right, Bottom Left)
- Zapisz stronę
Ten sam meta box oferuje również opcję Disable all widgets on this page, jeśli chcesz całkowicie ukryć ChatReact na niektórych stronach.
Shortcode Examples
Basic Chat Widget
[chatreact id="abc123"]
Chat Widget with a Fixed Language
[chatreact id="abc123" language="de"]
FAQ with Category Filter
[chatreact_faq id="abc123" categories="shipping,returns"]
Styled Contact Form
[chatreact_form id="form123" language="en"]
FAQ Widget: SEO & Caching
SEO-Friendly FAQs
Od wersji 1.1.2 widgety FAQ są renderowane po stronie serwera: Twoje FAQ są częścią HTML strony i zawierają dane strukturalne JSON-LD (schemat FAQPage). Wyszukiwarki i asystenci AI mogą je odczytać bez uruchamiania JavaScript.
llms.txt for AI Crawlers
Wtyczka może udostępniać zawartość FAQ pod adresem yoursite.com/llms.txt, plikiem odkrywanym przez crawlery AI. Jest włączona domyślnie. Aby ją przełączać lub ustawić konkretny Chatbot ID dla tego pliku, przejdź do ChatReact → FAQ Widget → Cache & SEO Settings.
FAQ Caching
Dane FAQ są buforowane na serwerze w celu szybkiego ładowania stron. W ChatReact → FAQ Widget → Cache & SEO Settings można:
- Ustawić Cache Duration — 1, 3, 6 (zalecane), 12 lub 24 godziny, lub wyłączyć buforowanie
- Kliknąć Clear Cache, aby natychmiast odświeżyć FAQ
Cache jest również automatycznie oczyszczany zawsze, gdy FAQ zmieniają się w panelu ChatReact.
Supported Languages
Wtyczka obsługuje 24 języki UE:
- bułgarski, chorwacki, czeski, duński, niderlandzki, 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
Od wersji 1.2.0 tłumaczenia dla wszystkich 24 języków są dołączone do wtyczki. Język widgetu jest wykrywany automatycznie na podstawie bieżącej strony, więc witryny wielojęzyczne działają bez dodatkowych ustawień — użyj atrybutu language w shortcode tylko jeśli chcesz wymusić konkretny język.
Troubleshooting
Widget Not Appearing
- Sprawdź, czy Twój Chatbot ID jest poprawny
- Sprawdź, czy chatbot jest aktywny w panelu ChatReact
- Wyczyść wszelkie wtyczki buforujące strony (patrz niżej)
- Sprawdź konsolę przeglądarki pod kątem błędów JavaScript
Caching Plugin Compatibility
Wtyczka jest w pełni kompatybilna z popularnymi wtyczkami do buforowania i optymalizacji, w tym WP Rocket, LiteSpeed Cache, Autoptimize i WP Super Cache. Wtyczka automatycznie zapobiega minifikacji lub buforowaniu 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 buforującej
- Wyłącz
chatreactz minifikacji/łączenia JS w ustawieniach wtyczki buforującej - Wtyczka używa atrybutów
data-api-urljako zapasowego mechanizmu zapewniającego poprawną komunikację z API
FAQs Not Updating
Jeżeli strona pokazuje nieaktualne FAQ, przejdź do ChatReact → FAQ Widget i kliknij Clear Cache. Cache jest również czyszczony automatycznie po edycji FAQ w panelu ChatReact.
Styling Conflicts
Jeśli widżet wygląda nieprawidłowo:
- Widżet korzysta z izolowanego CSS
- Sprawdź reguły CSS
!importantw swoim motywie - Spróbuj tymczasowo wyłączyć inne wtyczki czatu
Multiple Widgets
Możesz używać różnych chatbotów na różnych stronach, podając unikalne identyfikatory w każdym shortcode lub bloku.
CMS Integration (Smart Sitemap)
Począwszy od wersji 1.1.0, wtyczka ChatReact dla WordPress zawiera funkcję Smart Sitemap, która dostarcza crawlerowi ChatReact ustrukturyzowane metadane treści bezpośrednio z Twojej witryny WordPress.
How It Works
- Generate an Integration Key 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ępniać (Strony, Wpisy, Typy niestandardowe)
- Ustaw priorytety (High/Medium/Low) dla każdego typu treści
- Podczas skanowania witryny ChatReact użyje inteligentnej mapy witryny zamiast zwykłego odkrywania linków
Benefits
- Szybsze indeksowanie – bezpośrednia lista URL zamiast odkrywania link po linku
- Świadomość typu treści – crawler wie, czy URL to Strona, Wpis czy Typ niestandardowy
- Indeksowanie oparte na priorytetach – ważne treści (np. Strony) mogą mieć wyższy priorytet niż wpisy na blogu
- Selektywne udostępnianie – udostępniaj tylko wybrane typy treści
- Wykluczanie pojedynczych wpisów – wykluczaj pojedyncze wpisy/strony z mapy witryny za pomocą meta boxa
Priority Levels
| Priority | Default for | Description |
|---|---|---|
| High | Pages | Główne treści biznesowe (O nas, Usługi, Kontakt) |
| Medium | Posts | Artykuły blogowe, aktualności |
| Low | – | Treści uzupełniające |
Security
Punkt końcowy inteligentnej mapy witryny (/wp-json/chatreact/v1/sitemap) jest chroniony Kluczem Integracyjnym. Nie jest widoczny dla wyszukiwarek ani innych crawlerów — tylko ChatReact może uzyskać do niego dostęp z prawidłowym kluczem.
Jeśli wtyczka zabezpieczająca ogranicza WordPress REST API do zalogowanych użytkowników, wersje 1.2.1 i nowsze nadal pozwalają żądaniom ChatReact z prawidłowym Integration Key na dostęp do /wp-json/chatreact/v1/ — wszystkie inne trasy REST pozostają zablokowane. Jeśli zapora sieciowa blokuje punkt końcowy zanim WordPress się załaduje, zezwól tam na /wp-json/chatreact/v1/. Zawsze gdy inteligentna mapa witryny nie jest dostępna, podgląd skanu w panelu ChatReact pokazuje przyczynę i cofa się do publicznej mapy witryny, która ignoruje wybór typów treści.
Excluding Individual Posts
W edytorze WordPress każdy wpis/strona ma meta box ChatReact Widget z opcją "Exclude from ChatReact Sitemap". Zaznaczone wpisy nie pojawią się w inteligentnej mapie witryny.
Requirements
- WordPress 5.8 lub nowszy
- PHP 7.4 lub nowszy
- Konto ChatReact (sign up free)
Changelog
1.2.1
- FIX: Smart sitemap ponownie osiągalna na stronach, które ograniczają REST API do zalogowanych użytkowników — żądania z prawidłowym Integration Key są przepuszczane, więc wybrane typy treści są respektowane podczas skanowania
1.2.0
- NEW: Dołączone tłumaczenia dla wszystkich 24 oficjalnych języków UE
1.1.3
- FIX: Widgety FAQ z jedną kategorią nie pokazują już niepotrzebnego przycisku filtra "All" ani odznak kategorii
1.1.2
- NEW: Renderowanie po stronie serwera dla widgetów FAQ — FAQ są widoczne dla wyszukiwarek i LLM bez JavaScript
- NEW: Dane strukturalne JSON-LD (schemat FAQPage) dla lepszego SEO i wyników rozszerzonych
- NEW: Punkt końcowy llms.txt dla wykrywalności przez crawlery AI
- NEW: Automatyczne czyszczenie cache FAQ po zmianach treści w panelu ChatReact
1.1.1
- FIX: Poprawki tłumaczeń (rumuński, niderlandzki)
1.1.0
- NEW: Smart Sitemap (CMS Integration) — ustrukturyzowane udostępnianie treści crawlerowi ChatReact
- NEW: Zakładka Integration w ustawieniach wtyczki
- NEW: Wybór typów treści z poziomami priorytetów
- NEW: Wykluczanie pojedynczych wpisów z mapy witryny przez meta box
- NEW: Chroniony punkt końcowy REST API dla inteligentnej mapy witryny
- FIX: Pełna kompatybilność z wtyczkami do buforowania (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
- FIX: Problemy z ładowaniem widgetu dla niezalogowanych odwiedzających przy wtyczkach buforujących
1.0.24
- Widget Assignments — przypisywanie chatbotów do stron bezpośrednio z ustawień wtyczki
- Wsparcie bloków Gutenberg
- Integracja z Elementorem
- Tłumaczenia na 24 języki
- Przypisywanie widgetu na poziomie strony
- CHANGED: Ustawienia widgetu są teraz zarządzane centralnie w panelu ChatReact — usunięto atrybuty shortcode
position,primary_coloriauto_open(languagejest nadal obsługiwany)