Neidio i'r prif gynnwys

Ategyn Chatbot WordPress

Defnyddiwch ategyn WordPress swyddogol ChattyBox pan fyddwch eisiau gosodiad heb god sy'n llwytho'r teclyn a gynhelir heb olygu ffeiliau'r thema. Mae'r canllaw hwn yn ymdrin â'r gosodiad gweithredol. Mae'r dudalen chatbot AI WordPress yn esbonio'r strategaeth cynnwys a chropian, tra bod y dudalen lanio ategyn WordPress yn rhoi trosolwg o'r cynnyrch.

A allaf ddefnyddio ChattyBox ar WordPress heb frandio?​

Gallwch. Mae'r ategyn swyddogol yn llwytho teclyn ChattyBox a gynhelir ar eich gwefan WordPress. Mae Free yn cadw'r troedyn “Powered by ChattyBox”. Gall Starter, Pro a Business ei dynnu o dan Addasu → Brandio ChattyBox drwy ddiffodd Dangos brand ChattyBox. Gweler addasu'r teclyn am y gosodiad a phrisiau am y cynlluniau.

Cyn Gosod​

Yn gyntaf, cwblhewch lif Dechrau arni: cysylltwch eich URL WordPress cyhoeddus, adolygwch dudalennau sydd wedi'u mynegeio, a gwiriwch atebion cynrychioliadol yn Profi'r sgwrsfot. Gwiriwch osodiadau tarddiad allwedd widget gyhoeddus a chreu un os oes angen o dan Gosod → Allweddi a pharthau. O dan Gosod → Gosod ar wefan, dewiswch allwedd addas a'i chopïo o'r darn gosod.

Gosod yr Ategyn​

Nid oes gan yr ategyn ddibyniaeth ar Composer, npm na cham adeiladu. Ar hyn o bryd, caiff ei ddosbarthu o storfa GitHub gyhoeddus ChattyBox, nid o Gyfeiriadur Ategion WordPress.org, felly defnyddiwch lif Upload Plugin WordPress yn hytrach na chwilio'r cyfeiriadur. Nid yw diweddariadau awtomatig a reolir gan y cyfeiriadur ar gael eto.

Mae pecyn 0.2.0 wedi'i binio yn datgan WordPress 5.8+ a PHP 7.4+, gyda metadata profi hyd at WordPress 6.8. Profwch eich fersiynau WordPress/PHP a'ch thema go iawn; nid yw'r metadata hwn yn gwarantu cydnawsedd â phob fersiwn newydd.

  1. Lawrlwythwch ZIP ategyn WordPress ChattyBox 0.2.0 wedi'i binio, neu edrychwch ar ystorfa'r cod ffynhonnell cyhoeddus.
  2. Yn WordPress, agorwch Plugins > Add New > Upload Plugin, llwythwch y ZIP i fyny, ac actifadwch ChattyBox AI Chatbot. Ar gyfer gosodiad gweinydd â llaw, copïwch gyfeiriadur yr ategyn i wp-content/plugins/ yn gyntaf.
  3. Agorwch Settings > ChattyBox.
  4. Gludwch allwedd API gyhoeddus y teclyn o'r darn gosod.
  5. Galluogwch y chatbot a chadwch y gosodiadau.

Mae'r ategyn yn storio allwedd gyhoeddus y teclyn a gosodiadau arddangos yn opsiynau WordPress. Peidiwch byth â gludo manylion mewngofnodi rheoli ChattyBox i'r ategyn.

Ffurfweddu Llwytho​

Y rhagosodiadau cynhyrchu yw:

  • Sgript y teclyn: https://chattybox.ai/widget.js
  • Pwynt terfyn API: wedi'i ffurfweddu'n awtomatig gan yr ategyn
  • Wedi'i alluogi: i ffwrdd nes i chi alluogi'r chatbot gydag allwedd gyhoeddus nad yw'n wag
  • Diystyru locale: yn wag; mae'r widget a gynhelir yn dilyn polisi locale y prosiect (Auto yn ddiofyn)

Yng nghod ffynhonnell cyfredol y teclyn a gynhelir, mae Auto yn rhoi cynnig yn gyntaf ar iaith <html lang> y dudalen os caiff ei chefnogi, yna ar ieithoedd y porwr a gefnogir, y locale diofyn wedi'i ffurfweddu, a'r Saesneg. Mae Fixed yn defnyddio locale diofyn y prosiect. Mae diystyru iaith dewisol yr ategyn yn dod yn data-locale ac yn cael blaenoriaeth dim ond os yw'r prosiect yn caniatáu diystyriadau sgript. Defnyddiwch god locale llythrennau bach a gefnogir; ni chaiff testun pennawd/croeso personol ei gyfieithu'n awtomatig. Gwiriwch fersiwn y loader a ddefnyddir ar wahân cyn dibynnu ar yr ymddygiad hwn.

Mae'r endpoint API wedi'i adeiladu i mewn i'r fersiwn hon ac nid yw'n cael ei ganfod o'r allwedd. Nid yw newid Widget script URL yn newid yr endpoint. Os yw darn gosod y wefan yn targedu gwasanaeth API gwahanol, defnyddiwch yr integreiddiad sgript â llaw yn lle hynny. Rhaid i URL loader o bell ddefnyddio HTTPS (caniateir HTTP ar gyfer gwesteiwyr datblygu lleol yn unig).

Mae'r ategyn yn cofrestru'r teclyn ar geisiadau enqueue frontend WordPress ac yn hepgor ffrydiau, ceisiadau REST a cheisiadau AJAX yn benodol. Nid yw'r gwiriadau hyn yn archwilio pob math o ymateb nac yn sefydlu bod pob tudalen frontend yn gyhoeddus. Nid ydynt yn profi preifatrwydd na statws aelodaeth pob tudalen frontend. Eithriwch dudalennau checkout, cyfrif, wedi'u diogelu gan gyfrinair ac aelodaeth yn benodol pan fo angen.

Gwiriwch hefyd fod y thema'n allbynnu sgriptiau troedyn WordPress. Nid yw'r ategyn yn cropian nac yn cydamseru postiadau; mae mynegeio ac adnewyddu cynnwys yn digwydd yn ChattyBox.

Mae allweddi heb gyfyngiadau'n gweithio o unrhyw origin porwr; gall allwedd a baratowyd ar gyfer gwefan fod eisoes wedi'i chyfyngu i origin y wefan honno. Mae cyfyngiadau dewisol o dan Gosod → Allweddi a pharthau yn gofyn am bob protocol, enw gwesteiwr a phorth y bwriedir ei ganiatáu. Ar gyfer allweddi cyfyngedig, mae origin effeithiol y cais sydd ar goll neu heb ei ganiatáu yn dychwelyd 401 Invalid API key; pan fo'r pennawd Origin ar goll, gall y gweinydd ddeillio'r origin o Referer dilys. Mesur diogelwch ychwanegol yw cyfyngiadau origin, nid dilysu ymwelwyr, ac nid yw allweddi porwr cyhoeddus yn gyfrinachau. Profwch ar y dudalen gynhyrchu go iawn, nid yn y dangosfwrdd yn unig.

Eithrio Llwybrau Ychwanegol​

Defnyddiwch yr hidlydd chattybox_load_widget o ategyn penodol i'r wefan neu thema blentyn pan na ddylai llwybr cyhoeddus ddangos y teclyn:

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

Cadwch ymddygiad rhagosodedig yr ategyn wedi'i alluogi yn gyntaf, yna ychwanegwch yr eithriadau llwybrau sydd eu hangen ar eich gwefan yn unig. Profwch lwybr sydd wedi'i eithrio a thudalen gyhoeddus arferol ar ôl newid yr hidlydd.

Fallback Sgript â Llaw​

Defnyddiwch yr ategyn fel y llwybr rhagosodedig. Os yw'ch tîm WordPress eisoes yn rheoli sgriptiau drwy thema, thema blentyn, ategyn sgriptiau, neu Google Tag Manager, gallwch lwytho'r teclyn a gynhelir â llaw yn lle hynny:

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

Peidiwch â galluogi'r ategyn ac ychwanegu'r un darn o god teclyn ar yr un pryd. Dewiswch un llwythwr fel nad yw ymwelwyr yn cael lanswyr dyblyg.

Gwirio'r Gosodiad​

Ar ôl ffurfweddu'r ategyn:

  • Agorwch dudalen WordPress gyhoeddus mewn ffenestr incognito.
  • Cadarnhewch fod y lansiwr yn ymddangos unwaith.
  • Gofynnwch gwestiwn gan ymwelydd go iawn.
  • Gwiriwch fod ateb a gefnogir yn dyfynnu tudalennau WordPress cyhoeddus wedi'u mynegeio, a bod cwestiwn heb gefnogaeth yn dangos fallback a all fod heb ffynonellau.
  • Gwiriwch gonsol y porwr am data-api-key, data-api-url coll neu wallau allwedd.
  • Profwch lwybr checkout, account neu lwybr preifat os gwnaethoch ffurfweddu eithriad.
  • Ar ôl newid gosodiadau neu eithriadau, cliriwch y cache WordPress/CDN perthnasol a phrofwch lwyth tudalen ffres. Nid yw eithriadau ochr y gweinydd yn tynnu teclyn sydd eisoes wedi'i gychwyn wrth lywio ochr y cleient. Ar lwybrau sensitif neu wrth dynnu caniatâd yn ôl, tynnwch y teclyn i lawr yn weithredol drwy integreiddiad a gefnogir gan y loader sydd wedi'i osod ar y wefan. Nid yw tynnu'r sgript na chuddio'r teclyn gyda CSS yn teardown cyflawn. Ni all teardown wrthdroi ceisiadau y mae'r gweinydd eisoes wedi'u prosesu.
  • Nid yw loader awtomatig yr ategyn yn gwirio caniatâd yr ymwelydd cyn rhoi'r teclyn yn y ciw i'w lwytho. Os oes angen caniatâd, defnyddiwch integreiddiad sy'n atal llwytho nes bod caniatâd wedi'i roi, a gwiriwch yr ymddygiad wrth dynnu caniatâd yn ôl gyda'r loader sydd wedi'i ddefnyddio.

Parhewch â'r rhestr wirio lansio cyn cyhoeddi'r chatbot. Defnyddiwch Sgyrsiau → Hanes, sydd ar gael ar bob cynllun, i adolygu sgyrsiau. Ar gynllun Pro neu Business, defnyddiwch Sgyrsiau → Dadansoddeg a Sgyrsiau → Cwestiynau heb eu hateb i adolygu meysydd i'w gwella ar ôl i gwestiynau go iawn gyrraedd.