WordPress Plugin

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

Download

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

Download ChatReact Plugin v1.2.0

Installation

Method 1: WordPress Plugin Directory (Recommended)

1. Отидете в Plugins → Add New в админ панела на WordPress
2. Потърсете ChatReact
3. Кликнете Install Now, след това Activate

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" и кликнете Activate

Configuration

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

Finding Your Chatbot ID

1. Влезте в chatreact.ai
2. Отидете в таблото (Dashboard) на вашия чатбот
3. Кликнете бутона Copy до Chatbot ID (показан в горната част)

Finding Your Form ID

1. Влезте в chatreact.ai
2. Отидете в Forms
3. Кликнете Copy embed code на вашата форма (или отворете формата и превключете на раздела Embed)
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

2. Gutenberg Blocks

В block editor:

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. Кликнете Save Changes

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

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

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 схема). Търсачките и AI асистентите могат да ги прочетат без да изпълняват JavaScript.

llms.txt for AI Crawlers

Плъгинът може да подаде съдържанието на вашите FAQ на yoursite.com/llms.txt, файл за откриване, който AI crawler-и прочитат. Той е включен по подразбиране. За да го превключите или зададете конкретно 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 на shortcode само ако желаете да принудите конкретен език.

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-та във всеки shortcode или блок.

CMS Integration (Smart Sitemap)

Започвайки от версия 1.1.0, ChatReact WordPress плъгинът включва функция Smart Sitemap, която предоставя на ChatReact crawler структурирани метаданни за съдържанието директно от вашия 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 – Crawler-ът знае дали URL е Page, Post или Custom Post Type
• Priority-based indexing – Важно съдържание (като Pages) може да има по-висока тежест от блог публикации
• Selective sharing – Споделяйте само типовете съдържание, които желаете
• Per-post exclusion – Изключвайте индивидуални публикации/страници от sitemap чрез мета кутията

Priority Levels

Security

Smart sitemap endpoint (/wp-json/chatreact/v1/sitemap) е защитен с Integration Key. Той не е видим за търсачки или други crawler-и — само ChatReact може да го достъпи с правилния ключ.

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.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)

Next Steps

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