SākumsDokumentācija

WordPress Plugin

Pievienojiet ChatReact AI čatbotus, kontaktformas un FAQ akordeonus savam WordPress vietnē ar mūsu oficiālo spraudni.

Lejupielāde

Spraudnis ir pieejams oficiālajā WordPress Plugin Directory, vai kā tieša lejupielāde:

Download ChatReact Plugin v1.2.1

Uzstādīšana

Metode 1: WordPress Plugin Directory (Ieteicams)

  1. Dodieties uz Plugins → Add New savā WordPress administrācijā
  2. Meklējiet ChatReact
  3. Noklikšķiniet Install Now, pēc tam Aktivizēt

Metode 2: Augšupielāde caur WordPress administrāciju

  1. Lejupielādējiet spraudņa ZIP failu augstāk
  2. Dodieties uz Plugins → Add New → Upload Plugin
  3. Izvēlieties ZIP failu un noklikšķiniet Install Now
  4. Noklikšķiniet Activate Plugin

Metode 3: Manuāla augšupielāde caur FTP

  1. Izvelciet ZIP failu
  2. Augšupielādējiet chatreact mapi uz /wp-content/plugins/
  3. Dodieties uz Plugins WordPress administrācijā
  4. Atrodiet "ChatReact" un noklikšķiniet Aktivizēt

Konfigurācija

Pēc aktivizācijas atveriet ChatReact izvēlni savas WordPress administrācijas sānjoslā, lai piekļūtu iestatījumiem un lietošanas instrukcijām.

Kā atrast savu Chatbot ID

  1. Piesakieties chatreact.ai
  2. Atveriet savu čatbotu un dodieties uz Iegult cilni
  3. Noklikšķiniet Kopēt kodu, lai kopētu iegulšanas fragmentu, vai nolasiet ID no data-chatbot-id atribūta kopētajā kodā

Kā atrast savu Form ID

  1. Piesakieties chatreact.ai
  2. Dodieties uz Veidlapas
  3. Noklikšķiniet Kopēt iegultā koda uz sava formas (vai atveriet formu un pārslēdzieties uz Iegult cilni)
  4. Jūsu Form ID ir data-form-id vērtība kopētajā iegulšanas kodā

Lietošanas iespējas

Spraudnis piedāvā vairākas iespējas, kā pievienot ChatReact savai vietnei:

1. Shortkodi

Pievienojiet jebkurā lapā, ierakstā vai sānjoslas logrīkā:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Nepieciešamie papildu atribūti: language

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Nepieciešamie papildu atribūti: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Nepieciešamie papildu atribūti: categories, container, language

Vizualie iestatījumi, piemēram, pozīcija, krāsas un automātiskā atvēršana, tiek pārvaldīti centrāli jūsu ChatReact panelī un tiek automātiski lietoti jūsu WordPress vietnē. language atribūts ir izvēles iespēja visiem shortkodiem — ja to izlaidīsiet, pašreizējās lapas valoda tiks noteikta automātiski (darbojas arī daudzvalodu vietnēs).

2. Gutenberg bloki

Bloķu redaktorā:

  1. Noklikšķiniet +, lai pievienotu bloku
  2. Meklējiet "ChatReact"
  3. Izvēlieties ChatReact Chat, ChatReact Form vai ChatReact FAQ
  4. Ierakstiet savu ID bloka iestatījumos

3. Elementor

Ja izmantojat Elementor:

  1. Rediģējiet lapu ar Elementor
  2. Meklējiet "ChatReact" logrīkos
  3. Velciet logrīku uz lapu
  4. Konfigurējiet kreisajā panelī

4. Logrīku piešķīrumi (spraudņa iestatījumi)

Rādiet čatbotu noteiktās lapās — vai visā vietnē — bez satura rediģēšanas:

  1. Atveriet ChatReact izvēlni savā administrācijas sānjoslā
  2. Chat Widget cilnē atrodiet Widget Assignments
  3. Noklikšķiniet Add Assignment, izvēlieties lapu vai ierakstu (vai atlasiet Everywhere), un ievadiet savu Chatbot ID
  4. Noklikšķiniet Saglabāt izmaiņas

Par Everywhere piešķīrumiem jūs varat izslēgt konkrētas URL — pa vienai rindai, ar aizstājējzīmju atbalstu (piem., /blog/* vai /checkout) — lai paslēptu logrīku uz mērķlapām vai no satura pārbaudes lapām.

Pēc noklusējuma piešķiršanai meklējamas ir tikai Pages. Noklikšķiniet uz Post Types pogas, lai padarītu meklējamas arī citas satura tipa vienības (piem., Posts vai pielāgotos ierakstu tipus).

5. Lapas līmeņa piešķīrumi

Piešķiriet čatbotu konkrētai lapai tieši no redaktora:

  1. Rediģējiet jebkuru lapu vai ierakstu
  2. Atrodiet "ChatReact Widget" meta lodziņu
  3. Atzīmējiet Enable custom widget for this page
  4. Ierakstiet savu Chatbot ID un pēc izvēles izvēlieties pozīciju (Default, Bottom Right, Bottom Left)
  5. Saglabājiet lapu

Tas pats meta lodziņš piedāvā arī opciju Disable all widgets on this page, ja vēlaties pilnībā paslēpt ChatReact noteiktās lapās.

Shortkodu piemēri

Pamata Chat Widget

[chatreact id="abc123"]

Chat Widget ar fiksētu valodu

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

FAQ ar kategoriju filtru

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

Stilizēta kontaktforma

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

FAQ logrīks: SEO un kešošana

SEO draudzīgas FAQ

Kopš versijas 1.1.2 FAQ logrīki tiek renderēti servera pusē: jūsu FAQ ir daļa no lapas HTML un ietver JSON-LD strukturētos datus (FAQPage shēma). Meklēšanas dzinēji un AI asistenti var tos nolasīt bez JavaScript izpildes.

llms.txt AI robotiem

Spraudnis var pasniegt jūsu FAQ saturu pie yoursite.com/llms.txt, atklāšanas faila, kuru lasa AI robotprogrammas. Tas ir ieslēgts pēc noklusējuma. Lai to pārslēgtu vai iestatītu specifisku Chatbot ID šim failam, dodieties uz ChatReact → FAQ Widget → Cache & SEO Settings.

FAQ kešošana

FAQ dati tiek kešoti jūsu serverī ātrākai lapu ielādei. Sadaļā ChatReact → FAQ Widget → Cache & SEO Settings jūs varat:

  • Iestatīt Cache Duration — 1, 3, 6 (ieteicams), 12 vai 24 stundas, vai atspējot kešošanu
  • Noklikšķināt Clear Cache, lai nekavējoties atjauninātu savas FAQ

Kešs tiek arī automātiski dzēsts, kad jūsu FAQ mainās ChatReact panelī.

Atbalstītās valodas

Spraudnis atbalsta 24 ES valodas:

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

Kopš versijas 1.2.0 tulkojumi visām 24 valodām ir iekļauti spraudnī. Logrīka valoda tiek noteikta automātiski no pašreizējās lapas, tāpēc daudzvalodu vietnes darbojas bez papildu iestatīšanas — izmantojiet language shortkoda atribūtu tikai tad, ja vēlaties piespiest konkrētu valodu.

Problēmu novēršana

Logrīks neparādās

  1. Pārbaudiet, vai jūsu Chatbot ID ir pareizs
  2. Pārbaudiet, vai čatbots ir aktīvs jūsu ChatReact panelī
  3. Notīriet visus lapas kešošanas spraudņus (skat. zemāk)
  4. Pārbaudiet pārlūkprogrammas konsoli JavaScript kļūdām

Kešošanas spraudņu saderība

Spraudnis pilnībā sadarbojas ar populārajiem kešošanas un optimizācijas spraudņiem, tostarp WP Rocket, LiteSpeed Cache, Autoptimize un WP Super Cache. Spraudnis automātiski novērš šo rīku mēģinājumus minificēt vai kešot ChatReact skriptus.

Ja joprojām rodas problēmas (piem., 404 kļūdas, logrīks neielādējas neautorizētiem apmeklētājiem):

  1. Notīriet sava kešošanas spraudņa kešu
  2. Izslēdziet chatreact no JS minifikācijas/kombinēšanas jūsu kešošanas spraudņa iestatījumos
  3. Spraudnis izmanto data-api-url atribūtus kā rezerves mehānismu, lai nodrošinātu pareizu API saziņu

FAQ neatsvaidzina

Ja jūsu vietnē tiek rādītas novecojušas FAQ, dodieties uz ChatReact → FAQ Widget un noklikšķiniet Clear Cache. Kešs arī tiek dzēsts automātiski, kad rediģējat savas FAQ ChatReact panelī.

Stila konflikti

Ja logrīks izskatās bojāts:

  • Logrīks izmanto izolētu CSS
  • Pārbaudiet tēmas CSS !important noteikumus
  • Mēģiniet pagaidu izslēgt citus čata spraudņus

Vairāki logrīki

Jūs varat izmantot dažādus čatbotus dažādās lapās, norādot unikālus ID katrā shortkodā vai blokā.

CMS integrācija (Smart Sitemap)

Sākot ar versiju 1.1.0, ChatReact WordPress spraudnī ir iekļauta Smart Sitemap funkcija, kas nodrošina ChatReact crawler ar strukturētiem satura metadatiem tieši no jūsu WordPress vietnes.

Kā tas darbojas

  1. Generate an Integration Key ChatReact panelī (Knowledge Base → Websites → CMS Integrations)
  2. Ielīmējiet atslēgu spraudņa iestatījumos zem Integration cilnes
  3. Izvēlieties satura tipus, ko vēlaties kopīgot (Pages, Posts, Custom Post Types)
  4. Iestatiet prioritātes (High/Medium/Low) katram satura tipam
  5. Kad veikts jūsu vietnes crawl, ChatReact automātiski izmantos smart sitemap, nevis parasto saites-pēc-saites atklāšanu

Ieguvumi

  • Ātrāka indeksēšana – tieša URL saraksta izmantošana, nevis saite-pa-saitei atklāšana
  • Satura tipa apziņa – crawler zina, vai URL ir Page, Post vai Custom Post Type
  • Prioritātes balstīta indeksēšana – svarīgs saturs (piem., Pages) var tikt svarots augstāk nekā emuāra ieraksti
  • Selektīva koplietošana – kopīgojiet tikai tos satura tipus, ko vēlaties
  • Atsevišķu ierakstu izslēgšana – izslēdziet atsevišķus ierakstus/lapas no sitemap, izmantojot meta lodziņu

Prioritātes līmeņi

PriorityDefault forDescription
HighPagesCore business content (About, Services, Contact)
MediumPostsBlog articles, news updates
Low–Supplementary content

Drošība

Smart sitemap galapunkts (/wp-json/chatreact/v1/sitemap) ir aizsargāts ar Integration Key. Tas nav redzams meklētājiem vai citiem robotprogrammiem — tikai ChatReact var piekļūt tam ar pareizo atslēgu.

Ja drošības spraudnis ierobežo WordPress REST API tikai pieslēgušiem lietotājiem, versija 1.2.1 un jaunākas joprojām ļauj ChatReact pieprasījumus ar derīgu Integration Key nonākt pie /wp-json/chatreact/v1/ — visi citi REST maršruti paliek bloķēti. Ja ugunsmūris bloķē galapunktu pirms WordPress ielādes, atļaujiet /wp-json/chatreact/v1/ tur. Kad smart sitemap nav sasniedzams, skenēšanas priekšskatījumā ChatReact panelī tiek parādīts iemesls un tiek pārorientēts uz publisko sitemap, kas ignorē jūsu satura tipa izvēli.

Atsevišķu ierakstu izslēgšana

WordPress redaktorā katram ierakstam/lapai ir ChatReact Widget meta lodziņš ar opciju "Exclude from ChatReact Sitemap". Atzīmētie ieraksti netiks iekļauti smart sitemap.

Prasības

  • WordPress 5.8 vai jaunāka
  • PHP 7.4 vai jaunāka
  • ChatReact konts (sign up free)

Changelog

1.2.1

  • FIX: Smart sitemap atkal pieejams vietnēs, kas ierobežo REST API tikai pieslēgtajiem lietotājiem — pieprasījumi ar derīgu Integration Key tiek pieņemti, tādējādi skenēšanas laikā tiek respektēti izvēlētie satura tipi

1.2.0

  • NEW: Iekļauti tulkojumi visām 24 oficiālajām ES valodām

1.1.3

  • FIX: Vienas kategorijas FAQ logrīki vairs nerāda nevajadzīgu "All" filtra pogu un kategoriju žetonus

1.1.2

  • NEW: Servera puses renderēšana FAQ logrīkiem — FAQ redzami meklētājiem un LLM bez JavaScript
  • NEW: JSON-LD strukturētie dati (FAQPage shēma) labākam SEO un rich rezultātiem
  • NEW: llms.txt galapunkts AI robotu atklāšanai
  • NEW: Automātiska FAQ keša iztukšošana, kad saturs mainās ChatReact panelī

1.1.1

  • FIX: Tulkojumu uzlabojumi (Romanian, Dutch)

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — strukturēta satura koplietošana ar ChatReact crawler
  • NEW: Integration cilne spraudņa iestatījumos
  • NEW: Satura tipu atlase ar prioritāšu līmeņiem
  • NEW: Atsevišķu ierakstu izslēgšana no sitemap, izmantojot meta lodziņu
  • NEW: Aizsargāts REST API galapunkts smart sitemap
  • FIX: Pilna saderība ar kešēšanas spraudņiem (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
  • FIX: Logrīku ielādes problēmas neautorizētiem apmeklētājiem ar kešēšanas spraudņiem

1.0.24

  • Widget Assignments — piešķiriet čatbotus lapām tieši no spraudņa iestatījumiem
  • Gutenberg bloku atbalsts
  • Elementor integrācija
  • 24 valodu tulkojumi
  • Lapas līmeņa logrīka piešķīrumi
  • CHANGED: Logrīka iestatījumi tagad tiek pārvaldīti centrāli ChatReact panelī — noņemti position, primary_color, un auto_open shortkodu atribūti (language joprojām tiek atbalstīts)

Nākamie soļi