Strona głównaDokumentacja

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)

  1. Przejdź do Plugins → Add New w panelu administracyjnym WordPress
  2. Wyszukaj ChatReact
  3. Kliknij Install Now, potem Aktywuj

Method 2: Upload via WordPress Admin

  1. Pobierz plik ZIP wtyczki powyżej
  2. Przejdź do Plugins → Add New → Upload Plugin
  3. Wybierz plik ZIP i kliknij Install Now
  4. Kliknij Activate Plugin

Method 3: Manual Upload via FTP

  1. Rozpakuj plik ZIP
  2. Prześlij folder chatreact do /wp-content/plugins/
  3. Przejdź do Plugins w panelu administracyjnym WordPress
  4. 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

  1. Zaloguj się na chatreact.ai
  2. Otwórz swojego chatbota i przejdź do zakładki Osadź
  3. Kliknij Kopiuj kod, aby skopiować fragment do osadzenia, lub odczytaj identyfikator z atrybutu data-chatbot-id w skopiowanym kodzie

Finding Your Form ID

  1. Zaloguj się na chatreact.ai
  2. Przejdź do Formularze
  3. Kliknij Kopiuj kod osadzania przy swoim formularzu (lub otwórz formularz i przełącz się na kartę Osadź)
  4. Twój identyfikator formularza to wartość data-form-id w 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:

  1. Kliknij +, aby dodać blok
  2. Wyszukaj "ChatReact"
  3. Wybierz ChatReact Chat, ChatReact Form lub ChatReact FAQ
  4. Wprowadź swój identyfikator w ustawieniach bloku

3. Elementor

Jeżeli korzystasz z Elementora:

  1. Edytuj stronę za pomocą Elementora
  2. Wyszukaj "ChatReact" w widgetach
  3. Przeciągnij widget na stronę
  4. Skonfiguruj go w lewym panelu

4. Widget Assignments (Plugin Settings)

Pokaż chatbota na wybranych stronach — lub na całej witrynie — bez edytowania treści:

  1. Otwórz menu ChatReact w pasku bocznym administracji
  2. Na karcie Chat Widget znajdź Widget Assignments
  3. Kliknij Add Assignment, wybierz stronę lub wpis (lub wybierz Everywhere) i wpisz swój Chatbot ID
  4. 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:

  1. Edytuj dowolną stronę lub wpis
  2. Znajdź meta box "ChatReact Widget"
  3. Zaznacz Enable custom widget for this page
  4. Wprowadź swój Chatbot ID i opcjonalnie wybierz pozycję (Default, Bottom Right, Bottom Left)
  5. 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

  1. Sprawdź, czy Twój Chatbot ID jest poprawny
  2. Sprawdź, czy chatbot jest aktywny w panelu ChatReact
  3. Wyczyść wszelkie wtyczki buforujące strony (patrz niżej)
  4. 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):

  1. Wyczyść cache wtyczki buforującej
  2. Wyłącz chatreact z minifikacji/łączenia JS w ustawieniach wtyczki buforującej
  3. Wtyczka używa atrybutów data-api-url jako 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 !important w 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

  1. Generate an Integration Key w panelu ChatReact (Knowledge Base → Websites → CMS Integrations)
  2. Wklej klucz w ustawieniach wtyczki WordPress w zakładce Integration
  3. Wybierz typy treści, które chcesz udostępniać (Strony, Wpisy, Typy niestandardowe)
  4. Ustaw priorytety (High/Medium/Low) dla każdego typu treści
  5. 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

PriorityDefault forDescription
HighPagesGłówne treści biznesowe (O nas, Usługi, Kontakt)
MediumPostsArtykuł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_color i auto_open (language jest nadal obsługiwany)

Next Steps