AcasăDocumentație

WordPress Plugin

Adăugați chatboți ChatReact AI, formulare de contact și acordioane FAQ pe site-ul dvs. WordPress cu pluginul nostru oficial.

Download

Pluginul este disponibil în WordPress Plugin Directory oficial sau ca descărcare directă:

Download ChatReact Plugin v1.2.1

Installation

Method 1: WordPress Plugin Directory (Recommended)

  1. Accesați Plugins → Add New în panoul de administrare WordPress
  2. Căutați ChatReact
  3. Faceți clic pe Install Now, apoi Activează

Method 2: Upload via WordPress Admin

  1. Descărcați fișierul ZIP al pluginului de mai sus
  2. Accesați Plugins → Add New → Upload Plugin
  3. Alegeți fișierul ZIP și faceți clic pe Install Now
  4. Faceți clic pe Activate Plugin

Method 3: Manual Upload via FTP

  1. Dezarhivați fișierul ZIP
  2. Încărcați folderul chatreact în /wp-content/plugins/
  3. Accesați Plugins în panoul de administrare WordPress
  4. Găsiți "ChatReact" și faceți clic pe Activează

Configuration

După activare, deschideți meniul ChatReact din bara laterală a panoului de administrare WordPress pentru setări și instrucțiuni de utilizare.

Finding Your Chatbot ID

  1. Conectați-vă la chatreact.ai
  2. Deschideți chatbotul și accesați fila Încorporare
  3. Faceți clic pe Copiază codul pentru a copia fragmentul embed sau citiți ID-ul din atributul data-chatbot-id din codul copiat

Finding Your Form ID

  1. Conectați-vă la chatreact.ai
  2. Accesați Formulare
  3. Faceți clic pe Copiază codul de embed pe formularul dvs. (sau deschideți formularul și comutați la fila Încorporare)
  4. ID-ul formularului este valoarea data-form-id din codul embed copiat

Usage Options

Pluginul oferă mai multe modalități de a adăuga ChatReact pe site-ul dvs.:

1. Shortcodes

Adăugați pe orice pagină, articol sau zonă de widget:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Atribute opționale: language

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Atribute opționale: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Atribute opționale: categories, container, language

Setările vizuale precum poziția, culorile și deschiderea automată sunt gestionate central în dashboard-ul ChatReact și se aplică automat pe site-ul dvs. WordPress. Atributul language este opțional pentru toate shortcode-urile — dacă îl omiteți, limba paginii curente este detectată automat (funcționează cu site-uri multilingve).

2. Gutenberg Blocks

În editorul de blocuri:

  1. Faceți clic pe + pentru a adăuga un bloc
  2. Căutați "ChatReact"
  3. Selectați ChatReact Chat, ChatReact Form sau ChatReact FAQ
  4. Introduceți ID-ul în setările blocului

3. Elementor

Dacă folosiți Elementor:

  1. Editați pagina cu Elementor
  2. Căutați "ChatReact" în widget-uri
  3. Trageți widget-ul pe pagină
  4. Configurați în panoul din stânga

4. Widget Assignments (Plugin Settings)

Afișați un chatbot pe pagini specifice — sau pe întreg site-ul — fără a edita conținut:

  1. Deschideți meniul ChatReact din bara laterală a panoului de administrare
  2. În fila Chat Widget, găsiți Widget Assignments
  3. Faceți clic pe Add Assignment, alegeți o pagină sau un articol (sau selectați Everywhere) și introduceți ID-ul Chatbot-ului
  4. Faceți clic pe Salvați modificările

Pentru atribuiri Everywhere puteți exclude anumite URL-uri — câte unul pe linie, cu suport pentru wildcard (de ex. /blog/* sau /checkout) — pentru a ascunde widget-ul pe pagini de tip landing sau în timpul checkout-ului.

Implicit, numai Pages sunt căutabile atunci când faceți atribuiri. Faceți clic pe butonul Post Types pentru a face și alte tipuri de conținut (de ex. Posts sau custom post types) căutabile.

5. Page-Level Assignment

Atribuiți un chatbot unei singure pagini direct din editor:

  1. Editați orice pagină sau articol
  2. Găsiți caseta meta "ChatReact Widget"
  3. Bifați Enable custom widget for this page
  4. Introduceți ID-ul Chatbot-ului și opțional alegeți o poziție (Default, Bottom Right, Bottom Left)
  5. Salvați pagina

Aceeași casetă meta oferă și opțiunea Disable all widgets on this page dacă doriți să ascundeți complet ChatReact pe anumite pagini.

Shortcode Examples

Basic Chat Widget

[chatreact id="abc123"]

Chat Widget with a Fixed Language

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

FAQ with Category Filter

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

Styled Contact Form

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

FAQ Widget: SEO & Caching

SEO-Friendly FAQs

Din versiunea 1.1.2, widget-urile FAQ sunt generate server-side: întrebările frecvente fac parte din HTML-ul paginii și includ date structurate JSON-LD (schema FAQPage). Motoarele de căutare și asistenții AI le pot citi fără a rula JavaScript.

llms.txt for AI Crawlers

Pluginul poate servi conținutul FAQ la yoursite.com/llms.txt, un fișier de descoperire citit de crawleri AI. Este activat implicit. Pentru a-l activa/dezactiva sau pentru a seta un ID Chatbot specific pentru fișier, accesați ChatReact → FAQ Widget → Cache & SEO Settings.

FAQ Caching

Datele FAQ sunt memorate în cache pe serverul dvs. pentru încărcări rapide ale paginilor. Sub ChatReact → FAQ Widget → Cache & SEO Settings puteți:

  • Seta Cache Duration — 1, 3, 6 (recomandat), 12 sau 24 ore, sau dezactiva caching-ul
  • Faceți clic pe Clear Cache pentru a actualiza imediat FAQ-urile

Cache-ul este, de asemenea, purjat automat ori de câte ori FAQ-urile se modifică în dashboard-ul ChatReact.

Supported Languages

Pluginul suportă 24 de limbi UE:

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

Din versiunea 1.2.0, traducerile pentru toate cele 24 de limbi sunt incluse în plugin. Limba widget-ului este detectată automat după pagina curentă, astfel încât site-urile multilingve funcționează din prima — folosiți atributul shortcode language doar dacă doriți să forțați o limbă specifică.

Troubleshooting

Widget Not Appearing

  1. Verificați că ID-ul Chatbot este corect
  2. Verificați dacă chatbotul este activ în dashboard-ul ChatReact
  3. Goliți orice plugin de caching pentru pagini (vedeți mai jos)
  4. Verificați consola browserului pentru erori JavaScript

Caching Plugin Compatibility

Pluginul este complet compatibil cu pluginuri populare de caching și optimizare, inclusiv WP Rocket, LiteSpeed Cache, Autoptimize și WP Super Cache. Pluginul previne automat ca aceste instrumente să minimizeze sau să cache-uiască scripturile ChatReact.

Dacă întâmpinați în continuare probleme (de ex., erori 404, widget care nu se încarcă pentru vizitatorii delogați):

  1. Goliți cache-ul pluginului de caching
  2. Excludeți chatreact din JS minification/combination în setările pluginului de caching
  3. Pluginul folosește atribute data-api-url ca fallback pentru a asigura comunicarea corectă cu API-ul

FAQs Not Updating

Dacă site-ul afișează FAQ-uri învechite, accesați ChatReact → FAQ Widget și faceți clic pe Clear Cache. Cache-ul se golește automat și când editați FAQ-urile în dashboard-ul ChatReact.

Styling Conflicts

Dacă widget-ul arată defect:

  • Widget-ul folosește CSS izolat
  • Verificați regulile CSS !important din tema dvs.
  • Încercați să dezactivați temporar alte pluginuri de chat

Multiple Widgets

Puteți folosi chatboți diferiți pe pagini diferite specificând ID-uri unice în fiecare shortcode sau bloc.

CMS Integration (Smart Sitemap)

Începând cu versiunea 1.1.0, pluginul ChatReact pentru WordPress include o funcție Smart Sitemap care furnizează crawler-ului ChatReact metadate structurate despre conținut direct din site-ul dvs. WordPress.

How It Works

  1. Generate an Integration Key în dashboard-ul ChatReact (Knowledge Base → Websites → CMS Integrations)
  2. Paste the key în setările pluginului WordPress sub fila Integration
  3. Select content types pe care doriți să le partajați (Pages, Posts, Custom Post Types)
  4. Set priorities (High/Medium/Low) pentru fiecare tip de conținut
  5. Când scanăm site-ul dvs., ChatReact va folosi automat smart sitemap în locul descoperirii link-cu-link

Benefits

  • Faster crawling – listă directă de URL-uri în loc de descoperire link-cu-link
  • Content type awareness – crawler-ul știe dacă un URL este Page, Post sau Custom Post Type
  • Priority-based indexing – conținutul important (cum ar fi Pages) poate avea o greutate mai mare decât articolele de blog
  • Selective sharing – partajați doar tipurile de conținut pe care le doriți
  • Per-post exclusion – excludeți postări/pagini individuale din sitemap prin caseta meta

Priority Levels

PriorityDefault forDescription
HighPagesConținut de bază al afacerii (About, Services, Contact)
MediumPostsArticole de blog, actualizări de știri
Low–Conținut suplimentar

Security

Endpoint-ul smart sitemap (/wp-json/chatreact/v1/sitemap) este protejat prin Integration Key. Nu este vizibil pentru motoarele de căutare sau alți crawleri — doar ChatReact îl poate accesa cu cheia corectă.

Dacă un plugin de securitate restricționează REST API-ul WordPress la utilizatori autentificați, versiunile 1.2.1 și ulterioare permit în continuare solicitările ChatReact cu un Integration Key valid către /wp-json/chatreact/v1/ — toate celelalte rute REST rămân blocate. Dacă un firewall blochează endpoint-ul înainte ca WordPress să fie încărcat, permiteți /wp-json/chatreact/v1/ acolo. Ori de câte ori smart sitemap nu poate fi accesat, previzualizarea scanării din dashboard-ul ChatReact afișează motivul și revine la sitemap-ul public, care ignoră selecția tipurilor de conținut.

Excluding Individual Posts

În editorul WordPress, fiecare post/pagină are o casetă meta ChatReact Widget cu o opțiune "Exclude from ChatReact Sitemap". Postările bifate nu vor apărea în smart sitemap.

Requirements

  • WordPress 5.8 sau mai nou
  • PHP 7.4 sau mai nou
  • Un cont ChatReact (sign up free)

Changelog

1.2.1

  • FIX: Smart sitemap din nou accesibil pe site-urile care restricționează REST API la utilizatori autentificați — solicitările cu un Integration Key valid sunt lăsate să treacă, astfel încât tipurile de conținut selectate sunt respectate la scanare

1.2.0

  • NEW: Traduceri incluse pentru toate cele 24 de limbi oficiale UE

1.1.3

  • FIX: Widget-urile FAQ cu o singură categorie nu mai afișează un buton inutil "All" și badge-uri de categorie

1.1.2

  • NEW: Redare server-side pentru widget-urile FAQ — FAQ-urile sunt vizibile motoarelor de căutare și LLM-urilor fără JavaScript
  • NEW: Date structurate JSON-LD (schema FAQPage) pentru SEO îmbunătățit și rezultate bogate
  • NEW: Endpoint llms.txt pentru descoperirea de către crawleri AI
  • NEW: Purjare automată a cache-ului FAQ când conținutul se schimbă în dashboard-ul ChatReact

1.1.1

  • FIX: Îmbunătățiri ale traducerilor (Romanian, Dutch)

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — partajare structurată a conținutului cu crawler-ul ChatReact
  • NEW: Filă Integration în setările pluginului
  • NEW: Selecție de tipuri de conținut cu niveluri de prioritate
  • NEW: Excludere per-post din sitemap prin caseta meta
  • NEW: Endpoint REST API protejat pentru smart sitemap
  • FIX: Compatibilitate completă cu pluginurile de caching (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
  • FIX: Probleme de încărcare a widget-ului pentru vizitatorii delogați cu pluginuri de caching

1.0.24

  • Widget Assignments — atribuiți chatboți paginilor direct din setările pluginului
  • Suport pentru blocuri Gutenberg
  • Integrare Elementor
  • Traduceri în 24 de limbi
  • Atribuire a widget-ului la nivel de pagină
  • CHANGED: Setările widget-ului sunt acum gestionate central în dashboard-ul ChatReact — au fost eliminate atributele shortcode position, primary_color și auto_open (language este încă suportat)

Next Steps