WordPress Plugin
Добавете ChatReact AI чатботове, контактни форми и FAQ акордеони към вашия WordPress сайт с нашия официален плъгин.
Download
Плъгинът е наличен в официалния WordPress Plugin Directory, или като директно изтегляне:
Download ChatReact Plugin v1.2.1
Installation
Method 1: WordPress Plugin Directory (Recommended)
- Отидете на Plugins → Add New в администрацията на WordPress
- Търсете ChatReact
- Кликнете Install Now, след това Активирай
Method 2: Upload via WordPress Admin
- Изтеглете ZIP файла на плъгина по-горе
- Отидете на Plugins → Add New → Upload Plugin
- Изберете ZIP файла и кликнете Install Now
- Кликнете Activate Plugin
Method 3: Manual Upload via FTP
- Разархивирайте ZIP файла
- Качете папката
chatreactв/wp-content/plugins/ - Отидете в Plugins в администрацията на WordPress
- Намерете "ChatReact" и кликнете Активирай
Configuration
След активиране отворете менюто ChatReact в страничната лента на администрацията за настройки и инструкции за използване.
Finding Your Chatbot ID
- Влезте в chatreact.ai
- Отворете вашия чатбот и отидете в раздела Вграждане
- Кликнете Копирайте кода, за да копирате вградения фрагмент, или прочетете ID-то от атрибута
data-chatbot-idв копирания код
Finding Your Form ID
- Влезте в chatreact.ai
- Отидете на Форми
- Кликнете Копирай кода за вграждане върху вашата форма (или отворете формата и превключете към раздела Вграждане)
- Вашето Form ID е стойността на
data-form-idв копирания embed код
Usage Options
Плъгинът предлага няколко начина да добавите ChatReact към вашия сайт:
1. Shortcodes
Добавете във всяка страница, запис или област с джаджи:
Chat Widget:
[chatreact id="YOUR_CHATBOT_ID"]
Незадължителни атрибути: language
Contact Form:
[chatreact_form id="YOUR_FORM_ID"]
Незадължителни атрибути: language
FAQ Accordion:
[chatreact_faq id="YOUR_CHATBOT_ID"]
Незадължителни атрибути: categories, container, language
Визуалните настройки като позиция, цветове и авто-отворяне се управляват централно в таблото на ChatReact и се прилагат автоматично към вашия WordPress сайт. Атрибутът language е незадължителен за всички шорткодове — ако го пропуснете, езикът на текущата страница се разпознава автоматично (работи с мултиезични сайтове).
2. Gutenberg Blocks
В block редактора:
- Кликнете +, за да добавите блок
- Потърсете "ChatReact"
- Изберете ChatReact Chat, ChatReact Form или ChatReact FAQ
- Въведете вашето ID в настройките на блока
3. Elementor
Ако използвате Elementor:
- Редактирайте страницата с Elementor
- Потърсете "ChatReact" в уиджетите
- Плъзнете уиджета на страницата
- Конфигурирайте в лявата панел
4. Widget Assignments (Plugin Settings)
Покажете чатбот на конкретни страници — или на целия сайт — без да редактирате съдържание:
- Отворете менюто ChatReact в страничната лента на администрацията
- В раздела Chat Widget, намерете Widget Assignments
- Кликнете Add Assignment, изберете страница или запис (или изберете Everywhere), и въведете вашето Chatbot ID
- Кликнете Запазете промените
За назначения "Everywhere" можете да изключите специфични URL адреси — един на ред, със поддръжка на wildcard (напр. /blog/* или /checkout) — за да скриете джаджата на лендинг страници или по време на плащане.
По подразбиране само Pages са търсими при задаване. Кликнете бутона Post Types, за да направите други типове съдържание (напр. Posts или персонализирани пост типове) търсими също.
5. Page-Level Assignment
Задайте чатбот на отделна страница директно от редактора:
- Редактирайте всяка страница или запис
- Намерете мета полето "ChatReact Widget"
- Поставете отметка на Enable custom widget for this page
- Въведете вашето Chatbot ID и по желание изберете позиция (Default, Bottom Right, Bottom Left)
- Запазете страницата
Същото мета поле предлага и опция Disable all widgets on this page, ако искате да скриете изцяло ChatReact на определени страници.
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
От версия 1.1.2, FAQ джаджите се рендерират на страна на сървъра: вашите FAQ са част от HTML-а на страницата и включват JSON-LD структурирани данни (FAQPage schema). Търсачките и AI асистентите могат да ги прочетат без изпълнение на JavaScript.
llms.txt for AI Crawlers
Плъгинът може да сервира съдържанието на вашите FAQ на yoursite.com/llms.txt, файл за откриване, четен от AI краулери. Той е активиран по подразбиране. За да го превключите или зададете специфично Chatbot ID за файла, отидете на ChatReact → FAQ Widget → Cache & SEO Settings.
FAQ Caching
Данните за FAQ се кешират на вашия сървър за бързо зареждане на страниците. В ChatReact → FAQ Widget → Cache & SEO Settings можете:
- Да зададете Cache Duration — 1, 3, 6 (препоръчително), 12 или 24 часа, или да деактивирате кеширането
- Да кликнете Clear Cache, за да обновите вашите FAQ незабавно
Кешът се изчиства автоматично и когато вашите FAQ бъдат променени в таблото на ChatReact.
Supported Languages
Плъгинът поддържа 24 езика от ЕС:
- Bulgarian, Croatian, Czech, Danish, Dutch, English
- Estonian, Finnish, French, German, Greek, Hungarian
- Irish, Italian, Latvian, Lithuanian, Maltese, Polish
- Portuguese, Romanian, Slovak, Slovenian, Spanish, Swedish
От версия 1.2.0, преводите за всички 24 езика са включени в плъгина. Езикът на джаджата се открива автоматично от текущата страница, така че мултиезичните сайтове работят веднага — използвайте атрибута language само ако искате да принудите конкретен език.
Troubleshooting
Widget Not Appearing
- Проверете дали вашето Chatbot ID е вярно
- Проверете дали чатботът е активен в таблото на ChatReact
- Изчистете кеша на всякакви плъгини за кеширане на страници (вижте по-долу)
- Проверете конзолата на браузъра за JavaScript грешки
Caching Plugin Compatibility
Плъгинът е напълно съвместим с популярни плъгини за кеширане и оптимизация, включително WP Rocket, LiteSpeed Cache, Autoptimize и WP Super Cache. Плъгинът автоматично предотвратява тези инструменти да минифицират или кешират ChatReact скриптове.
Ако все още имате проблеми (напр. 404 грешки, джаджата не се зарежда за излезли потребители):
- Изчистете кеша на вашия плъгин за кеширане
- Изключете
chatreactот JS минифициране/комбинация в настройките на плъгина за кеширане - Плъгинът използва атрибутите
data-api-urlкато резервен вариант, за да осигури коректна API комуникация
FAQs Not Updating
Ако на сайта ви се показват остарели FAQ, отидете на ChatReact → FAQ Widget и кликнете Clear Cache. Кешът се изчиства автоматично и когато редактирате вашите FAQ в таблото на ChatReact.
Styling Conflicts
Ако джаджата изглежда счупена:
- Джаджата използва изолирани CSS стилове
- Проверете за CSS
!importantправила във вашата тема - Опитайте временно да деактивирате други чат плъгини
Multiple Widgets
Можете да използвате различни чатботове на различни страници, като посочите уникални ID-та в всеки шорткод или блок.
CMS Integration (Smart Sitemap)
Започвайки от версия 1.1.0, ChatReact WordPress плъгинът включва функция Smart Sitemap, която предоставя на ChatReact краулъра структурирани метаданни за съдържанието директно от вашия WordPress сайт.
How It Works
- Generate an Integration Key в таблото на ChatReact (Knowledge Base → Websites → CMS Integrations)
- Paste the key в настройките на WordPress плъгина под таба Integration
- Select content types които искате да споделите (Pages, Posts, Custom Post Types)
- Set priorities (High/Medium/Low) за всеки тип съдържание
- Когато сканирате вашия уебсайт, ChatReact автоматично ще използва smart sitemap вместо обичайното откриване чрез връзки
Benefits
- Faster crawling – Директен списък с URL адреси вместо откриване линк по линк
- Content type awareness – Краулърът знае дали даден URL е Page, Post или Custom Post Type
- Priority-based indexing – Важно съдържание (като Pages) може да бъде оценено по-високо от блог публикациите
- Selective sharing – Споделяйте само типовете съдържание, които желаете
- Per-post exclusion – Изключвайте отделни постове/страници от sitemap-а чрез мета полето
Priority Levels
| Priority | Default for | Description |
|---|---|---|
| High | Pages | Core business content (About, Services, Contact) |
| Medium | Posts | Blog articles, news updates |
| Low | – | Supplementary content |
Security
Smart sitemap endpoint (/wp-json/chatreact/v1/sitemap) е защитен с Integration Key. Той не е видим за търсачки или други краулъри — само ChatReact може да има достъп до него с правилния ключ.
Ако защитен плъгин ограничава WordPress REST API до влизане само за регистрирани потребители, версиите 1.2.1 и по-нови все пак пропускат ChatReact заявки с валиден Integration Key до /wp-json/chatreact/v1/ — всички останали REST маршрути остават блокирани. Ако firewall блокира крайния URL преди WordPress да се зареди, позволете /wp-json/chatreact/v1/ там. Всякога когато smart sitemap не може да бъде достигнат, preview на сканирането в таблото на ChatReact показва причината и пада обратно към публичния sitemap, който игнорира вашия избор на типове съдържание.
Excluding Individual Posts
В редактора на WordPress всеки пост/страница има мета кутия ChatReact Widget с опция "Exclude from ChatReact Sitemap". Отбелязаните постове няма да се появяват в smart sitemap-а.
Requirements
- WordPress 5.8 или по-нова версия
- PHP 7.4 или по-нова версия
- ChatReact акаунт (sign up free)
Changelog
1.2.1
- FIX: Smart sitemap отново достижим на сайтове, които ограничават REST API до влезли потребители — заявките с валиден Integration Key се пропускат, така че избраните типове съдържание да бъдат уважени при сканиране
1.2.0
- NEW: Включени преводи за всички 24 официални езика на ЕС
1.1.3
- FIX: FAQ джаджите с една категория вече не показват ненужен бутон "All" и баджове за категории
1.1.2
- NEW: Рендериране на FAQ джаджи на сървъра — FAQ са видими за търсачки и LLM без JavaScript
- NEW: JSON-LD структурирани данни (FAQPage schema) за подобрено SEO и богати резултати
- NEW: llms.txt endpoint за откриваемост от AI краулъри
- NEW: Автоматично изчистване на кеша на FAQ при промяна на съдържанието в таблото на ChatReact
1.1.1
- FIX: Подобрения в превода (Romanian, Dutch)
1.1.0
- NEW: Smart Sitemap (CMS Integration) — структурирано споделяне на съдържание с ChatReact краулъра
- NEW: Таб Integration в настройките на плъгина
- NEW: Избор на типове съдържание с нива на приоритет
- NEW: Изключване на ниво пост от sitemap чрез мета кутия
- NEW: Защитен REST API endpoint за smart sitemap
- FIX: Пълна съвместимост с кеш плъгини (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
- FIX: Проблеми със зареждането на джаджата за излезли потребители при кеш плъгини
1.0.24
- Widget Assignments — задавайте чатботове на страници директно от настройките на плъгина
- Поддръжка на Gutenberg блокове
- Интеграция с Elementor
- 24 езикови превода
- Задаване на джаджа на ниво страница
- CHANGED: Настройките на джаджата вече се управляват централно в таблото на ChatReact — премахнати са атрибутите на шорткод
position,primary_colorиauto_open(languageвсе още се поддържа)