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)
- Mur għal Plugins → Add New fil-amministrazzjoni ta’ WordPress
- Fittex ChatReact
- Ikklikkja Install Now, imbagħad Attiva
Method 2: Upload via WordPress Admin
- Niżżel il-fajl ZIP tal-plugin hawn fuq
- Mur għal Plugins → Add New → Upload Plugin
- Agħżel il-fajl ZIP u ikklikkja Install Now
- Ikklikkja Activate Plugin
Method 3: Manual Upload via FTP
- Estratt il-fajl ZIP
- Upload l‑folder
chatreactgħal/wp-content/plugins/ - Mur fil‑menu Plugins fl‑amministrazzjoni ta’ WordPress
- 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
- Idħol f’chatreact.ai
- Iftaħ il‑chatbot tiegħek u mur fit‑tab Embed
- Ikklikkja Ikkopja l-Kodiċi biex tikkopja l‑snippet tal‑embed, jew aqra l‑ID mill‑atribut
data-chatbot-idfil‑kodice kopjat
Finding Your Form ID
- Idħol f’chatreact.ai
- Mur għal Formoli
- Ikklikkja Ikkopja l-kodiċi tal-embed fuq il‑formol tiegħek (jew iftaħ il‑formol u swiċċja għall‑tab Embed)
- L‑Form ID tiegħek huwa l‑valur ta’
data-form-idfil‑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:
- Ikklikkja + biex iżżid blokk
- Fittex "ChatReact"
- Agħżel ChatReact Chat, ChatReact Form, jew ChatReact FAQ
- Daħħal l‑ID tiegħek fis‑settings tal‑blokk
3. Elementor
Jekk tuża Elementor:
- Editja l‑paġna tiegħek bl‑Elementor
- Fittex "ChatReact" bejn il‑widgets
- Drawwa l‑widget fuq il‑paġna tiegħek
- 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:
- Iftaħ il‑menu ChatReact fil‑sidebar tal‑amministrazzjoni
- Fit‑tab Chat Widget, sib Widget Assignments
- Ikklikkja Add Assignment, agħżel paġna jew post (jew agħżel Everywhere), u daħħal l‑Chatbot ID tiegħek
- 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:
- Editja kwalunkwe paġna jew post
- Sib il‑meta box "ChatReact Widget"
- Iċċekkja Enable custom widget for this page
- Daħħal l‑Chatbot ID tiegħek u fakultattivament agħżel pożizzjoni (Default, Bottom Right, Bottom Left)
- 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
- Ivvverifika li l‑Chatbot ID tiegħek huwa korrett
- Iċċekkja jekk il‑chatbot huwa attiv fid‑dashboard tal‑ChatReact tiegħek
- Ċara kwalunkwe plugins ta’ caching tal‑paġna (ara hawn taħt)
- 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):
- Ċara l‑cache tal‑plugin ta’ caching tiegħek
- Escludi
chatreactminn JS minification/combination fis‑settings tal‑plugin tal‑caching - Il‑plugin juża attributi
data-api-urlbħ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
!importantfit‑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
- Generate an Integration Key fid‑dashboard tal‑ChatReact (Knowledge Base → Websites → CMS Integrations)
- Paste the key fis‑settings tal‑plugin ta’ WordPress taħt it‑tab Integration
- Select content types li trid taqsam (Pages, Posts, Custom Post Types)
- Set priorities (High/Medium/Low) għal kull tip ta’ kontenut
- 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
| Priority | Default for | Description |
|---|---|---|
| High | Pages | Core business content (About, Services, Contact) |
| Medium | Posts | Blog 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, uauto_open(languagegħadu appoġġjat)