WordPress Plugin

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

Download

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

Download ChatReact Plugin v1.2.0

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 pe Activate

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. Extrageț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 Activate

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. Autentificați-vă la chatreact.ai
2. Accesați Dashboard al chatbotului dumneavoastră
3. Faceți clic pe butonul Copy de lângă Chatbot ID (afișat în partea de sus)

Finding Your Form ID

1. Autentificați-vă la chatreact.ai
2. Accesați Forms
3. Faceți clic pe Copy embed code pentru formularul dumneavoastră (sau deschideți formularul și comutați pe fila Embed)
4. Form ID este valoarea atributului data-form-id din codul embed copiat

Usage Options

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

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

2. Gutenberg Blocks

În editorul de blocuri:

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

3. Elementor

Dacă utilizați Elementor:

1. Editați pagina cu Elementor
2. Căutați „ChatReact” în widgeturi
3. Trageți widgetul 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 întregul site — fără a edita conținutul:

1. Deschideți meniul ChatReact din bara laterală a adminului
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 Chatbot ID
4. Faceți clic pe Save Changes

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

Implicit, doar Pages sunt căutabile la atribuiri. Faceți clic pe butonul Post Types pentru a face și alte tipuri de conținut (de ex. Posts sau tipuri custom) 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 Chatbot ID ș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, widgeturile FAQ sunt randate pe server: FAQ-urile dumneavoastră 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 crawlerele AI. Este activat implicit. Pentru a-l comuta sau pentru a seta un Chatbot ID specific pentru fișier, accesați ChatReact → FAQ Widget → Cache & SEO Settings.

FAQ Caching

Datele FAQ sunt puse în cache pe serverul dumneavoastră pentru încărcări rapide ale paginii. În ChatReact → FAQ Widget → Cache & SEO Settings puteți:

• Seta Cache Duration — 1, 3, 6 (recomandat), 12 sau 24 de ore, sau dezactiva cache-ul
• Faceți clic pe Clear Cache pentru a reîmprospăta imediat FAQ-urile

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

Supported Languages

Pluginul suportă 24 de limbi din UE:

• Bulgară, Croată, Cehă, Daneză, Olandeză, Engleză
• Estonă, Finlandeză, Franceză, Germană, Greacă, Maghiară
• Irlandeză, Italiană, Letonă, Lituaniană, Malteză, Poloneză
• Portugheză, Română, Slovacă, Slovenă, Spaniolă, Suedeză

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

Troubleshooting

Widget Not Appearing

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

Caching Plugin Compatibility

Pluginul este pe deplin compatibil cu pluginuri populare de caching și optimizare, inclusiv WP Rocket, LiteSpeed Cache, Autoptimize și WP Super Cache. Pluginul împiedică automat aceste instrumente să minimizeze sau să cacheze scripturile ChatReact.

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

1. Goliți cache-ul pluginului de caching
2. Excludeți chatreact din minimizarea/combinația JS î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 curăță și automat când editați FAQ-urile în dashboard-ul ChatReact.

Styling Conflicts

Dacă widgetul arată stricat:

• Widgetul folosește CSS izolat
• Verificați regulile CSS !important din tema dumneavoastră
• Î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 dumneavoastră 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 crawl-ați site-ul, ChatReact va folosi automat smart sitemap în locul descoperirii bazate pe link-uri

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

Security

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

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 mare
• PHP 7.4 sau mai mare
• Un cont ChatReact (sign up free)

Changelog

1.2.0

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

1.1.3

• FIX: Widgeturile FAQ cu o singură categorie nu mai afișează butonul de filtru "All" și badge-urile de categorie inutile

1.1.2

• NEW: Server-side rendering pentru widgeturile 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 îmbogățite
• NEW: Endpoint llms.txt pentru descoperirea de către crawlerele AI
• NEW: Curățare automată a cache-ului FAQ când conținutul se modifică î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: Selectarea tipurilor 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 pluginuri de caching (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
• FIX: Probleme de încărcare a widgetului pentru vizitatorii deconectaț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
• 24 traduceri de limbă
• Atribuire widget la nivel de pagină
• CHANGED: Setările widgetului sunt acum gestionate central în dashboard-ul ChatReact — atributele shortcode position, primary_color și auto_open au fost eliminate (language este încă acceptat)

Next Steps

• Widget Customization →
• FAQ Management →
• Form Configuration →