WordPress įskiepis

Pridėkite ChatReact AI pokalbių robotus, kontaktines formas ir DUK akordeonus į savo WordPress svetainę naudodami mūsų oficialų įskiepį.

Parsisiųsti

Įskiepis yra prieinamas oficialiame WordPress Plugin Directory kataloge, arba kaip tiesioginis atsisiuntimas:

Download ChatReact Plugin v1.2.0

Diegimas

1 būdas: WordPress Plugin Directory (rekomenduojama)

1. Eikite į Plugins → Add New savo WordPress administracijoje
2. Ieškokite ChatReact
3. Spauskite Install Now, tada Activate

2 būdas: Įkelti per WordPress administraciją

1. Parsisiųskite aukščiau nurodytą įskiepio ZIP failą
2. Eikite į Plugins → Add New → Upload Plugin
3. Pasirinkite ZIP failą ir spauskite Install Now
4. Spauskite Activate Plugin

3 būdas: Rankinis įkėlimas per FTP

1. Išarchyvuokite ZIP failą
2. Įkelkite chatreact aplanką į /wp-content/plugins/
3. Eikite į Plugins WordPress administracijoje
4. Raskite "ChatReact" ir spauskite Activate

Konfigūracija

Įjungus įskiepį, atidarykite ChatReact meniu savo WordPress administracijos šoninėje juostoje, kad pasiektumėte nustatymus ir naudojimo instrukcijas.

Kaip rasti savo pokalbio roboto ID

1. Prisijunkite prie chatreact.ai
2. Eikite į savo pokalbio roboto Dashboard
3. Spauskite Copy mygtuką šalia Chatbot ID (rodyklėje viršuje)

Kaip rasti savo formos ID

1. Prisijunkite prie chatreact.ai
2. Eikite į Forms
3. Spauskite Copy embed code ant savo formos (arba atidarykite formą ir perjunkite į Embed kortelę)
4. Jūsų Form ID yra data-form-id reikšmė nukopijuotame įterpimo kode

Naudojimo parinktys

Įskiepis siūlo kelis būdus, kaip pridėti ChatReact į jūsų svetainę:

1. Trumpieji žymekliai (Shortcodes)

Pridėkite į bet kurią puslapio, įrašo ar valdiklio sritį:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Pasirenkami atributai: language

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Pasirenkami atributai: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Pasirenkami atributai: categories, container, language

2. Gutenberg blokai

Blokų redaktoriuje:

1. Spauskite + pridėti bloką
2. Ieškokite "ChatReact"
3. Pasirinkite ChatReact Chat, ChatReact Form arba ChatReact FAQ
4. Įveskite savo ID bloko nustatymuose

3. Elementor

Jei naudojate Elementor:

1. Redaguokite puslapį su Elementor
2. Ieškokite "ChatReact" valdikliuose
3. Nutempkite valdiklį į puslapį
4. Konfigūruokite kairėje panelėje

4. Valdiklių priskyrimai (Plugin Settings)

Rodykite pokalbio robotą tam tikruose puslapiuose — arba visoje svetainėje — nekeičiant jokio turinio:

1. Atidarykite ChatReact meniu savo administracijos šoninėje juostoje
2. Chat Widget skirtuke raskite Widget Assignments
3. Spauskite Add Assignment, pasirinkite puslapį arba įrašą (arba pasirinkite Everywhere) ir įveskite savo Chatbot ID
4. Spauskite Save Changes

Dėl Everywhere priskyrimų galite išskirti konkrečius URL — po vieną eilutę, su žvaigždutės (wildcard) palaikymu (pvz. /blog/* arba /checkout) — kad paslėptumėte valdiklį nukreipimo puslapiuose arba atsiskaitymo metu.

Pagal numatytuosius nustatymus priskiriant paieškai yra matomi tik Puslapiai. Spauskite Post Types mygtuką, kad kiti turinio tipai (pvz. Posts arba pasirinktiniai įrašo tipai) taip pat būtų paieškos rezultatuose.

5. Puslapio lygio priskyrimas

Priskirkite pokalbio robotą vienam puslapiui tiesiogiai iš redaktoriaus:

1. Redaguokite bet kurį puslapį arba įrašą
2. Suraskite "ChatReact Widget" meta laukelį
3. Pažymėkite Enable custom widget for this page
4. Įveskite savo Chatbot ID ir pasirinktinai pasirinkite poziciją (Default, Bottom Right, Bottom Left)
5. Išsaugokite puslapį

Tas pats meta laukelis taip pat siūlo Disable all widgets on this page parinktį, jei norite visiškai paslėpti ChatReact tam tikruose puslapiuose.

Shortcode pavyzdžiai

Pagrindinis Chat Widget

[chatreact id="abc123"]

Chat Widget su fiksuota kalba

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

DUK su kategorijų filtru

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

Stilinga kontaktinė forma

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

DUK valdiklis: SEO ir talpinimas (caching)

SEO draugiškos DUK

Nuo versijos 1.1.2 DUK valdikliai atkuriami serverio pusėje: jūsų DUK yra įtraukti į puslapio HTML ir apima JSON-LD struktūrizuotus duomenis (FAQPage schema). Paieškos varikliai ir AI asistentai gali juos nuskaityti be jokio JavaScript vykdymo.

llms.txt AI naršyklėms

Įskiepis gali pateikti jūsų DUK turinį adresu yoursite.com/llms.txt, atradimo failu, kurį skaito AI naršyklės. Jis yra įjungtas pagal numatytuosius nustatymus. Norėdami perjungti arba nustatyti konkretų Chatbot ID šiam failui, eikite į ChatReact → FAQ Widget → Cache & SEO Settings.

DUK talpinimas (caching)

DUK duomenys yra talpinami jūsų serveryje greitesniam puslapio krovimui. Skiltyje ChatReact → FAQ Widget → Cache & SEO Settings galite:

• Nustatyti Cache Duration — 1, 3, 6 (rekomenduojama), 12 arba 24 valandas, arba išjungti talpinimą
• Spauskite Clear Cache, kad iš karto atnaujintumėte savo DUK

Talpykla taip pat automatiškai išvaloma, kai jūsų DUK keičiasi ChatReact skydelyje.

Palaikomos kalbos

Įskiepis palaiko 24 ES kalbas:

• Bulgarian, Croatian, Czech, Danish, Dutch, English
• Estonian, Finnish, French, German, Greek, Hungarian
• Irish, Italian, Latvian, Lithuanian, Maltese, Polish
• Portuguese, Romanian, Slovak, Slovenian, Spanish, Swedish

Nuo versijos 1.2.0 visų 24 kalbų vertimai yra įtraukti į įskiepį. Valdiklio kalba aptinkama automatiškai pagal dabartinį puslapį, todėl daugiakalės svetainės veikia iš karto — naudokite language shortocode atributą tik jei norite priversti tam tikrą kalbą.

Trikčių šalinimas

Valdiklis nerodomas

1. Patikrinkite, ar jūsų Chatbot ID yra teisingas
2. Patikrinkite, ar pokalbio robotas yra aktyvus jūsų ChatReact skydelyje
3. Išvalykite bet kokius puslapio talpinimo (caching) įskiepius (žr. žemiau)
4. Patikrinkite naršyklės konsolę dėl JavaScript klaidų

Suderinamumas su talpinimo įskiepiais

Įskiepis visiškai suderinamas su populiariais talpinimo ir optimizavimo įskiepiais, įskaitant WP Rocket, LiteSpeed Cache, Autoptimize ir WP Super Cache. Įskiepis automatiškai neleidžia šioms priemonėms minimizuoti arba talpinti ChatReact skriptų.

Jei vis tiek susiduriate su problemomis (pvz., 404 klaidos, valdiklis neįkraunamas neprisijungusiems lankytojams):

1. Išvalykite savo talpinimo įskiepio talpyklą
2. Pašalinkite chatreact iš JS minimizavimo/derinimo nustatymų savo talpinimo įskiepyje
3. Įskiepis naudoja data-api-url atributus kaip atsarginį sprendimą, kad užtikrintų teisingą API komunikaciją

DUK neatnaujinami

Jei jūsų svetainėje rodomos pasenusios DUK, eikite į ChatReact → FAQ Widget ir spauskite Clear Cache. Talpykla taip pat automatiškai išvaloma, kai redaguojate savo DUK ChatReact skydelyje.

Stilizacijos konfliktai

Jei valdiklis atrodo sulūžęs:

• Valdiklis naudoja izoliuotus CSS
• Patikrinkite savo temos CSS !important taisykles
• Pabandykite laikinai išjungti kitus pokalbių įskiepius

Keli valdikliai

Galite naudoti skirtingus pokalbio robotus skirtinguose puslapiuose nurodydami unikalius ID kiekviename shortkode arba bloke.

CMS integracija (Smart Sitemap)

Nuo 1.1.0 versijos ChatReact WordPress įskiepis apima Smart Sitemap funkciją, kuri teikia ChatReact robotui struktūrizuotą turinio metaduomenų sąrašą tiesiai iš jūsų WordPress svetainės.

Kaip tai veikia

1. Generate an Integration Key ChatReact skydelyje (Knowledge Base → Websites → CMS Integrations)
2. Paste the key įklijuokite raktą į WordPress įskiepio nustatymus po Integration skirtuku
3. Select content types pasirinkite turinio tipus, kuriuos norite dalintis (Pages, Posts, Custom Post Types)
4. Set priorities nustatykite prioritetus (High/Medium/Low) kiekvienam turinio tipui
5. Kai bus nuskaityta jūsų svetainė, ChatReact automatiškai naudos smart sitemap vietoje įprasto nuorodų atradimo

Privalumai

• Faster crawling – tiesioginis URL sąrašas vietoje nuoroda po nuorodos atradimo
• Content type awareness – robotas žino, ar URL yra Page, Post ar Custom Post Type
• Priority-based indexing – svarbus turinys (pvz., Pages) gali būti svertas aukščiau už tinklaraščio įrašus
• Selective sharing – dalinkitės tik tais turinio tipais, kuriuos norite
• Per-post exclusion – išskirkite atskirus įrašus/puslapius iš sitemap per meta laukelį

Prioritetų lygiai

Saugumas

Smart sitemap galutinis taškas (/wp-json/chatreact/v1/sitemap) yra apsaugotas Integration Key. Jis nėra matomas paieškos sistemoms ar kitiems robotams — tik ChatReact gali prieiti prie jo su teisingu raktu.

Atskirų įrašų išskyrimas

WordPress redaktoriuje kiekvienas įrašas/puslapis turi ChatReact Widget meta laukelį su parinktimi "Exclude from ChatReact Sitemap". Pažymėti įrašai nebus įtraukti į smart sitemap.

Reikalavimai

• WordPress 5.8 arba naujesnis
• PHP 7.4 arba naujesnis
• ChatReact paskyra (sign up free)

Changelog

1.2.0

• NEW: Bundled translations for all 24 official EU languages

1.1.3

• FIX: Single-category FAQ widgets no longer show an unnecessary "All" filter button and category badges

1.1.2

• NEW: Server-side rendering for FAQ widgets — FAQs are visible to search engines and LLMs without JavaScript
• NEW: JSON-LD structured data (FAQPage schema) for improved SEO and rich results
• NEW: llms.txt endpoint for AI crawler discoverability
• NEW: Automatic FAQ cache purge when content changes in the ChatReact dashboard

1.1.1

• FIX: Translation improvements (Romanian, Dutch)

1.1.0

• NEW: Smart Sitemap (CMS Integration) — structured content sharing with ChatReact crawler
• NEW: Integration tab in plugin settings
• NEW: Content type selection with priority levels
• NEW: Per-post exclusion from sitemap via meta box
• NEW: Protected REST API endpoint for smart sitemap
• FIX: Full compatibility with caching plugins (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
• FIX: Widget loading issues for logged-out visitors with caching plugins

1.0.24

• Widget Assignments — assign chatbots to pages directly from plugin settings
• Gutenberg blocks support
• Elementor integration
• 24 language translations
• Page-level widget assignment
• CHANGED: Widget settings are now managed centrally in the ChatReact dashboard — removed the position, primary_color, and auto_open shortcode attributes (language is still supported)

Tolimesni veiksmai

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