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.

Przed instalacją

Najpierw ukończ proces Pierwsze kroki: połącz publiczny adres URL WordPress, przejrzyj zindeksowane strony i zweryfikuj reprezentatywne odpowiedzi w Test Chat. Następnie utwórz bezpieczny dla przeglądarki klucz publiczny w Public Keys i skopiuj go z karty Embed projektu.

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 karty Embed projektu.
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ę
• Override języka: pusty; hostowany widżet stosuje politykę locale projektu

Wtyczka ładuje widżet podczas żądań publicznego frontendu. Celowo pomija wp-admin, kanały, żądania REST i żądania AJAX, dzięki czemu skrypt nie jest dodawany do odpowiedzi administracyjnych ani odpowiedzi niezwiązanych ze stronami.

W Auto język strony wygrywa z przeglądarką, Fixed używa defaultu, a override wtyczki działa tylko przy dozwolonym script override. Endpoint API jest wbudowany w tę wersję; zmiana URL skryptu go nie zmienia. Pominięcie wp-admin/feed/REST/AJAX nie chroni wszystkich prywatnych stron frontendu — wyklucz konto, checkout i membership celowo.

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 niewsparta pokazuje fallback, który może nie mieć źródeł.
• Sprawdź w konsoli przeglądarki brak data-api-key, data-api-url lub błędy klucza.
• Przetestuj trasę checkout, account lub prywatną, jeśli skonfigurowałeś wykluczenie.

Po zmianie ustawień/wykluczeń wyczyść odpowiedni cache WordPress/CDN i sprawdź nowe ładowanie strony. CSS ani usunięcie skryptu po inicjalizacji nie jest pełnym teardownem ani cofnięciem zgody.

Przejdź do listy kontrolnej uruchomienia przed ogłoszeniem chatbota. Użyj narzędzi Analytics i Content Gaps, aby ulepszać treści WordPress po pojawieniu się prawdziwych pytań.