ChatReact
Paġna ewlenijaDokumentazzjoni

Plugin għall-WordPress

Żid chatbots AI ta’ ChatReact, formoli ta' kuntatt u akkordeon ta' FAQs mal-sit WordPress tiegħek bil-plugin uffiċjali tagħna.

Niżżel

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

Download ChatReact Plugin v1.2.0

Installazzjoni

Metodu 1: WordPress Plugin Directory (Rakkomandat)

  1. Mur fuq Plugins → Add New fil-admin ta' WordPress tiegħek
  2. Fittex ChatReact
  3. Ikklikkja Install Now, imbagħad Activate

Metodu 2: Upload via WordPress Admin

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

Metodu 3: Upload Manwali via FTP

  1. Estratt il-file ZIP
  2. Upload il-folder chatreact lejn /wp-content/plugins/
  3. Mur fuq Plugins fl-admin ta' WordPress
  4. Sib "ChatReact" u ikklikkja Activate

Konfigurazzjoni

Wara l-attivazzjoni, iffetaħ il-menu ChatReact fis-sidebar tal-admin ta' WordPress tiegħek għal settings u istruzzjonijiet ta' użu.

Kif issib l-ID tal-Chatbot tiegħek

  1. Iddawwlu masuk fuq chatreact.ai
  2. Mur fil-Dashboard tal-chatbot tiegħek
  3. Ikklikkja l-buttuna Copy ħdejn il-Chatbot ID (muri fin-naħa ta' fuq)

Kif issib l-ID tal-Formoljar tiegħek

  1. Iddawwlu masuk fuq chatreact.ai
  2. Mur fuq Forms
  3. Ikklikkja Copy embed code fuq il-formoljar tiegħek (jew iftaħ il-formoljar u switch lejn it-tab Embed)
  4. L-Form ID tiegħek huwa l-valur tadata-form-id fil-kodiċi embed magħqud

Opsjonijiet ta' Użu

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

1. Shortcodes

Żid ma' kwalunkwe paġna, post jew żona ta' widget:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Attributi opzjonali: language

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Attributi opzjonali: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Attributi opzjonali: categories, container, language

Is-settings viżwali bħall-pożizzjoni, il-kuluri u l-auto-open huma immaniġġjati ċentralment fid-dashboard ta' ChatReact u japplikaw awtomatikament mas-sit WordPress tiegħek. L-attribut language huwa fakultattiv fuq il-shortcodes kollha — jekk ma tinkludihx, il-lingwa tal-paġna kurrenti tiġi skoperta awtomatikament (taħdem ma' siti multilingwi).

2. Gutenberg Blocks

Fil-editor tal-blokks:

  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. Irediġi l-paġna tiegħek ma' Elementor
  2. Fittex "ChatReact" fil-widgets
  3. Draġġja l-widget fuq il-paġna tiegħek
  4. Konfigura fil-panel tax-xellug

4. Widget Assignments (Plugin Settings)

Uri chatbot fuq paġni speċifiċi — jew fuq il-websajt kollha — mingħajr ma taġġorna l-kontenut:

  1. Iftaħ il-menu ChatReact fis-sidebar tal-admin tiegħek
  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 Save Changes

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

B'mod default jitqajmu biss Paġni meta tkun qed tagħmel assenjazzjonijiet. Ikklikkja l-buttuna Post Types biex tagħmel tipi oħra ta' kontenut (eż. Posts jew custom post types) jistgħu jidhru fis-fittex ukoll.

5. Page-Level Assignment

Assenja chatbot għal paġna waħda direttament mill-editor:

  1. Irediġi 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. Issalva l-paġna

Il-istess meta box joffri wkoll l-opportunità Disable all widgets on this page jekk trid taħbi kompletament ChatReact fuq ċerti paġni.

Eżempji ta' Shortcode

Chat Widget Bażiku

[chatreact id="abc123"]

Chat Widget b'Lingwa Fiss

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

FAQ b'Filtro ta' Kategorija

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

Contact Form Styljat

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

FAQ Widget: SEO & Caching

FAQs Favoribbli għas-SEO

Minn verżjoni 1.1.2, il-widgets tal-FAQ huma renderjati server-side: il-FAQs tiegħek huma parti mill-HTML tal-paġna u jinkludu JSON-LD structured data (FAQPage schema). Engines tal-kejl u assistenti AI jistgħu jaqrawhom mingħajr ma jridu jħaddmu JavaScript.

llms.txt għall-Crawlers AI

Il-plugin jista' jservi l-kontenut tal-FAQ tiegħek fuq yoursite.com/llms.txt, fajl ta' skoperta li jaqraw il-crawlers tal-AI. Huwa attivat b'mod predefinit. Biex tibdelh jew tissettja Chatbot ID speċifiku għal dak il-fajl, mur fuq ChatReact → FAQ Widget → Cache & SEO Settings.

Caching tal-FAQ

Id-data tal-FAQ hija cached fuq is-server tiegħek għall-iżvilupp aktar mgħaġġel tal-paġni. Sotto ChatReact → FAQ Widget → Cache & SEO Settings tista':

  • Issettja Cache Duration — 1, 3, 6 (rakkomandat), 12, jew 24 siegħa, jew iċċekkja biex tiddiżattivaha
  • Ikklikkja Clear Cache biex tirfreshja l-FAQs tiegħek immedjatament

Il-cache jiġi wkoll imneħħi awtomatikament kull meta l-FAQs tiegħek jinbidlu fid-dashboard ta' ChatReact.

Lingwi Appoġġjati

Il-plugin jappoġġja 24-ilsna 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-ilsna huma inklużi mal-plugin. Il-lingwa tal-widget tiġi skoperta awtomatikament mill-paġna kurrenti, għalhekk siti multilingwi jaħdmu mill-baxxa — uża l-attribut language biss jekk trid forza lingwa speċifika.

Troubleshooting

Widget Ma Jidhirx

  1. Iċċekkja li l-Chatbot ID tiegħek hu korrett
  2. Iċċekkja jekk il-chatbot hu attiv fid-dashboard ta' ChatReact tiegħek
  3. Ħassar kwalunkwe plugin ta' caching tal-paġni (ara hawn taħt)
  4. Iċċekkja il-console tal-browser għal żbalji JavaScript

Kompatibilità ma' Plugins ta' Caching

Il-plugin hu kompletament kompatibbli ma' plugins popolari ta' caching u ottimizzazzjoni inkluż WP Rocket, LiteSpeed Cache, Autoptimize, u WP Super Cache. Il-plugin awtomatikament jipprevjeni lil dawn it-twettiq milli jminifikaw jew jcachejaw is-skripts ta' ChatReact.

Jekk għad għandek problemi (eż., żbalji 404, widget ma jidħolx għall-viżitaturi li mhumiex logged-in):

  1. Ħassar il-cache tal-plugin ta' caching tiegħek
  2. Eskludi chatreact minn JS minification/combination fis-settings tal-plugin ta' caching tiegħek
  3. Il-plugin juża attributi data-api-url bħala fallback biex tiġi assigurata komunikazzjoni API korretta

FAQs Ma Jupdatedx

Jekk is-sit tiegħek juri FAQs skaduti, mur fuq ChatReact → FAQ Widget u ikklikkja Clear Cache. Il-cache jitnaddaf ukoll awtomatikament meta teditja l-FAQs fid-dashboard ta' ChatReact.

Konflitti ta' Styling

Jekk il-widget jidher imkisser:

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

Multipli Widgets

Tista' tuża chatbots differenti fuq paġni differenti billi tiddeskrivi IDs uniku f'kull shortcode jew blokk.

Integrazzjoni CMS (Smart Sitemap)

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

Kif Jaħdem

  1. Ġenera Integration Key fid-dashboard ta' ChatReact (Knowledge Base → Websites → CMS Integrations)
  2. Pejstja l-key fis-settings tal-plugin ta' WordPress taħt it-tab Integration
  3. Agħżel it-tipi ta' kontenut li trid taqsam (Pages, Posts, Custom Post Types)
  4. Issettja prijoritajiet (High/Medium/Low) għal kull tip ta' kontenut
  5. Meta tkun qed t-crawl is-sit tiegħek, ChatReact se juża awtomatikament is-smart sitemap minflok skoperta bbażata fuq links

Benefiċċji

  • Crawling aktar veloċi – Lista diretta ta' URLs minflok skoperta link b'link
  • Awareness tat-tip ta' kontenut – il-crawler jifhem jekk URL hu Page, Post, jew Custom Post Type
  • Indexing bbażat fuq prijorità – kontenut importanti (bħal Pages) jista' jingħata piż iktar minn blog posts
  • Qsim selettiv – Qasamh biss it-tipi ta' kontenut li trid
  • Esklużjoni kull-post – Esklużi posts/paġni individwali mis-sitemap permezz tal-meta box

Levels ta' Prijorità

PriorityDefault forDescription
HighPagesKontenut ewlieni tan-negozju (About, Services, Contact)
MediumPostsArtikli tal-blog, aġġornamenti ta' aħbarijiet
Low–Kontenut suppletiv

Sigurtà

Il-endpoint tas-smart sitemap (/wp-json/chatreact/v1/sitemap) huwa protett bl-Integration Key. Mhux viżibbli għal search engines jew crawlers oħra — biss ChatReact jista' jaċċessah bil-key korrett.

Escludi Posts Individwali

Fl-editor tal-WordPress, kull post/paġna għandha meta box ChatReact Widget b'opzjoni biex "Exclude from ChatReact Sitemap". Posts immarkati ma jidhirx fis-smart sitemap.

Rekwiżiti

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

Changelog

1.2.0

  • NEW: Traduzzjonijiet inklużi għal dawk kollha 24-ilsna uffiċjali tal-UE

1.1.3

  • FIX: Widgets tal-FAQ b'kategorija waħda ma juru aktar buttuna ta' filtro "All" bla bżonn u badges tal-kategorija

1.1.2

  • NEW: Server-side rendering għall-widgets tal-FAQ — il-FAQs huma viżibbli għal search engines u LLMs mingħajr JavaScript
  • NEW: JSON-LD structured data (FAQPage schema) għall-imħaffar tas-SEO u riżultati rikki
  • NEW: Endpoint llms.txt għall-discoverability tal-crawlers AI
  • NEW: Purġar awtomatiku tal-cache tal-FAQ meta l-kontenut jinbidel fid-dashboard ta' ChatReact

1.1.1

  • FIX: Tiswijiet fit-traduzzjonijiet (Romanian, Dutch)

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — qsim strutturat tal-kontenut mal-crawler ta' ChatReact
  • NEW: Tab ta' Integration fis-settings tal-plugin
  • NEW: Għażla tat-tip ta' kontenut b'livelli ta' prijorità
  • NEW: Esklużjoni kull-post mis-sitemap permezz tal-meta box
  • NEW: Endpoint REST API protett għall-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ħall-viżitaturi logged-out b'plugins ta' caching

1.0.24

  • Widget Assignments — assenja chatbots għal paġni direttament mis-settings tal-plugin
  • Support għal Gutenberg blocks
  • Integrazzjoni ma' Elementor
  • 24 traduzzjonijiet tal-lingwi
  • Page-level widget assignment
  • CHANGED: Is-settings tal-widget issa jmexxu ċentralment fid-dashboard ta' ChatReact — il-shortcode attributes position, primary_color, u auto_open ġew rtirati (language għadu appoġġjat)

Passi Li Jmiss

Preċedenti
Programm tal-Partners
Li jmiss
Integrazjoni ma' Shopify