Wtyczka chatbota WordPress

Użyj oficjalnej wtyczki WordPress ChattyBox, jeśli chcesz instalacji bez kodu, która ładuje hostowany widżet bez edytowania plików motywu. Ten przewodnik obejmuje konfigurację operacyjną. Strona chatbota AI WordPress wyjaśnia strategię treści i indeksowania, a strona docelowa wtyczki WordPress przedstawia produkt w skrócie.

Czy mogę używać ChattyBox na WordPressie bez oznaczenia marki?

Tak. Oficjalna wtyczka ładuje hostowany widżet ChattyBox na Twojej stronie WordPress. Plan Free zachowuje stopkę „Powered by ChattyBox”. W planach Starter, Pro i Business można ją usunąć w sekcji Personalizacja → Oznaczenie ChattyBox, wyłączając Pokaż markę ChattyBox. Opcję opisano w dostosowywaniu widżetu, a plany w cenniku.

Przed instalacją

Najpierw ukończ proces Pierwsze kroki: połącz publiczny adres URL WordPress, przejrzyj zindeksowane strony i zweryfikuj reprezentatywne odpowiedzi w Przetestuj chatbota. W sekcji Instalacja → Klucze i domeny sprawdź istniejący publiczny klucz widżetu lub utwórz nowy; w obu przypadkach sprawdź jego ustawienia originów. Następnie w sekcji Instalacja → Instalacja na stronie wybierz odpowiedni klucz i skopiuj go z fragmentu instalacyjnego.

Instalacja wtyczki

Wtyczka nie ma zależności od Composer, npm ani etapu budowania. Jest obecnie dystrybuowana z publicznego repozytorium ChattyBox na GitHubie, a nie w katalogu wtyczek WordPress.org, dlatego użyj procedury Upload Plugin w WordPressie zamiast wyszukiwania w katalogu. Automatyczne aktualizacje zarządzane przez katalog nie są jeszcze dostępne.

Przypięty pakiet 0.2.0 deklaruje WordPress 5.8+ i PHP 7.4+, testowany do WordPress 6.8; przetestuj własny motyw i wersje, bo metadane nie gwarantują nowszych wydań.

1. Pobierz przypięty plik ZIP wtyczki WordPress ChattyBox 0.2.0 lub przejrzyj publiczne repozytorium kodu źródłowego.
2. W WordPressie otwórz Plugins > Add New > Upload Plugin, prześlij plik ZIP i aktywuj ChattyBox AI Chatbot. W przypadku ręcznej instalacji na serwerze najpierw skopiuj katalog wtyczki do wp-content/plugins/.
3. Otwórz Settings > ChattyBox.
4. Wklej publiczny klucz API widżetu z fragmentu instalacyjnego.
5. Włącz chatbota i zapisz ustawienia.

Wtyczka przechowuje publiczny klucz widżetu i ustawienia wyświetlania w opcjach WordPressa. Nigdy nie wklejaj danych uwierzytelniających zarządzania ChattyBox do wtyczki.

Konfigurowanie ładowania

Domyślne ustawienia produkcyjne:

• Skrypt widżetu: https://chattybox.ai/widget.js
• Punkt końcowy API: konfigurowany automatycznie przez wtyczkę
• Aktywacja: wyłączona do czasu włączenia chatbota z niepustym kluczem publicznym
• Override języka: pusty; hostowany widżet stosuje politykę locale projektu (domyślnie tryb Auto)

W aktualnym kodzie źródłowym hostowanego widżetu tryb Auto próbuje najpierw obsługiwanego języka strony określonego w <html lang>, następnie obsługiwanych języków przeglądarki, skonfigurowanego języka domyślnego i języka angielskiego. Tryb Fixed używa domyślnego locale projektu. Opcjonalny override języka z wtyczki staje się wartością data-locale i ma pierwszeństwo tylko wtedy, gdy projekt zezwala na override’y skryptu. Użyj obsługiwanego kodu locale zapisanego małymi literami; niestandardowy tekst nagłówka i powitania nie jest tłumaczony automatycznie. Jeśli polegasz na tym działaniu, sprawdź wersję loadera wdrażanego osobno.

Punkt końcowy API jest wbudowany w tę wersję wtyczki, a nie odczytywany z klucza. Zmiana Widget script URL nie zmienia tego punktu końcowego. Jeśli fragment instalacyjny witryny wskazuje inne wdrożenie API, użyj zamiast tego ręcznej integracji skryptu. Zdalne adresy URL skryptu muszą używać HTTPS; HTTP jest dozwolone tylko dla lokalnych hostów deweloperskich.

Wtyczka rejestruje widżet podczas żądań frontendu WordPressa związanych z dodawaniem skryptów. Celowo pomija wp-admin, kanały, żądania REST i żądania AJAX; te zabezpieczenia nie sprawdzają każdego rodzaju odpowiedzi ani nie potwierdzają, że każda strona frontendu jest publiczna.

Te zabezpieczenia żądań nie sprawdzają prywatności każdej strony frontendu ani jej statusu członkostwa. W razie potrzeby jawnie wyklucz strony kasy, konta, chronione hasłem i członkowskie. Upewnij się też, że motyw wywołuje skrypty WordPressa w stopce. Wtyczka nie indeksuje ani nie synchronizuje wpisów — indeksowanie treści i jej odświeżanie odbywa się w ChattyBox.

Klucze utworzone bez ograniczeń działają ze wszystkich originów przeglądarki; klucz przygotowany dla witryny może już być ograniczony do jej originu. Opcjonalne ograniczenia w sekcji Instalacja → Klucze i domeny wymagają podania każdego dozwolonego schematu, hosta i portu; dla ograniczonego klucza brak lub niedozwolona wartość efektywnego originu skutkuje odpowiedzią 401 Invalid API key. Gdy nagłówka Origin brakuje, serwer może wyprowadzić origin z prawidłowego nagłówka Referer. Ograniczenia originów to dodatkowe zabezpieczenie, a nie uwierzytelnianie odwiedzających — publiczny klucz przeglądarkowy nie jest sekretem. Przetestuj stronę produkcyjną, nie tylko panel.

Wykluczanie dodatkowych tras

Użyj filtra chattybox_load_widget z wtyczki właściwej dla witryny lub motywu potomnego, gdy publiczna trasa nie powinna wyświetlać widżetu:

add_filter(
    'chattybox_load_widget',
    static function ( $should_load ) {
        return $should_load && ! is_page( array( 'checkout', 'account' ) );
    }
);

Najpierw pozostaw włączone domyślne działanie wtyczki, a następnie dodaj tylko wykluczenia tras potrzebne w Twojej witrynie. Po zmianie filtra przetestuj zarówno wykluczoną trasę, jak i zwykłą stronę publiczną.

Ręczny skrypt zastępczy

Używaj wtyczki jako domyślnej ścieżki. Jeśli Twój zespół WordPress zarządza już skryptami za pomocą motywu, motywu potomnego, wtyczki skryptów lub Google Tag Managera, możesz zamiast tego ręcznie załadować hostowany widżet:

<script
  src="https://chattybox.ai/widget.js"
  data-api-key="YOUR_API_KEY"
  data-api-url="YOUR_WIDGET_API_URL"
  async
></script>

Nie włączaj wtyczki i nie dodawaj jednocześnie tego samego fragmentu widżetu. Wybierz jeden moduł ładujący, aby odwiedzający nie otrzymywali zduplikowanych przycisków uruchamiających.

Weryfikacja instalacji

Po skonfigurowaniu wtyczki:

• Otwórz publiczną stronę WordPress w oknie incognito.
• Potwierdź, że przycisk uruchamiający pojawia się tylko raz.
• Zadaj prawdziwe pytanie odwiedzającego.
• Sprawdź, czy wsparta odpowiedź cytuje zindeksowane publiczne strony WordPress, a przy pytaniu spoza zakresu wyświetla się odpowiedź zastępcza, która może nie mieć źródeł.
• Sprawdź w konsoli przeglądarki, czy nie brakuje data-api-key ani data-api-url i czy nie pojawiają się błędy klucza.
• Przetestuj trasę checkout, account lub prywatną, jeśli skonfigurowałeś wykluczenie.

Po zmianie ustawień lub wykluczeń wyczyść odpowiednią pamięć podręczną WordPress/CDN i sprawdź świeże wczytanie strony. Wykluczenia po stronie serwera nie usuwają widżetu już zainicjowanego podczas nawigacji po stronie działającej po stronie klienta. Na wrażliwych stronach lub po cofnięciu zgody aktywnie zakończ działanie widżetu, korzystając z integracji obsługiwanej przez wdrożoną wersję loadera. Samo usunięcie skryptu ani ukrycie widżetu za pomocą CSS nie zapewnia pełnego zakończenia działania. Zakończenie działania widżetu nie cofnie żądań już przetworzonych przez serwer.

Automatyczny loader wtyczki nie sprawdza zgody odwiedzającego przed dodaniem widżetu do kolejki ładowania. Jeśli zgoda jest wymagana, użyj integracji, która uniemożliwia ładowanie do czasu jej uzyskania, i sprawdź zachowanie po cofnięciu zgody z wdrożoną wersją loadera.

Przejdź do listy kontrolnej uruchomienia przed ogłoszeniem chatbota. W sekcji Rozmowy → Historia, dostępnej w każdym planie, możesz przeglądać rozmowy. Sekcje Rozmowy → Analityka oraz Rozmowy → Pytania bez odpowiedzi są dostępne w planach Pro i Business i pomagają ulepszać treści WordPress na podstawie rzeczywistych pytań.