НачалоДокументация

WordPress Plugin

Добавете ChatReact AI чатботове, контактни форми и FAQ акордеони към вашия WordPress сайт с нашия официален плъгин.

Download

Плъгинът е наличен в официалния WordPress Plugin Directory, или като директно изтегляне:

Download ChatReact Plugin v1.2.1

Installation

Method 1: WordPress Plugin Directory (Recommended)

  1. Отидете на Plugins → Add New в администрацията на WordPress
  2. Търсете ChatReact
  3. Кликнете Install Now, след това Активирай

Method 2: Upload via WordPress Admin

  1. Изтеглете ZIP файла на плъгина по-горе
  2. Отидете на Plugins → Add New → Upload Plugin
  3. Изберете ZIP файла и кликнете Install Now
  4. Кликнете Activate Plugin

Method 3: Manual Upload via FTP

  1. Разархивирайте ZIP файла
  2. Качете папката chatreact в /wp-content/plugins/
  3. Отидете в Plugins в администрацията на WordPress
  4. Намерете "ChatReact" и кликнете Активирай

Configuration

След активиране отворете менюто ChatReact в страничната лента на администрацията за настройки и инструкции за използване.

Finding Your Chatbot ID

  1. Влезте в chatreact.ai
  2. Отворете вашия чатбот и отидете в раздела Вграждане
  3. Кликнете Копирайте кода, за да копирате вградения фрагмент, или прочетете ID-то от атрибута data-chatbot-id в копирания код

Finding Your Form ID

  1. Влезте в chatreact.ai
  2. Отидете на Форми
  3. Кликнете Копирай кода за вграждане върху вашата форма (или отворете формата и превключете към раздела Вграждане)
  4. Вашето 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 редактора:

  1. Кликнете +, за да добавите блок
  2. Потърсете "ChatReact"
  3. Изберете ChatReact Chat, ChatReact Form или ChatReact FAQ
  4. Въведете вашето ID в настройките на блока

3. Elementor

Ако използвате Elementor:

  1. Редактирайте страницата с Elementor
  2. Потърсете "ChatReact" в уиджетите
  3. Плъзнете уиджета на страницата
  4. Конфигурирайте в лявата панел

4. Widget Assignments (Plugin Settings)

Покажете чатбот на конкретни страници — или на целия сайт — без да редактирате съдържание:

  1. Отворете менюто ChatReact в страничната лента на администрацията
  2. В раздела Chat Widget, намерете Widget Assignments
  3. Кликнете Add Assignment, изберете страница или запис (или изберете Everywhere), и въведете вашето Chatbot ID
  4. Кликнете Запазете промените

За назначения "Everywhere" можете да изключите специфични URL адреси — един на ред, със поддръжка на wildcard (напр. /blog/* или /checkout) — за да скриете джаджата на лендинг страници или по време на плащане.

По подразбиране само Pages са търсими при задаване. Кликнете бутона Post Types, за да направите други типове съдържание (напр. Posts или персонализирани пост типове) търсими също.

5. Page-Level Assignment

Задайте чатбот на отделна страница директно от редактора:

  1. Редактирайте всяка страница или запис
  2. Намерете мета полето "ChatReact Widget"
  3. Поставете отметка на Enable custom widget for this page
  4. Въведете вашето Chatbot ID и по желание изберете позиция (Default, Bottom Right, Bottom Left)
  5. Запазете страницата

Същото мета поле предлага и опция 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

  1. Проверете дали вашето Chatbot ID е вярно
  2. Проверете дали чатботът е активен в таблото на ChatReact
  3. Изчистете кеша на всякакви плъгини за кеширане на страници (вижте по-долу)
  4. Проверете конзолата на браузъра за JavaScript грешки

Caching Plugin Compatibility

Плъгинът е напълно съвместим с популярни плъгини за кеширане и оптимизация, включително WP Rocket, LiteSpeed Cache, Autoptimize и WP Super Cache. Плъгинът автоматично предотвратява тези инструменти да минифицират или кешират ChatReact скриптове.

Ако все още имате проблеми (напр. 404 грешки, джаджата не се зарежда за излезли потребители):

  1. Изчистете кеша на вашия плъгин за кеширане
  2. Изключете chatreact от JS минифициране/комбинация в настройките на плъгина за кеширане
  3. Плъгинът използва атрибутите 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

  1. Generate an Integration Key в таблото на ChatReact (Knowledge Base → Websites → CMS Integrations)
  2. Paste the key в настройките на WordPress плъгина под таба Integration
  3. Select content types които искате да споделите (Pages, Posts, Custom Post Types)
  4. Set priorities (High/Medium/Low) за всеки тип съдържание
  5. Когато сканирате вашия уебсайт, 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

PriorityDefault forDescription
HighPagesCore business content (About, Services, Contact)
MediumPostsBlog 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 все още се поддържа)

Next Steps