Wtyczka WordPress

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

Pobieranie

Wtyczka jest dostępna w oficjalnym WordPress Plugin Directory, lub jako bezpośrednie pobranie:

Download ChatReact Plugin v1.2.0

Instalacja

Metoda 1: WordPress Plugin Directory (zalecane)

1. Przejdź do Plugins → Add New w panelu administracyjnym WordPress
2. Wyszukaj ChatReact
3. Kliknij Install Now, a następnie Activate

Metoda 2: Przesyłanie przez panel WordPress

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

Metoda 3: Ręczne przesłanie przez 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 Activate

Konfiguracja

Po aktywacji otwórz menu ChatReact w pasku bocznym panelu administracyjnego WordPress, aby uzyskać ustawienia i instrukcje użytkowania.

Znajdowanie identyfikatora chatbota

1. Zaloguj się na chatreact.ai
2. Przejdź do Dashboard swojego chatbota
3. Kliknij przycisk Copy obok Chatbot ID (wyświetlany u góry)

Znajdowanie identyfikatora formularza

1. Zaloguj się na chatreact.ai
2. Przejdź do Forms
3. Kliknij Copy embed code przy swoim formularzu (lub otwórz formularz i przejdź do zakładki Embed)
4. Twój Form ID to wartość data-form-id w skopiowanym kodzie osadzania

Opcje użycia

Wtyczka oferuje kilka sposobów dodania ChatReact do witryny:

1. Shortcodes

Dodaj do dowolnej strony, wpisu lub obszaru widgetów:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Atrybuty opcjonalne: language

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Atrybuty opcjonalne: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Atrybuty opcjonalne: categories, container, language

2. Bloki Gutenberg

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 ID w ustawieniach bloku

3. Elementor

Jeśli używasz Elementora:

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

4. Przypisania widgetów (ustawienia wtyczki)

Pokaż chatbota na określonych stronach — lub na całej witrynie — bez edycji treści:

1. Otwórz menu ChatReact w pasku bocznym panelu administracyjnego
2. Na karcie Chat Widget znajdź Widget Assignments
3. Kliknij Add Assignment, wybierz stronę lub wpis (lub wybierz Everywhere) i wprowadź swój Chatbot ID
4. Kliknij Save Changes

Dla przypisań Everywhere możesz wykluczyć określone adresy URL — po jednym w wierszu, z obsługą wildcard (np. /blog/* lub /checkout) — aby ukryć widget na stronach docelowych lub podczas finalizacji zamówienia.

Domyślnie tylko Strony są przeszukiwalne podczas przypisywania. Kliknij przycisk Post Types, aby udostępnić wyszukiwanie innym typom treści (np. Posty lub niestandardowe typy wpisów).

5. Przypisanie na poziomie strony

Przypisz chatbota do pojedynczej strony bezpośrednio z edytora:

1. Edytuj dowolną stronę lub wpis
2. Znajdź metabox "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 metabox oferuje również opcję Disable all widgets on this page, jeśli chcesz całkowicie ukryć ChatReact na niektórych stronach.

Przykłady shortcode'ów

Podstawowy widget czatu

[chatreact id="abc123"]

Widget czatu z ustalonym językiem

[chatreact id="abc123" language="de"]

FAQ z filtrem kategorii

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

Stylizowany formularz kontaktowy

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

Widget FAQ: SEO i cache

FAQ przyjazne dla SEO

Od wersji 1.1.2 widgety FAQ renderowane są po stronie serwera: Twoje FAQ są częścią HTML strony i zawierają dane w formacie JSON-LD (schemat FAQPage). Wyszukiwarki i asystenci AI mogą je odczytać bez uruchamiania JavaScript.

llms.txt dla crawlerów AI

Wtyczka może udostępniać zawartość FAQ pod adresem yoursite.com/llms.txt, plik odkrywania czytany przez crawlery AI. Jest włączony domyślnie. Aby go włączyć/wyłączyć lub ustawić konkretny Chatbot ID dla pliku, przejdź do ChatReact → FAQ Widget → Cache & SEO Settings.

Cache FAQ

Dane FAQ są cachowane na Twoim serwerze dla szybkiego ładowania stron. W ChatReact → FAQ Widget → Cache & SEO Settings możesz:

• Ustawić Cache Duration — 1, 3, 6 (zalecane), 12 lub 24 godziny, albo wyłączyć cache
• Kliknąć Clear Cache, aby odświeżyć FAQ natychmiast

Cache jest również automatycznie oczyszczany zawsze, gdy Twoje FAQ zostaną zmienione w panelu ChatReact.

Obsługiwane języki

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ą od razu — użyj atrybutu language shortcode'a tylko jeśli chcesz wymusić konkretny język.

Rozwiązywanie problemów

Widget się nie pojawia

1. Zweryfikuj, czy Twój Chatbot ID jest poprawny
2. Sprawdź, czy chatbot jest aktywny w panelu ChatReact
3. Wyczyść wszelkie wtyczki cache strony (patrz niżej)
4. Sprawdź konsolę przeglądarki pod kątem błędów JavaScript

Kompatybilność z wtyczkami cache

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

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

1. Wyczyść cache wtyczki cache
2. Wyklucz chatreact z minifikacji/łączenia JS w ustawieniach wtyczki cache
3. Wtyczka używa atrybutów data-api-url jako zabezpieczenia, aby zapewnić poprawną komunikację z API

FAQ nie aktualizuje się

Jeśli Twoja strona pokazuje przestarzałe FAQ, przejdź do ChatReact → FAQ Widget i kliknij Clear Cache. Cache jest również czyszczony automatycznie po edycji FAQ w panelu ChatReact.

Konflikty stylów

Jeśli widget wygląda nieprawidłowo:

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

Wiele widgetów

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

Integracja CMS (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.

Jak to działa

1. Wygeneruj 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ępnić (Pages, Posts, Custom Post Types)
4. Ustaw priorytety (High/Medium/Low) dla każdego typu treści
5. Podczas crawlowania Twojej witryny ChatReact będzie automatycznie używać smart sitemap zamiast zwykłego odkrywania linków

Korzyści

• Szybsze crawlowanie – bezpośrednia lista URL zamiast odkrywania link po linku
• Świadomość typu treści – crawler wie, czy URL to Page, Post czy Custom Post Type
• Indeksowanie na podstawie priorytetów – ważne treści (np. Pages) mogą mieć wyższą wagę niż posty na blogu
• Selektywne udostępnianie – udostępniaj tylko wybrane typy treści
• Wykluczenie pojedynczych wpisów – wyklucz pojedyncze posty/strony z sitemap poprzez metabox

Poziomy priorytetów

Bezpieczeństwo

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

Wykluczanie pojedynczych wpisów

W edytorze WordPress każdy post/strona ma metabox ChatReact Widget z opcją "Exclude from ChatReact Sitemap". Zaznaczone posty nie pojawią się w smart sitemap.

Wymagania

• WordPress 5.8 lub nowszy
• PHP 7.4 lub nowszy
• Konto ChatReact (sign up free)

Changelog

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" oraz 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 zmianie 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 poszczególnych wpisów z sitemap poprzez metabox
• NEW: Chroniony endpoint REST API dla smart sitemap
• FIX: Pełna kompatybilność z wtyczkami cache (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
• FIX: Problemy z ładowaniem widgetu dla niezalogowanych użytkowników przy wtyczkach cache

1.0.24

• Widget Assignments — przypisywanie chatbotów do stron bezpośrednio z ustawień wtyczki
• Obsługa bloków Gutenberg
• Integracja z Elementor
• 24 tłumaczenia językowe
• Przypisanie 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)

Kolejne kroki

• Widget Customization →
• FAQ Management →
• Form Configuration →