WordPress-chatbot-lisäosa
Käytä virallista ChattyBox WordPress -lisäosaa, kun haluat koodittoman asennuksen, joka lataa isännöidyn widgetin muokkaamatta teematiedostoja. Tämä opas käsittelee käytännön määrityksiä. WordPressin tekoälychatbot-sivu selittää sisältö- ja indeksointistrategian, kun taas WordPress-lisäosan esittelysivu tarjoaa tuotteesta yleiskatsauksen.
Ennen asennusta
Suorita ensin Aloittaminen -prosessi: yhdistä julkinen WordPress-URL-osoitteesi, tarkista indeksoidut sivut ja varmista edustavat vastaukset Test Chat -osiossa. Luo sitten selaimessa turvallinen julkinen avain kohdassa Public Keys ja kopioi se projektin Embed-välilehdeltä.
Lisäosan asentaminen
Lisäosalla ei ole Composer-, npm- tai build-vaiheen riippuvuuksia. Se jaellaan tällä hetkellä julkisesta ChattyBoxin GitHub-repositoriosta, ei WordPress.org Plugin Directorysta, joten käytä WordPressin Upload Plugin -toimintoa hakemistosta hakemisen sijaan. Hakemistosta hallittuja automaattisia päivityksiä ei ole vielä saatavilla. Kiinnitetty 0.2.0-paketti ilmoittaa WordPress 5.8+ ja PHP 7.4+; testaa käyttämäsi WordPress-/PHP-versio ja teema, sillä metadata ei takaa jokaista uudempaa versiota.
- Lataa ChattyBoxin WordPress-lisäosan version 0.2.0 kiinnitetty ZIP tai tutustu julkiseen lähderepositorioon.
- Avaa WordPressissä Plugins > Add New > Upload Plugin, lataa ZIP ja aktivoi ChattyBox AI Chatbot. Jos asennat palvelimelle manuaalisesti, kopioi lisäosan hakemisto ensin kohteeseen
wp-content/plugins/. - Avaa Settings > ChattyBox.
- Liitä widgetin julkinen API-avain projektin Embed-välilehdeltä.
- Ota chatbot käyttöön ja tallenna asetukset.
Lisäosa tallentaa widgetin julkisen avaimen ja näyttöasetukset WordPress-asetuksiin. Älä koskaan liitä ChattyBoxin hallintatunnistetietoja lisäosaan.
Latauksen määrittäminen
Tuotannon oletusasetukset ovat:
- Widget-komentosarja:
https://chattybox.ai/widget.js - API-päätepiste: lisäosa määrittää automaattisesti
- Käytössä: pois, kunnes otat chatbotin käyttöön ei-tyhjällä julkisella avaimella
- Kieliohitus: tyhjä; hostattu widget noudattaa projektin locale-käytäntöä (oletuksena Auto)
Auto-tilassa sivun <html lang> voittaa selaimen kielen. Fixed-tila käyttää projektin oletuslokaalia. Lisäosan valinnainen kieliohitus muuttuu data-locale-attribuutiksi ja voittaa vain, kun projekti sallii skriptiohitukset.
Lisäosa lataa widgetin julkisen frontendin pyynnöissä. Se ohittaa tarkoituksella wp-admin-osion, syötteet, REST-pyynnöt ja AJAX-pyynnöt, joten hallinnolliset ja sivuihin liittymättömät vastaukset eivät saa komentosarjaa. Nämä tarkistukset eivät testaa jokaisen frontend-sivun yksityisyyttä tai jäsenyyttä: sulje kassa-, tili-, salasanasuojatut ja jäsenyyssivut erikseen. Lisäosa ei indeksoi tai synkronoi WordPress-sisältöä.
API-päätepiste on sisäänrakennettu tähän lisäosaversioon eikä sitä päätellä avaimesta. Widget script URL -arvon muuttaminen ei muuta päätepistettä; käytä manuaalista katkelmaa, jos Embed-katkelma käyttää toista API-käyttöönottoa. Julkiset avaimet toimivat oletuksena kaikista selainorigineista. Valinnainen origin-rajoitus tarvitsee jokaisen sallitun schemen, isäntänimen ja portin.
Lisäreittien poissulkeminen
Käytä chattybox_load_widget-suodatinta sivustokohtaisesta lisäosasta tai lapsiteemasta, kun julkisella reitillä ei pidä näyttää widgetiä:
add_filter(
'chattybox_load_widget',
static function ( $should_load ) {
return $should_load && ! is_page( array( 'checkout', 'account' ) );
}
);
Pidä lisäosan oletustoiminta ensin käytössä ja lisää sen jälkeen vain sivustosi tarvitsemat reittien poissulkemiset. Testaa suodattimen muuttamisen jälkeen sekä poissuljettu reitti että tavallinen julkinen sivu.
Manuaalinen komentosarjan varavaihtoehto
Käytä lisäosaa oletusratkaisuna. Jos WordPress-tiimisi hallinnoi komentosarjoja jo teeman, lapsiteeman, komentosarjalisäosan tai Google Tag Managerin kautta, voit ladata isännöidyn widgetin sen sijaan manuaalisesti:
<script
src="https://chattybox.ai/widget.js"
data-api-key="YOUR_API_KEY"
data-api-url="YOUR_WIDGET_API_URL"
async
></script>
Älä ota lisäosaa käyttöön ja lisää samaa widget-koodikatkelmaa samanaikaisesti. Valitse yksi lataaja, jotta vierailijat eivät saa päällekkäisiä käynnistimiä.
Asennuksen varmistaminen
Kun olet määrittänyt lisäosan:
- Avaa julkinen WordPress-sivu incognito-ikkunassa.
- Varmista, että käynnistin näkyy kerran.
- Esitä aito vierailijan kysymys.
- Varmista, että tuettu vastaus viittaa indeksoituihin julkisiin WordPress-sivuihin ja että tukematon kysymys käyttää varavastausta, jolla voi olla tyhjät lähteet.
- Tarkista selaimen konsolista puuttuvat
data-api-key,data-api-urltai avainvirheet. - Testaa checkout-, account- tai yksityinen reitti, jos määritit poissulkemisen.
Jatka julkaisun tarkistuslistaan ennen chatbotin julkistamista. Käytä Analytics ja Content Gaps -toimintoa WordPress-sisällön parantamiseen, kun oikeita kysymyksiä alkaa tulla.