SākumsDokumentācija

WordPress spraudnis

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

Lejupielāde

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

Download ChatReact Plugin v1.2.0

Instalācija

1. metode: WordPress spraudņu direktorijs (ieteicams)

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

2. metode: 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

3. metode: Manuāla augšupielāde caur FTP

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

Konfigurācija

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

Kā atrast savu Chatbot ID

  1. Piesakieties chatreact.ai
  2. Dodieties uz sava čatbota Dashboard
  3. Noklikšķiniet uz pogas Copy blakus Chatbot ID (redzams augšpusē)

Kā atrast savu Form ID

  1. Piesakieties chatreact.ai
  2. Dodieties uz Forms
  3. Noklikšķiniet Copy embed code uz sava formas (vai atveriet formu un pārslēdzieties uz cilni Embed)
  4. Jūsu Form ID ir data-form-id vērtība kopētajā embed kodā

Lietošanas opcijas

Spraudnis piedāvā vairākus veidus, kā pievienot ChatReact savai vietnei:

1. Shortcodes

Pievienojiet jebkurai lapai, ierakstam vai logrīka zonai:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Papildu atribūti: language

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Papildu atribūti: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Papildu atribūti: categories, container, language

Visual settings such as position, colors, and auto-open are managed centrally in your ChatReact dashboard and apply to your WordPress site automatically. The language attribute is optional on all shortcodes — if you omit it, the current page language is detected automatically (works with multilingual sites).

2. Gutenberg bloki

Bloku redaktorā:

  1. Noklikšķiniet +, lai pievienotu bloku
  2. Meklējiet "ChatReact"
  3. Izvēlieties ChatReact Chat, ChatReact Form, vai ChatReact FAQ
  4. Ievadiet 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ā paneļā

4. Logrīku piešķiršana (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. Cilnē Chat Widget, atrodiet Widget Assignments
  3. Noklikšķiniet Add Assignment, izvēlieties lapu vai ierakstu (vai atlasiet Everywhere), un ievadiet savu Chatbot ID
  4. Noklikšķiniet Save Changes

Par Everywhere piešķīrumiem varat izslēgt konkrētus URL — pa vienam rindā, ar wildcard atbalstu (piem., /blog/* vai /checkout) — lai paslēptu logrīku uz nosēšanās lapām vai norēķinu laikā.

Pēc noklusējuma meklēšanas laikā ir pieejamas tikai Pages. Noklikšķiniet uz pogas Post Types, lai padarītu meklējamu arī citus satura veidus (piem., Posts vai pielāgotus post tipu).

5. Lapas līmeņa piešķiršana

Piešķiriet čatbotu vienai lapai tieši no redaktora:

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

Tajā pašā meta lodziņā ir arī opcija Disable all widgets on this page, ja vēlaties pilnībā paslēpt ChatReact noteiktās lapās.

Shortcode 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ētājprogrammas un AI palīgi tos var nolasīt bez JavaScript izpildes.

llms.txt AI indeksētājiem

Spraudnis var nodrošināt jūsu FAQ saturu pie yoursite.com/llms.txt, atklāšanas failu, ko lasa AI indeksētāji. Tas ir ieslēgts pēc noklusējuma. Lai to pārslēgtu vai iestatītu konkrētu Chatbot ID šim failam, dodieties uz ChatReact → FAQ Widget → Cache & SEO Settings.

FAQ kešošana

FAQ dati tiek kešoti uz jūsu servera ā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 savus FAQ

Kešs tiek arī automātiski notīrīts, kad jūsu FAQ tiek mainīti 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 no kastes — izmantojiet language shortcode atribūtu tikai, ja vēlaties piespiest konkrētu valodu.

Traucējummeklēš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 jebkuras lapu 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āriem 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 izlogotiem apmeklētājiem):

  1. Notīriet jūsu kešošanas spraudņa kešu
  2. Izslēdziet chatreact no JS minifikācijas/ kombinācijas 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 netiek atjauninātas

Ja jūsu vietnē redzamas novecojušas FAQ, dodieties uz ChatReact → FAQ Widget un noklikšķiniet Clear Cache. Kešs tiek arī automātiski notīrīts, kad rediģējat 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 atspējot 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ā shortcode vai blokā.

CMS integrācija (Smart Sitemap)

Sākot no versijas 1.1.0, ChatReact WordPress spraudnis ietver Smart Sitemap funkciju, kas nodrošina ChatReact crawler ar strukturētu satura metadatu tieši no jūsu WordPress vietnes.

Kā tas darbojas

  1. Generate an Integration Key ChatReact panelī (Knowledge Base → Websites → CMS Integrations)
  2. Paste the key WordPress spraudņa iestatījumos cilnē Integration
  3. Select content types, kurus vēlaties koplietot (Pages, Posts, Custom Post Types)
  4. Set priorities (High/Medium/Low) katram satura tipam
  5. Kad tiks veikta jūsu vietnes indeksēšana, ChatReact automātiski izmantos smart sitemap vietā parastai saite-pa-saitei atklāšanai

Ieguvumi

  • Faster crawling – Tieša URL saraksta izmantošana, nevis saite-pa-saitei atklāšana
  • Content type awareness – Crawler zina, vai URL ir Page, Post vai Custom Post Type
  • Priority-based indexing – Svarīgs saturs (piem., Pages) var tikt svērts augstāk nekā emuāra ieraksti
  • Selective sharing – Koplietojiet tikai tos satura tipus, kurus vēlaties
  • Per-post exclusion – Izslēdziet atsevišķus ierakstus/lapas no sitemap caur meta lodziņu

Prioritātes līmeņi

PriorityDefault forDescription
HighPagesCore business content (About, Services, Contact)
MediumPostsBlog articles, news updates
LowSupplementary content

Drošība

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

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 neparādīsies smart sitemap.

Prasības

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

Changelog

1.2.0

  • NEW: Bundled translations for all 24 official EU languages

1.1.3

  • FIX: Single-category FAQ widgets no longer show an unnecessary "All" filter button and category badges

1.1.2

  • NEW: Server-side rendering for FAQ widgets — FAQs are visible to search engines and LLMs without JavaScript
  • NEW: JSON-LD structured data (FAQPage schema) for improved SEO and rich results
  • NEW: llms.txt endpoint for AI crawler discoverability
  • NEW: Automatic FAQ cache purge when content changes in the ChatReact dashboard

1.1.1

  • FIX: Translation improvements (Romanian, Dutch)

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — structured content sharing with ChatReact crawler
  • NEW: Integration tab in plugin settings
  • NEW: Content type selection with priority levels
  • NEW: Per-post exclusion from sitemap via meta box
  • NEW: Protected REST API endpoint for smart sitemap
  • FIX: Full compatibility with caching plugins (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
  • FIX: Widget loading issues for logged-out visitors with caching plugins

1.0.24

  • Widget Assignments — assign chatbots to pages directly from plugin settings
  • Gutenberg blocks support
  • Elementor integration
  • 24 language translations
  • Page-level widget assignment
  • CHANGED: Widget settings are now managed centrally in the ChatReact dashboard — removed the position, primary_color, and auto_open shortcode attributes (language is still supported)

Nākamie soļi