Paġna ewlenijaDokumentazzjoni

WordPress Plugin

Żid chatbots ChatReact AI, formoli ta' kuntatt, u akkordi FAQ mal-sit WordPress tiegħek bl-plugin uffiċjali tagħna.

Download

Il-plugin huwa disponibbli fid‑WordPress Plugin Directory uffiċjali, jew bħala download dirett:

Download ChatReact Plugin v1.2.1

Installation

Method 1: WordPress Plugin Directory (Recommended)

  1. Mur għal Plugins → Add New fil-amministrazzjoni ta’ WordPress
  2. Fittex ChatReact
  3. Ikklikkja Install Now, imbagħad Attiva

Method 2: Upload via WordPress Admin

  1. Niżżel il-fajl ZIP tal-plugin hawn fuq
  2. Mur għal Plugins → Add New → Upload Plugin
  3. Agħżel il-fajl ZIP u ikklikkja Install Now
  4. Ikklikkja Activate Plugin

Method 3: Manual Upload via FTP

  1. Estratt il-fajl ZIP
  2. Upload l‑folder chatreact għal /wp-content/plugins/
  3. Mur fil‑menu Plugins fl‑amministrazzjoni ta’ WordPress
  4. Sib "ChatReact" u ikklikkja Attiva

Configuration

Wara l‑attivazzjoni, iffetaħ il-menu ChatReact fil‑sidebar tal‑amministrazzjoni tiegħek għal settings u struzzjonijiet ta’ użu.

Finding Your Chatbot ID

  1. Idħol f’chatreact.ai
  2. Iftaħ il‑chatbot tiegħek u mur fit‑tab Embed
  3. Ikklikkja Ikkopja l-Kodiċi biex tikkopja l‑snippet tal‑embed, jew aqra l‑ID mill‑atribut data-chatbot-id fil‑kodice kopjat

Finding Your Form ID

  1. Idħol f’chatreact.ai
  2. Mur għal Formoli
  3. Ikklikkja Ikkopja l-kodiċi tal-embed fuq il‑formol tiegħek (jew iftaħ il‑formol u swiċċja għall‑tab Embed)
  4. L‑Form ID tiegħek huwa l‑valur ta’ data-form-id fil‑kodice tal‑embed kopjat

Usage Options

Il-plugin joffri diversi modi biex iżżid ChatReact mas-sit tiegħek:

1. Shortcodes

Żid għal kwalunkwe paġna, post, jew area ta’ widget:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Attribwiti fakultattivi: language

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Attribwiti fakultattivi: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Attribwiti fakultattivi: categories, container, language

Is-settings viżwali bħall-pożizzjoni, il-kuluri, u l‑auto‑open jinżammu ċentralment fid‑dashboard tal‑ChatReact tiegħek u japplikaw awtomatikament fuq is‑sit WordPress tiegħek. L‑attribwut language huwa fakultattiv fuq il‑kull shortcode — jekk tinjoraħ, il‑lingwa tal‑paġna kurrenti tiġi skoperta awtomatikament (taħdem ma’ siti multilingwi).

2. Gutenberg Blocks

Fil‑editor tal‑blokki:

  1. Ikklikkja + biex iżżid blokk
  2. Fittex "ChatReact"
  3. Agħżel ChatReact Chat, ChatReact Form, jew ChatReact FAQ
  4. Daħħal l‑ID tiegħek fis‑settings tal‑blokk

3. Elementor

Jekk tuża Elementor:

  1. Editja l‑paġna tiegħek bl‑Elementor
  2. Fittex "ChatReact" bejn il‑widgets
  3. Drawwa l‑widget fuq il‑paġna tiegħek
  4. Kkonfigura fil‑panel tax‑xaft tal‑lemin

4. Widget Assignments (Plugin Settings)

Uri chatbot fuq paġni speċifiċi — jew fuq is‑sit kollu — mingħajr ma teditja l‑kontenut:

  1. Iftaħ il‑menu ChatReact fil‑sidebar tal‑amministrazzjoni
  2. Fit‑tab Chat Widget, sib Widget Assignments
  3. Ikklikkja Add Assignment, agħżel paġna jew post (jew agħżel Everywhere), u daħħal l‑Chatbot ID tiegħek
  4. Ikklikkja Issejvja Bidliet

Għal assenjaazzjonijiet Everywhere tista’ teskludi URLs speċifiċi — wieħed għal kull linja, b'appoġġ għal wildcard (eż. /blog/* jew /checkout) — biex taħbi l‑widget fuq landing pages jew waqt il‑checkout.

Bħala default, biss il‑Pages huma mfittxija meta tagħmel assenjaġġ. Ikklikkja l‑buttuna Post Types biex tagħmel tipi oħra ta’ kontenut (eż. Posts jew custom post types) mfittxija wkoll.

5. Page-Level Assignment

Assegna chatbot għall‑paġna waħda direttament mill‑editor:

  1. Editja kwalunkwe paġna jew post
  2. Sib il‑meta box "ChatReact Widget"
  3. Iċċekkja Enable custom widget for this page
  4. Daħħal l‑Chatbot ID tiegħek u fakultattivament agħżel pożizzjoni (Default, Bottom Right, Bottom Left)
  5. Issejvjja l‑paġna

L-istess meta box joffri wkoll l‑opzjoni Disable all widgets on this page jekk trid taħbi kompletament ChatReact fuq paġni speċifiċi.

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

Minn verżjoni 1.1.2, il‑widgets tal‑FAQ jiġu rendizzati server-side: il‑FAQs tiegħek huma parti mill‑HTML tal‑paġna u jinkludu JSON-LD structured data (FAQPage schema). Magni tat‑tfittxija u assistenti AI jistgħu jaqrawhom mingħajr ma jaħdmu JavaScript.

llms.txt for AI Crawlers

Il‑plugin jista’ jservi l‑kontenut tal‑FAQ tiegħek f’yoursite.com/llms.txt, fajl ta’ skoperta li jaqrah crawlers AI. Huwa abilitjat b’default. Biex tibdel dan jew tissettja Chatbot ID speċifiku għal dak il‑fajl, mur f’ChatReact → FAQ Widget → Cache & SEO Settings.

FAQ Caching

Id‑data tal‑FAQ hija cached fuq is‑server tiegħek għal tagħbija mgħaġġla tal‑paġni. Sotto ChatReact → FAQ Widget → Cache & SEO Settings tista’:

  • Tissettja Cache Duration — 1, 3, 6 (rakkomandat), 12, jew 24 siegħa, jew tiddiżattiva l‑cache
  • Ikklikkja Clear Cache biex tirfreshja l‑FAQs tiegħek immedjatament

Il‑cache jiġi wkoll purged awtomatikament kull meta l‑FAQs jinbidlu fid‑dashboard tal‑ChatReact.

Supported Languages

Il‑plugin jappoġġja 24 lingwa tal‑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

Minn verżjoni 1.2.0, it‑traduzzjonijiet għall‑24 lingwa huma inklużi fil‑plugin. Il‑lingwa tal‑widget tiġi skoperta awtomatikament mil‑lingwa tal‑paġna kurrenti, sabiex siti multilingwi jaħdmu minnufih — uża l‑attribwut shortcode language biss jekk trid forsċar lingwa speċifika.

Troubleshooting

Widget Not Appearing

  1. Ivvverifika li l‑Chatbot ID tiegħek huwa korrett
  2. Iċċekkja jekk il‑chatbot huwa attiv fid‑dashboard tal‑ChatReact tiegħek
  3. Ċara kwalunkwe plugins ta’ caching tal‑paġna (ara hawn taħt)
  4. Iċċekkja l‑console tal‑browser għal żbalji JavaScript

Caching Plugin Compatibility

Il‑plugin huwa kompletament kompatibbli ma’ plugins popolari ta’ caching u ottimizzazzjoni inklużi WP Rocket, LiteSpeed Cache, Autoptimize, u WP Super Cache. Il‑plugin awtomatikament jipprevjeni dawn l‑għodod milli jminifikaw jew jaċċessaw scripts ta’ ChatReact.

Jekk għadek tesperjenza problemi (eż., żbalji 404, widget ma tissaħħaġx għal viżitaturi logged-out):

  1. Ċara l‑cache tal‑plugin ta’ caching tiegħek
  2. Escludi chatreact minn JS minification/combination fis‑settings tal‑plugin tal‑caching
  3. Il‑plugin juża attributi data-api-url bħala fallback biex jiżgura komunikazzjoni korretta mal‑API

FAQs Not Updating

Jekk is‑sit tiegħek juri FAQs skaduti, mur f’ChatReact → FAQ Widget u ikklikkja Clear Cache. Il‑cache jitnaddaf wkoll awtomatikament meta teditja l‑FAQs fid‑dashboard tal‑ChatReact.

Styling Conflicts

Jekk il‑widget jidher imkisser:

  • Il‑widget juża CSS izolata
  • Iċċekkja għal regoli CSS !important fit‑tema tiegħek
  • Ippruva tiddiżattiva temporanjament plugins oħra tal‑chat

Multiple Widgets

Tista’ tuża chatbots differenti fuq paġni differenti billi tiddikjara IDs uniċi f’kull shortcode jew blokk.

CMS Integration (Smart Sitemap)

Bħala parti mill‑verżjoni 1.1.0, il‑plugin ChatReact għal WordPress jinkludi funzjoni Smart Sitemap li tipprovdi lill‑crawler ta’ ChatReact metadata strutturata tal‑kontenut direttament mis‑sit WordPress tiegħek.

How It Works

  1. Generate an Integration Key fid‑dashboard tal‑ChatReact (Knowledge Base → Websites → CMS Integrations)
  2. Paste the key fis‑settings tal‑plugin ta’ WordPress taħt it‑tab Integration
  3. Select content types li trid taqsam (Pages, Posts, Custom Post Types)
  4. Set priorities (High/Medium/Low) għal kull tip ta’ kontenut
  5. Meta t‑krawla s‑sit tiegħek, ChatReact se juża awtomatikament is‑smart sitemap minflok skoperta bbażata fuq links

Benefits

  • Faster crawling – Lista ta’ URLs diretta minflok skoperta link‑bi‑link
  • Content type awareness – Il‑crawler jaf jekk URL huwa Page, Post, jew Custom Post Type
  • Priority-based indexing – Kontenut importanti (bħal Pages) jista’ jingħata piż akbar minn blog posts
  • Selective sharing – Aqta’ biss it‑tipi ta’ kontenut li trid
  • Per-post exclusion – Escludi posts/pages individwali mis‑sitemap permezz tal‑meta box

Priority Levels

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

Security

Il‑endpoint tas‑smart sitemap (/wp-json/chatreact/v1/sitemap) huwa protett bl‑Integration Key. Ma jidhirx għamagni tat‑tfittxija jew crawlers oħra — biss ChatReact jista’ jaċċessah bil‑key korrett.

Jekk plugin tas‑sigurtà jirrestrinġi l‑WordPress REST API għal utenti logged‑in, il‑verżjoni 1.2.1 u wara għadha tippermetti talbiet ChatReact b’Integration Key validu lejn /wp-json/chatreact/v1/ — il‑routes REST kollha l‑oħra jibqgħu bl‑ostaklu. Jekk firewall jibbloċċa l‑endpoint qabel WordPress jitħaddem, għaddi /wp-json/chatreact/v1/ hemmhekk. Kull meta s‑smart sitemap ma jkunx aċċessibbli, il‑preview tas‑scan fid‑dashboard tal‑ChatReact jurik ir‑raġuni u jaqbeż għall‑sitemap pubbliku, li jikkonċetta mad‑dejta tal‑kontenut tiegħek.

Excluding Individual Posts

Fl‑editor ta’ WordPress, kull post/paġna għandha meta box ChatReact Widget b’opżjoni "Exclude from ChatReact Sitemap". Il‑posts immarkati ma jidhrux fis‑smart sitemap.

Requirements

  • WordPress 5.8 jew ogħla
  • PHP 7.4 jew ogħla
  • Kont ChatReact (sign up free)

Changelog

1.2.1

  • FIX: Smart sitemap aċċessibbli mill-ġdid fuq siti li jirrestrinġu l‑REST API għal utenti logged‑in — talbiet b’Integration Key validu jiġu permessi, sabiex it‑tipi ta’ kontenut magħżula jiġu rispettati waqt l‑iscan

1.2.0

  • NEW: Traduċċjonijiet inklużi għall‑24 lingwa uffiċjali tal‑UE

1.1.3

  • FIX: Il‑widgets FAQ b’kategorija waħda ma juru aktar buttuna filtru "All" u badges tal‑kategorija mhux meħtieġa

1.1.2

  • NEW: Rendering server‑side għall‑widgets FAQ — il‑FAQs huma viżibbli għal engines tat‑tfittxija u LLMs mingħajr JavaScript
  • NEW: JSON-LD structured data (FAQPage schema) għal SEO aħjar u rich results
  • NEW: llms.txt endpoint għall‑discoverability tal‑crawlers AI
  • NEW: Purge awtomatiku tal‑cache tal‑FAQ meta l‑kontenut jinbidel fid‑dashboard tal‑ChatReact

1.1.1

  • FIX: Titjibiet fit‑traduzzjoni (Romanian, Dutch)

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — qsim strutturat tal‑kontenut mal‑crawler ta’ ChatReact
  • NEW: Tab Integration fis‑settings tal‑plugin
  • NEW: Selezjoni tat‑tip ta’ kontenut b’livelli ta’ priorità
  • NEW: Esklużjoni per‑post mis‑sitemap permezz tal‑meta box
  • NEW: Endpoint REST API protett għas‑smart sitemap
  • FIX: Kompatibilità sħiħa ma’ plugins ta’ caching (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
  • FIX: Problemi ta’ loading tal‑widget għal viżitaturi logged‑out marbuta ma’ plugins ta’ caching

1.0.24

  • Widget Assignments — assenja chatbots għal paġni direttament mis‑settings tal‑plugin
  • Appoġġ għal Gutenberg blocks
  • Integrazjoni ma’ Elementor
  • 24 traduzzjonijiet tal‑lingwi
  • Assegnazzjoni tal‑widget f’livell ta’ paġna
  • CHANGED: Is‑settings tal‑widget issa jinżammu ċentralment fid‑dashboard tal‑ChatReact — inħassru l‑attribwiti shortcode position, primary_color, u auto_open (language għadu appoġġjat)

Next Steps