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.

Voinko käyttää ChattyBoxia WordPressissä ilman brändäystä?

Kyllä. Virallinen lisäosa lataa isännöidyn ChattyBox-widgetin WordPress-sivustollesi. Free säilyttää ”Powered by ChattyBox” -alatunnisteen. Starter, Pro ja Business sallivat sen poistamisen kohdassa Mukauta → ChattyBox-brändäys kytkemällä Näytä ChattyBoxin brändi -asetuksen pois päältä. Katso asetus widgetin mukauttamisohjeesta ja paketit hinnoittelusivulta.

Ennen asennusta

Suorita ensin Aloittaminen -prosessi: yhdistä julkinen WordPress-URL-osoitteesi, tarkista indeksoidut sivut ja varmista edustavat vastaukset kohdassa Testaa chatbottia. Tarkista julkisen widget-avaimen alkuperäasetukset kohdassa Asenna → Avaimet ja verkkotunnukset ja luo tarvittaessa avain. Valitse sopiva avain kohdassa Asenna → Verkkosivuston asennus ja kopioi se asennuskatkelmasta.

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 vähimmäisvaatimuksiksi WordPress 5.8+ ja PHP 7.4+, ja testausmetatiedot ulottuvat WordPress 6.8:aan. Testaa todelliset WordPress-/PHP-versiosi ja teemasi; metatiedot eivät takaa yhteensopivuutta kaikkien uudempien versioiden kanssa.

1. Lataa ChattyBoxin WordPress-lisäosan version 0.2.0 kiinnitetty ZIP tai tutustu julkiseen lähderepositorioon.
2. 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/.
3. Avaa Settings > ChattyBox.
4. Liitä widgetin julkinen API-avain asennuskatkelmasta.
5. 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öä (Auto oletuksena)

Isännöidyn widgetin nykyisessä lähdekoodissa Auto-tila kokeilee ensin sivun tuettua <html lang> -kieltä, sitten tuettuja selaimen kieliä, määritettyä oletuskieltä ja englantia. Fixed-tila käyttää projektin oletuslokaalia. Lisäosan valinnainen kieliohitus muuttuu data-locale-attribuutiksi ja ohittaa projektin kielivalinnan vain, jos projekti sallii skriptiohitukset. Käytä tuettua pienaakkosin kirjoitettua locale-koodia; mukautettuja otsikko- ja tervetulotekstejä ei käännetä automaattisesti. Tarkista erikseen käyttöön otetun loaderin versio, jos luotat tähän toimintaan.

Lisäosa rekisteröi widgetin WordPressin frontendin enqueue-pyynnöissä ja ohittaa erikseen syötteet, REST-pyynnöt ja AJAX-pyynnöt. Nämä tarkistukset eivät tutki kaikkia vastaustyyppejä eivätkä varmista, että jokainen frontend-sivu on julkinen. Nämä tarkistukset eivät testaa jokaisen frontend-sivun yksityisyyttä tai jäsenyyttä: sulje tarvittaessa kassa-, tili-, salasanasuojatut ja jäsenyyssivut erikseen. Varmista myös, että teemasi tulostaa WordPressin footer-skriptit. Lisäosa ei haravoi tai synkronoi WordPress-sisältöä; sisällön indeksointi ja päivitykset tehdään ChattyBoxissa.

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ä. Jos verkkosivuston asennuskatkelma käyttää toista API-käyttöönottoa, käytä sen sijaan manuaalista skripti-integraatiota. Etäloader-URL-osoitteiden on käytettävä HTTPS:ää (HTTP on sallittu vain paikallisissa kehitysympäristöissä).

Rajoittamattomat avaimet toimivat kaikista selainorigineista; verkkosivustolle valmisteltu avain voi jo olla rajattu kyseisen sivuston originiin. Valinnaiset rajoitukset kohdassa Asenna → Avaimet ja verkkotunnukset edellyttävät jokaisen sallitun protokollan, palvelinnimen ja portin määrittämistä. Jos rajoitetun avaimen pyynnön käytettävä origin puuttuu tai sitä ei sallita, palautetaan 401-virhe Invalid API key. Jos Origin-otsake puuttuu, palvelin voi päätellä originin kelvollisesta Referer-otsakkeesta. Origin-rajoitukset ovat lisäsuojauskeino, eivät kävijöiden todennuskeino, eivätkä julkiset selainavaimet ole salaisuuksia. Testaa oikealla tuotantosivulla, älä vain hallintapaneelissa.

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-url tai avainvirheet.
• Testaa checkout-, account- tai yksityinen reitti, jos määritit poissulkemisen.
• Tyhjennä tarvittaessa WordPressin/CDN:n sivuvälimuisti asetusten tai poissulkemisten muuttamisen jälkeen ja testaa uusi sivulataus. Palvelinpuolen poissulkemiset eivät poista widgetiä, joka on jo alustettu asiakaspuolen navigoinnin aikana. Herkillä reiteillä tai suostumuksen perumisen yhteydessä pura widget aktiivisesti käytössä olevan loaderin tukemalla integraatiolla. Pelkkä skriptin poistaminen tai widgetin piilottaminen CSS:llä ei pura widgetiä kokonaan. Purkaminen ei voi peruuttaa pyyntöjä, jotka palvelin on jo käsitellyt.
• Lisäosan automaattinen loader ei tarkista kävijän suostumusta ennen widgetin lisäämistä latausjonoon. Jos suostumus vaaditaan, käytä integraatiota, joka estää latauksen suostumuksen antamiseen asti, ja varmista suostumuksen perumisen toiminta käytössä olevalla loaderilla.

Jatka julkaisun tarkistuslistaan ennen chatbotin julkistamista. Tarkastele keskusteluja Keskustelut → Historia -näkymässä, joka on käytettävissä kaikissa paketeissa. Pro- tai Business-paketeissa voit käyttää Keskustelut → Analytiikka- ja Keskustelut → Vastaamattomia kysymyksiä -näkymiä kehityskohteiden tarkasteluun, kun oikeita kysymyksiä alkaa tulla.