PradžiaDokumentacija

WordPress Plugin

Pridėkite ChatReact AI pokalbių robotus, kontaktų formas ir DUK akordionus į savo WordPress svetainę su mūsų oficialiu papildiniu.

Atsisiųsti

Papildinys prieinamas oficialiame WordPress Plugin Directory arba kaip tiesioginis atsisiuntimas:

Download ChatReact Plugin v1.2.1

Diegimas

Metodas 1: WordPress Plugin Directory (rekomenduojama)

  1. Eikite į Plugins → Add New savo WordPress administracijoje
  2. Ieškokite ChatReact
  3. Spauskite Install Now, tada Aktyvuoti

Metodas 2: Įkelti per WordPress administraciją

  1. Atsisiųskite aukščiau nurodytą ZIP failą
  2. Eikite į Plugins → Add New → Upload Plugin
  3. Pasirinkite ZIP failą ir spauskite Install Now
  4. Spauskite Activate Plugin

Metodas 3: Rankinis įkėlimas per FTP

  1. Išarchyvuokite ZIP failą
  2. Įkelkite chatreact aplanką į /wp-content/plugins/
  3. Eikite į Plugins WordPress administracijoje
  4. Suraskite "ChatReact" ir spauskite Aktyvuoti

Konfigūracija

Po aktyvavimo atidarykite ChatReact meniu savo WordPress administracijos šoninėje juostoje, kad pasiektumėte nustatymus ir naudojimo instrukcijas.

Kaip rasti savo Chatbot ID

  1. Prisijunkite prie chatreact.ai
  2. Atidarykite savo pokalbių robotą ir eikite į Įterpti skirtuką
  3. Spauskite Kopijuoti kodą, kad nukopijuotumėte įterpimo fragmentą, arba perskaitykite ID iš data-chatbot-id atributo nukopijuotame kode

Kaip rasti savo Form ID

  1. Prisijunkite prie chatreact.ai
  2. Eikite į Formos
  3. Spauskite Kopijuoti įterpimo kodą prie savo formos (arba atidarykite formą ir persijunkite į Įterpti skirtuką)
  4. Jūsų Form ID yra data-form-id reikšmė nukopijuotame įterpimo kode

Naudojimo parinktys

Papildinys siūlo kelis būdus, kaip pridėti ChatReact į savo svetainę:

1. Trumpieji kodai (Shortcodes)

Pridėkite prie bet kurio puslapio, įrašo ar valdiklio srities:

Pokalbių valdiklis:

[chatreact id="YOUR_CHATBOT_ID"]

Pasirenkami atributai: language

Kontaktinė forma:

[chatreact_form id="YOUR_FORM_ID"]

Pasirenkami atributai: language

DUK akordeonas:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Pasirenkami atributai: categories, container, language

Grafikos nustatymai, tokie kaip pozicija, spalvos ir automatinis atidarymas, valdomi centralizuotai jūsų ChatReact skydelyje ir taikomi jūsų WordPress svetainei automatiškai. language atributas yra pasirenkamas visuose trumpuosiuose koduose — jei jo neįrašysite, dabartinė puslapio kalba bus nustatoma automatiškai (veikia su daugiakalbėmis svetainėmis).

2. Gutenberg blokai

Blokų redaktoriuje:

  1. Spauskite + norėdami pridėti bloką
  2. Ieškokite „ChatReact“
  3. Pasirinkite ChatReact Chat, ChatReact Form arba ChatReact FAQ
  4. Įveskite savo ID bloko nustatymuose

3. Elementor

Jei naudojate Elementor:

  1. Redaguokite puslapį su Elementor
  2. Ieškokite „ChatReact“ valdikliuose
  3. Nutempkite valdiklį į puslapį
  4. Konfigūruokite kairėje esančiame skydelyje

4. Valdiklių priskyrimai (Plugin Settings)

Rodykite pokalbių robotą konkrečiuose puslapiuose — arba visoje svetainėje — nieko redaguodami turinyje:

  1. Atidarykite ChatReact meniu savo administracijos šoninėje juostoje
  2. Chat Widget skirtuke suraskite Widget Assignments
  3. Spauskite Add Assignment, pasirinkite puslapį arba įrašą (arba pasirinkite Everywhere) ir įveskite savo Chatbot ID
  4. Spauskite Išsaugoti pakeitimus

Dėl Everywhere priskyrimų galite išskirti tam tikrus URL — po vieną eilutėje, su žvaigždutės palaikymu (pvz. /blog/* arba /checkout) — kad paslėptumėte valdiklį ant nukreipimo puslapių arba atsiskaitymo metu.

Pagal numatytuosius nustatymus priskiriant galima ieškoti tik Puslapių. Spauskite Post Types mygtuką, kad kiti turinio tipai (pvz., Posts ar pasirinktiniai įrašų tipai) taip pat būtų paieškos rezultatuose.

5. Puslapio lygmens priskyrimas

Priskirkite pokalbių robotą vienam puslapiui tiesiogiai iš redaktoriaus:

  1. Redaguokite bet kurį puslapį ar įrašą
  2. Suraskite "ChatReact Widget" meta langelį
  3. Pažymėkite Enable custom widget for this page
  4. Įveskite savo Chatbot ID ir neprivalomai pasirinkite poziciją (Default, Bottom Right, Bottom Left)
  5. Išsaugokite puslapį

Tas pats meta langelis taip pat siūlo Disable all widgets on this page parinktį, jei norite visiškai paslėpti ChatReact tam tikruose puslapiuose.

Trumpųjų kodų pavyzdžiai

Pagrindinis pokalbių valdiklis

[chatreact id="abc123"]

Pokalbių valdiklis su fiksuota kalba

[chatreact id="abc123" language="de"]

DUK su kategorijų filtru

[chatreact_faq id="abc123" categories="shipping,returns"]

Stilizuota kontaktinė forma

[chatreact_form id="form123" language="en"]

DUK valdiklis: SEO ir talpykla

SEO draugiškos DUK

Nuo versijos 1.1.2 DUK valdikliai atvaizduojami serverio pusėje: jūsų DUK yra dalis puslapio HTML ir įtraukti JSON-LD struktūrizuotus duomenis (FAQPage schema). Paieškos varikliai ir AI asistentai gali juos nuskaityti neprivalėdami vykdyti JavaScript.

llms.txt AI naršyklėms

Papildinys gali tiekti jūsų DUK turinį per yoursite.com/llms.txt, atradimo failą, kurį skaito AI naršyklės. Tai įjungta pagal numatytuosius nustatymus. Norėdami perjungti arba nustatyti konkretų Chatbot ID šiam failui, eikite į ChatReact → FAQ Widget → Cache & SEO Settings.

DUK talpyklavimas

DUK duomenys talpinami serveryje, kad puslapiai būtų greitai užkrauti. Skiltyje ChatReact → FAQ Widget → Cache & SEO Settings jūs galite:

  • Nustatyti Cache Duration — 1, 3, 6 (rekomenduojama), 12 arba 24 valandas, arba išjungti talpyklavimą
  • Spauskite Clear Cache, kad nedelsiant atnaujintumėte savo DUK

Talpykla taip pat automatiškai išvaloma kiekvieną kartą, kai jūsų DUK keičiasi ChatReact skydelyje.

Palaikomos kalbos

Papildinys palaiko 24 ES kalbas:

  • Bulgarian, Croatian, Czech, Danish, Dutch, English
  • Estonian, Finnish, French, German, Greek, Hungarian
  • Irish, Italian, Latvian, Lithuanian, Maltese, Polish
  • Portuguese, Romanian, Slovak, Slovenian, Spanish, Swedish

Nuo versijos 1.2.0 visų 24 kalbų vertimai yra įtraukti į papildinį. Valdiklio kalba nustatoma automatiškai pagal dabartinį puslapį, todėl daugiakalbės svetainės veikia iš karto — naudokite language trumpąjį kodą tik jei norite priversti konkrečią kalbą.

Trikčių šalinimas

Valdiklis nerodomas

  1. Patikrinkite, ar jūsų Chatbot ID yra teisingas
  2. Patikrinkite, ar pokalbių robotas yra aktyvus ChatReact skydelyje
  3. Išvalykite bet kokius puslapio talpyklos papildinius (žr. žemiau)
  4. Patikrinkite naršyklės konsolę JavaScript klaidų

Talpyklos papildinių suderinamumas

Papildinys pilnai suderinamas su populiariais talpyklos ir optimizacijos papildiniais, įskaitant WP Rocket, LiteSpeed Cache, Autoptimize ir WP Super Cache. Papildinys automatiškai užkerta kelią šiems įrankiams minifikuoti arba talpinti ChatReact skriptus.

Jei vis dar kyla problemų (pvz., 404 klaidos, valdiklis neįkeliamas neprisijungusiems lankytojams):

  1. Išvalykite savo talpyklos papildinio talpyklą
  2. Išskirkite chatreact iš JS minifikavimo/derinimo talpyklos papildinio nustatymuose
  3. Papildinys naudoja data-api-url atributus kaip atsarginę priemonę, kad užtikrintų teisingą API komunikaciją

DUK neatsinaujina

Jei jūsų svetainėje rodomos pasenusios DUK, eikite į ChatReact → FAQ Widget ir spauskite Clear Cache. Talpykla taip pat išsivalo automatiškai, kai redaguojate savo DUK ChatReact skydelyje.

Stiliaus konfliktai

Jei valdiklis atrodo sulūžęs:

  • Valdiklis naudoja izoliuotus CSS
  • Patikrinkite savo temos CSS !important taisykles
  • Pabandykite laikinai išjungti kitus pokalbių papildinius

Keli valdikliai

Galite naudoti skirtingus pokalbių robotus skirtinguose puslapiuose nurodydami unikalius ID kiekviename trumpajame kode arba bloke.

CMS integracija (Smart Sitemap)

Nuo versijos 1.1.0 ChatReact WordPress papildinys įtraukia Smart Sitemap funkciją, kuri pateikia ChatReact naršyklei struktūrizuotą turinio metaduomenų sąrašą tiesiai iš jūsų WordPress svetainės.

Kaip tai veikia

  1. Generuokite Integration Key ChatReact skydelyje (Knowledge Base → Websites → CMS Integrations)
  2. Įklijuokite raktą į WordPress papildinio nustatymus po Integration skirtuku
  3. Pasirinkite turinio tipus, kuriuos norite dalintis (Pages, Posts, Custom Post Types)
  4. Nustatykite prioritetus (High/Medium/Low) kiekvienam turinio tipui
  5. Kai naršysite savo svetainę, ChatReact automatiškai naudos smart sitemap vietoje įprastos nuorodų paieškos

Privalumai

  • Greitesnis naršymas – tiesioginis URL sąrašas vietoje nuoroda po nuorodos atradimo
  • Turinio tipo žinojimas – naršyklė žino, ar URL yra Puslapis, Įrašas ar Pasirinktinis įrašo tipas
  • Prioritetais grįstas indeksavimas – svarbiam turiniui (pvz., Puslapiai) galima suteikti didesnį svorį nei tinklaraščio įrašams
  • Selektinis dalijimasis – dalinkitės tik norimais turinio tipais
  • Išskyrimas po įrašo – išskirkite atskirus įrašus/puslapius iš sitemap per meta langelį

Prioritetų lygiai

PriorityDefault forDescription
HighPagesPagrindinis verslo turinys (Apie, Paslaugos, Kontaktai)
MediumPostsTinklaraščio straipsniai, naujienos
Low–Papildomas turinys

Saugumas

Smart sitemap galinis taškas (/wp-json/chatreact/v1/sitemap) yra apsaugotas Integration Key. Jis nėra matomas paieškos varikliams ar kitiems naršyklėms — tik ChatReact gali jį pasiekti su teisingu raktu.

Jei saugumo papildinys riboja WordPress REST API prieigą tik prisijungusiems vartotojams, versija 1.2.1 ir vėlesnės vis tiek leidžia ChatReact užklausas su galiojančiu Integration Key į /wp-json/chatreact/v1/ — visi kiti REST maršrutai lieka užblokuoti. Jei užkarda blokuoja galinį tašką dar prieš WordPress užkrovimą, leiskite /wp-json/chatreact/v1/ ten. Kiekvieną kartą, kai smart sitemap negalima pasiekti, nuskaitymo peržiūra ChatReact skydelyje nurodo priežastį ir pereina prie viešo sitemap, kuris ignoruoja jūsų turinio tipų pasirinkimą.

Atskirų įrašų išskyrimas

WordPress redaktoriuje kiekvienas įrašas/puslapis turi ChatReact Widget meta langelį su parinktimi "Exclude from ChatReact Sitemap". Pažymėti įrašai nebus rodomi smart sitemap.

Reikalavimai

  • WordPress 5.8 arba naujesnė versija
  • PHP 7.4 arba naujesnė versija
  • ChatReact paskyra (sign up free)

Keitimų žurnalas (Changelog)

1.2.1

  • FIX: Smart sitemap vėl pasiekiamas svetainėse, kurios riboja REST API prieigą prisijungusiems vartotojams — užklausos su galiojančiu Integration Key praleidžiamos, todėl pasirinkti turinio tipai yra paisomi skenavimo metu

1.2.0

  • NEW: Visų 24 oficialių ES kalbų vertimai pridedami prie papildinio

1.1.3

  • FIX: Vienos kategorijos DUK valdikliai daugiau nerodo nereikalingo "All" filtravimo mygtuko ir kategorijų žymų

1.1.2

  • NEW: Serverio pusės atvaizdavimas DUK valdikliams — DUK matomos paieškos varikliams ir LLM be JavaScript
  • NEW: JSON-LD struktūrizuoti duomenys (FAQPage schema) geresniam SEO ir praturtintiems rezultatams
  • NEW: llms.txt galinis taškas AI naršyklių atrankai
  • NEW: Automatinis DUK talpyklos išvalymas, kai turinys keičiasi ChatReact skydelyje

1.1.1

  • FIX: Vertimų patobulinimai (Romanian, Dutch)

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — struktūrizuotas turinio dalijimasis su ChatReact naršykle
  • NEW: Integration skirtukas papildinio nustatymuose
  • NEW: Turinio tipų pasirinkimas su prioritetų lygiais
  • NEW: Išskyrimas po įrašo iš sitemap per meta langelį
  • NEW: Apsaugotas REST API galinis taškas smart sitemap
  • FIX: Pilnas suderinamumas su talpyklos papildiniais (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
  • FIX: Valdiklio įkėlimo problemos neprisijungusiems lankytojams su talpyklos papildiniais

1.0.24

  • Widget Assignments — priskirkite pokalbių robotus puslapiams tiesiogiai iš papildinio nustatymų
  • Gutenberg blokų palaikymas
  • Elementor integracija
  • 24 kalbų vertimai
  • Puslapio lygmens valdiklio priskyrimas
  • CHANGED: Valdiklio nustatymai dabar tvarkomi centralizuotai ChatReact skydelyje — pašalinti position, primary_color ir auto_open trumpųjų kodų atributai (language vis dar palaikomas)

Tolimesni veiksmai