HomeDocumentation

Plugin WordPress

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

Niżżel

Niżżel Plugin ChatReact v1.1.0

Installazzjoni

Metodu 1: Upload permezz ta' WordPress Admin

  1. Niżżel il-fajl ZIP tal-plugin hawn fuq
  2. Mur għal Plugins → Żid Ġdid → Tella' Plugin
  3. Agħżel il-fajl ZIP u ikklikkja Installa Issa
  4. Ikklikkja Attiva l-Plugin

Metodu 2: Upload manwali permezz ta' FTP

  1. Estrattu l-fajl ZIP
  2. Tella' l-folder chatreact għal /wp-content/plugins/
  3. Mur għal Plugins fl-admin ta' WordPress
  4. Sib "ChatReact" u ikklikkja Attiva

Konfigurazzjoni

Wara l-attivazzjoni, mur għal Settings → ChatReact għal istruzzjonijiet dwar l-użu.

Issib il-Chatbot ID tiegħek

  1. Idħol fuq chatreact.ai
  2. Mur għad-Dashboard tal-chatbot tiegħek
  3. Ikklikkja l-buttuna Ikkopja ħdejn il-Chatbot ID (muri fil-quċċata)

Issib il-Form ID tiegħek

  1. Idħol fuq chatreact.ai
  2. Mur għal Forms
  3. Agħżel il-form tiegħek
  4. Ikkopja l-Form ID

Għażliet ta' użu

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

1. Shortcodes

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

Widget taċ-chat:

[chatreact id="IL_CHATBOT_ID_TIEGĦEK"]

Attributi opzjonali: position, language, primary_color, auto_open

Formola ta' kuntatt:

[chatreact_form id="IL_FORM_ID_TIEGĦEK"]

Attributi opzjonali: language

FAQ accordion:

[chatreact_faq id="IL_CHATBOT_ID_TIEGĦEK"]

Attributi opzjonali: categories, container, language

2. Gutenberg blocks

Fl-editur tal-blocks:

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

3. Elementor

Jekk tuża Elementor:

  1. Editja l-paġna tiegħek b'Elementor
  2. Fittex "ChatReact" fil-widgets
  3. Ġibdu l-widget għall-paġna tiegħek
  4. Ikkonfigura fil-panel tax-xellug

4. Page-Level Assignment

Assenja widgets lil paġni speċifiċi mingħajr shortcodes:

  1. Editja kwalunkwe paġna jew post
  2. Sib il-meta box "ChatReact Widget"
  3. Agħżel tip ta' widget
  4. Daħħal l-ID tiegħek
  5. Salva l-paġna

Eżempji ta' Shortcode

Chat Widget Bażiku

[chatreact id="abc123"]

Chat Widget b'Għażliet

[chatreact id="abc123" position="bottom-left" language="de" auto_open="true"]

FAQ b'Category Filter

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

Formola ta' Kuntatt Stilizzata

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

Lingwi appoġġjati

Il-plugin jappoġġja 24 lingwa tal-UE:

  • Bulgaru, Kroat, Ċek, Daniż, Olandiż, Ingliż
  • Estonjan, Finlandiż, Franċiż, Ġermaniż, Grieg, Ungeriż
  • Irlandiż, Taljan, Latvjan, Litwan, Malti, Pollakk
  • Portugiż, Rumen, Slovakk, Sloven, Spanjol, Svediż

Soluzzjoni tal-problemi

Il-widget ma jidhirx

  1. Ivverifika li l-Chatbot ID hu korrett
  2. Iċċekkja jekk il-chatbot hu attiv fid-dashboard ta' ChatReact
  3. Naddaf il-plugins tal-cache tal-paġna (ara hawn taħt)
  4. Iċċekkja l-konsola tal-browser għal żbalji JavaScript

Caching Plugin Compatibility

Il-plugin huwa kompletament kompatibbli ma' plugins popolari ta' caching u ottimizzazzjoni inkluż WP Rocket, LiteSpeed Cache, Autoptimize, u WP Super Cache. Il-plugin jipprevjeni awtomatikament lil dawn l-għodod milli jminifikaw jew jaħżnu l-iskripts ta' ChatReact.

Jekk għadek tesperjenza problemi (eż., żbalji 404, widget ma jidħolx għal viżitaturi mhux idħlu):

  1. Naddaf il-cache tal-plugin tal-caching tiegħek
  2. Eskludixxi chatreact mill-minifikazzjoni/kombinazzjoni tal-JS fis-settings tal-plugin tal-caching tiegħek
  3. Il-plugin juża attributi data-api-url bħala fallback biex jiżgura komunikazzjoni korretta mal-API

Styling Conflicts

Jekk il-widget jidhrilok imkisser:

  • Il-widget juża CSS iżolat
  • Iċċekkja regoli !important CSS fit-tema tiegħek
  • Prova tiddisattiva plugins oħra tal-chat temporanjament

Multiple Widgets

Tista' tuża chatbots differenti fuq paġni differenti billi tispeċifika IDs uniċi f'kull shortcode jew block.

CMS Integration (Smart Sitemap)

Ibda mill-verżjoni 1.1.0, il-plugin WordPress ta' ChatReact jinkludi karatteristika ta' Smart Sitemap li tipprovdi lill-crawler ta' ChatReact metadeta ta' kontenut strutturata direttament mis-sit WordPress tiegħek.

Kif Jaħdem

  1. Iġġenera Integration Key fid-dashboard ta' ChatReact (Knowledge Base → Websites → CMS Integrations)
  2. Daħħal iċ-ċavetta fis-settings tal-plugin WordPress taħt it-tab Integration
  3. Agħżel tipi ta' kontenut li trid taqsam (Paġni, Posts, Custom Post Types)
  4. Issettja prijoritajiet (Għoli/Medju/Baxx) għal kull tip ta' kontenut
  5. Meta t-crawl il-websajt tiegħek, ChatReact awtomatikament juża l-smart sitemap minflok skoperta bażata fuq links regolari

Benefiċċji

  • Crawling aktar rapidu – Lista ta' URLs diretta minflok skoperta link b'link
  • Kuxjenza tat-tip ta' kontenut – Il-crawler jaf jekk URL hix Paġna, Post, jew Custom Post Type
  • Indiċizzar ibbażat fuq prijorità – Kontenut importanti (bħal Paġni) jista' jkun ponderata ogħla mill-posts tal-blog
  • Qsim selettiv – Aqsam biss it-tipi ta' kontenut li trid
  • Esklużjoni għal kull post – Eskludixxi posts/paġni individwali mis-sitemap permezz tal-meta box

Livelli ta' Prijorità

PrijoritàDefault għalDeskrizzjoni
GħoljaPaġniKontenut tan-negozju prinċipali (Dwar, Servizzi, Kuntatt)
MedjaPostsArtikli tal-blog, aġġornamenti tal-aħbarijiet
BaxxaKontenut supplimentari

Sigurtà

L-endpoint tas-smart sitemap (/wp-json/chatreact/v1/sitemap) huwa protett biċ-ċavetta tal-Integrazzjoni. Mhux viżibbli għall-magni tat-tfittxija jew crawlers oħra — biss ChatReact jista' jaċċessah biċ-ċavetta korretta.

Esklużjoni ta' Posts Individwali

Fl-editur ta' WordPress, kull post/paġna għandha meta box ChatReact Widget b'għażla biex "Eskludixxi mis-Sitemap ta' ChatReact". Posts iċċekkjati mhux jidhru fis-smart sitemap.

Rekwiżiti

  • WordPress 5.8 jew aktar riċenti
  • PHP 7.4 jew aktar riċenti
  • Kont ChatReact (irreġistra b'xejn)

Changelog

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — qsim ta' kontenut strutturati mal-crawler ta' ChatReact
  • NEW: Tab tal-Integrazzjoni fis-settings tal-plugin
  • NEW: Selezzjoni tat-tip ta' kontenut b'livelli ta' prijorità
  • NEW: Esklużjoni għal kull post mis-sitemap permezz tal-meta box
  • NEW: Endpoint REST API protett għas-smart sitemap
  • FIX: Kompatibbiltà sħiħa ma' plugins tal-caching (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
  • FIX: Problemi tat-tagħbija tal-widget għal viżitaturi mhux idħlu ma' plugins tal-caching
  • CHANGED: Is-settings tal-widget issa jiġu ġestiti ċentralment fid-dashboard ta' ChatReact — imneħħew is-settings tal-pożizzjoni, lingwa, kulur primarju, u auto-open mill-plugin

1.0.24

  • Appoġġ tal-blocks Gutenberg
  • Integrazzjoni ta' Elementor
  • 24 traduzzjonijiet tal-lingwa
  • Assenjament tal-widget fil-livell tal-paġna

Passi li jmiss