Liigu põhisisu juurde

WordPressi vestlusroboti plugin

Kasuta ametlikku ChattyBoxi WordPressi pluginat, kui soovid koodivaba paigaldust, mis laadib hostitud vidina ilma teemafaile muutmata. See juhend käsitleb töökorralduslikku seadistamist. WordPressi tehisintellekti vestlusroboti leht selgitab sisu- ja roomamisstrateegiat, samas kui WordPressi plugina tutvustusleht annab tootest kiire ülevaate.

Enne paigaldamist

Viige esmalt lõpule Alustamine: ühendage oma avalik WordPressi URL, vaadake üle indekseeritud lehed ja kontrollige esinduslikke vastuseid jaotises Test Chat. Seejärel looge jaotises Public Keys brauseri jaoks turvaline avalik võti ja kopeerige see projekti Embed vahekaardilt.

Plugina paigaldamine

Plugin ei sõltu Composerist, npm-ist ega ehitusetapist. Seda levitatakse praegu avalikust ChattyBoxi GitHubi hoidlast, mitte WordPress.org-i pluginate kataloogist, seega kasutage kataloogist otsimise asemel WordPressi Upload Plugin-i töövoogu. Kataloogipõhised automaatsed uuendused pole veel saadaval.

  1. Laadige alla ChattyBoxi WordPressi plugina fikseeritud versiooniga 0.2.0 ZIP või tutvuge avaliku lähtekoodihoidlaga.
  2. Avage WordPressis Plugins > Add New > Upload Plugin, laadige ZIP üles ja aktiveerige ChattyBox AI Chatbot. Käsitsi serverisse paigaldamisel kopeerige plugina kataloog esmalt asukohta wp-content/plugins/.
  3. Avage Settings > ChattyBox.
  4. Kleepige projekti Embed vahekaardilt pärit vidina avalik API-võti.
  5. Lubage vestlusrobot ja salvestage sätted.

Plugin salvestab vidina avaliku võtme ja kuvaseaded WordPressi suvanditesse. Ärge kunagi kleepige pluginasse ChattyBoxi haldusmandaati.

Laadimise konfigureerimine

Tootmise vaikeväärtused on järgmised:

  • Vidina skript: https://chattybox.ai/widget.js
  • API lõpp-punkt: plugin konfigureerib selle automaatselt
  • Lokaadi override: tühi; hostitud vidin järgib projekti lokaadipoliitikat (vaikimisi Auto-režiim)

Auto-režiimis võidab lehe <html lang> brauseri keele; Fixed-režiim kasutab projekti vaikimisi lokaati. Plugina lokaadi override muutub data-locale-iks ja toimib ainult siis, kui projekt lubab skripti override’e.

Plugin laadib vidina avaliku esiosa päringute korral. See jätab tahtlikult vahele wp-admin, kanalid, REST-päringud ja AJAX-päringud, nii et haldus- ja lehega mitteseotud vastused ei saa skripti. Need kontrollid ei otsusta iga frontend-lehe privaatsust: checkout-, konto-, paroolikaitse- ja liikmesuslehed vajavad eraldi välistusi.

Avalikud võtmed töötavad brauseri origin’idel vaikimisi. Valikuline piirang jaotises Public Keys > Edit origins nõuab iga soovitud skeemi, hostinime ja pordi lisamist; puuduva või keelatud origin’iga päring tagastab 401 Invalid API key.

Lukustatud 0.2.0 pakett deklareerib WordPress 5.8+ ja PHP 7.4+; testi oma versiooni ja teemat. Plugin on algul välja lülitatud ning kasutab sisseehitatud production API lõpp-punkti; Widget script URL-i muutmine seda ei muuda. Pärast seadete või välistuste muutmist puhastage WordPressi/CDN-i cache ning testige värsket lehelaadimist. Skripti eemaldamine või vidina CSS-iga peitmine ei ole täielik UI teardown ega nõusoleku tagasivõtt.

Täiendavate marsruutide välistamine

Kasutage filtrit chattybox_load_widget saidipõhisest pluginast või alamteemast, kui avalikul marsruudil ei tohiks vidinat näidata:

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

Jätke esmalt plugina vaikekäitumine lubatuks ja lisage seejärel ainult need marsruudierandid, mida teie sait vajab. Pärast filtri muutmist testige nii välistatud marsruuti kui ka tavalist avalikku lehte.

Käsitsi skripti varuvariant

Kasutage pluginat vaikimisi. Kui teie WordPressi meeskond haldab skripte juba teema, alamteema, skriptiplugina või Google Tag Manageri kaudu, saate hostitud vidina selle asemel käsitsi laadida:

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

Ärge lubage pluginat ja lisage samal ajal sama vidina koodilõiku. Valige üks laadija, et külastajad ei saaks topeltkäivitajaid.

Paigalduse kontrollimine

Pärast plugina konfigureerimist:

  • Avage avalik WordPressi leht inkognitoaknas.
  • Kontrollige, et käivitaja ilmub ühe korra.
  • Esitage päris külastaja küsimus.
  • Kontrollige, et vastus sisaldab allikaviiteid avalikele WordPressi lehtedele.
  • Kontrollige brauseri konsoolist puuduvaid data-api-key, data-api-url väärtusi või võtmevigu.
  • Testige checkout-, account- või privaatset marsruuti, kui seadistasite välistuse.

Jätkake enne vestlusroboti väljakuulutamist käivitamise kontroll-loendiga. Kasutage Analytics ja Content Gaps, et pärast päris küsimuste saabumist WordPressi sisu parandada.

Kasutame valikulisi analüütika- ja sildihaldustööriistu, et mõista veebisaidi kasutamist. Valige, kas lubate järgmised tööriistad: Ahrefs Web Analytics, PostHog ja Google Tag Manager. Analüütika väljalülitamisel laaditakse see leht uuesti, et muudatus jõustuks korrektselt. Veebisaidi põhifunktsioonid ja veaseire ei sõltu sellest valikust. Lugege meie privaatsuspoliitikat.