WordPress Plugin

Pridajte ChatReact AI chatboty, kontaktné formuláre a FAQ akordeóny na vašu WordPress stránku pomocou nášho oficiálneho pluginu.

Download

Plugin je dostupný v oficiálnom WordPress Plugin Directory, alebo ako priame stiahnutie:

Download ChatReact Plugin v1.2.0

Installation

Method 1: WordPress Plugin Directory (Recommended)

1. Prejdite do Plugins → Add New v administrácii WordPress
2. Vyhľadajte ChatReact
3. Kliknite Install Now, potom Activate

Method 2: Upload via WordPress Admin

1. Stiahnite si ZIP súbor pluginu vyššie
2. Prejdite do Plugins → Add New → Upload Plugin
3. Vyberte ZIP súbor a kliknite Install Now
4. Kliknite Activate Plugin

Method 3: Manual Upload via FTP

1. Rozbaľte ZIP súbor
2. Nahrajte priečinok chatreact do /wp-content/plugins/
3. Prejdite do Plugins v administrácii WordPress
4. Nájdite "ChatReact" a kliknite Activate

Configuration

Po aktivácii otvorte menu ChatReact v bočnom paneli administrácie WordPress pre nastavenia a pokyny na používanie.

Finding Your Chatbot ID

1. Prihláste sa na chatreact.ai
2. Prejdite do dashboardu vášho chatbota (Dashboard)
3. Kliknite na tlačidlo Copy vedľa Chatbot ID (zobrazené hore)

Finding Your Form ID

1. Prihláste sa na chatreact.ai
2. Prejdite do Forms
3. Kliknite Copy embed code pri vašom formulári (alebo otvorte formulár a prepnite na kartu Embed)
4. Vaše Form ID je hodnota data-form-id v skopírovanom embed kóde

Usage Options

Plugin ponúka viaceré spôsoby, ako pridať ChatReact na vašu stránku:

1. Shortcodes

Pridajte na ľubovoľnú stránku, príspevok alebo widget oblasť:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Nepovinné atribúty: language

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Nepovinné atribúty: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Nepovinné atribúty: categories, container, language

2. Gutenberg Blocks

V bloku editori:

1. Kliknite + pre pridanie bloku
2. Vyhľadajte "ChatReact"
3. Vyberte ChatReact Chat, ChatReact Form alebo ChatReact FAQ
4. Zadajte svoje ID v nastaveniach bloku

3. Elementor

Ak používate Elementor:

1. Upraviť stránku pomocou Elementor
2. Vyhľadajte "ChatReact" medzi widgetmi
3. Presuňte widget na stránku
4. Nakonfigurujte v ľavom paneli

4. Widget Assignments (Plugin Settings)

Zobrazte chatbota na konkrétnych stránkach — alebo na celej stránke — bez úprav obsahu:

1. Otvorte menu ChatReact v bočnom paneli administrácie
2. Na karte Chat Widget nájdite Widget Assignments
3. Kliknite Add Assignment, vyberte stránku alebo príspevok (alebo zvoľte Everywhere) a zadajte svoje Chatbot ID
4. Kliknite Save Changes

Pre priradenia Everywhere môžete vylúčiť konkrétne URL — jedna na riadok, s podporou wildcardov (napr. /blog/* alebo /checkout) — aby ste skryli widget na landing stránkach alebo počas procesu pokladne.

Štandardne sú pri priraďovaní vyhľadateľné len Pages. Kliknite tlačidlo Post Types aby sa sprístupnili aj ostatné typy obsahu (napr. Posts alebo vlastné post typy).

5. Page-Level Assignment

Priraďte chatbota na jednu stránku priamo z editora:

1. Upravte ľubovoľnú stránku alebo príspevok
2. Nájdite meta box "ChatReact Widget"
3. Zaškrtnite Enable custom widget for this page
4. Zadajte svoje Chatbot ID a voliteľne vyberte pozíciu (Default, Bottom Right, Bottom Left)
5. Uložte stránku

Ten istý meta box tiež ponúka možnosť Disable all widgets on this page, ak chcete úplne skryť ChatReact na určitých stránkach.

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

Od verzie 1.1.2 sú FAQ widgety renderované na strane servera: vaše FAQ sú súčasťou HTML stránky a obsahujú JSON-LD štruktúrované dáta (FAQPage schema). Vyhľadávače a AI asistenti ich môžu čítať bez spustenia JavaScriptu.

llms.txt for AI Crawlers

Plugin môže servírovať obsah vašich FAQ na yoursite.com/llms.txt, súbor pre discovery čítaný AI crawlermi. Je predvolene povolený. Ak ho chcete prepínať alebo nastaviť konkrétne Chatbot ID pre tento súbor, prejdite na ChatReact → FAQ Widget → Cache & SEO Settings.

FAQ Caching

Dáta FAQ sú ukladané do cache na vašom serveri pre rýchle načítanie stránok. V ChatReact → FAQ Widget → Cache & SEO Settings môžete:

• Nastaviť Cache Duration — 1, 3, 6 (odporúčané), 12 alebo 24 hodín, alebo cache deaktivovať
• Kliknúť Clear Cache pre okamžité obnovenie vašich FAQ

Cache sa tiež automaticky vyprázdni vždy, keď sa vaše FAQ zmenia v ChatReact dashboarde.

Supported Languages

Plugin podporuje 24 jazykov EÚ:

• bulharčina, chorvátčina, čeština, dánčina, holandčina, angličtina
• estónčina, fínčina, francúzština, nemčina, gréčtina, maďarčina
• írčina, taliančina, lotyština, litovčina, maltčina, poľština
• portugalčina, rumunčina, slovenčina, slovinčina, španielčina, švédčina

Od verzie 1.2.0 sú pre všetkých 24 jazykov zabalené preklady s pluginom. Jazyk widgetu sa detekuje automaticky z aktuálnej stránky, takže viacjazyčné stránky fungujú hneď — použite atribút language v shortcodu len v prípade, že chcete vynútiť konkrétny jazyk.

Troubleshooting

Widget Not Appearing

1. Overte, či je vaše Chatbot ID správne
2. Skontrolujte, či je chatbot aktívny v ChatReact dashboarde
3. Vymažte cache akýchkoľvek pluginov pre stránku (pozri nižšie)
4. Skontrolujte konzolu prehliadača pre JavaScript chyby

Caching Plugin Compatibility

Plugin je plne kompatibilný s populárnymi caching a optimalizačnými pluginmi vrátane WP Rocket, LiteSpeed Cache, Autoptimize a WP Super Cache. Plugin automaticky zabráni týmto nástrojom v minifikovaní alebo cachovaní ChatReact skriptov.

Ak stále zažívate problémy (napr. 404 chyby, widget sa nenačítava pre odhlásených návštevníkov):

1. Vymažte cache vášho caching pluginu
2. Vylúčte chatreact z JS minifikácie/kombinácie v nastaveniach caching pluginu
3. Plugin používa data-api-url atribúty ako fallback, aby zabezpečil správnu komunikáciu s API

FAQs Not Updating

Ak vaša stránka zobrazuje neaktuálne FAQ, prejdite do ChatReact → FAQ Widget a kliknite Clear Cache. Cache sa tiež vymaže automaticky, keď upravíte vaše FAQ v ChatReact dashboarde.

Styling Conflicts

Ak widget vyzerá rozbitý:

• Widget používa izolované CSS
• Skontrolujte pravidlá CSS !important vo vašej téme
• Skúste dočasne deaktivovať iné chat pluginy

Multiple Widgets

Môžete používať rôzne chatboty na rôznych stránkach tým, že v každom shortc code alebo bloku zadáte jedinečné ID.

CMS Integration (Smart Sitemap)

Od verzie 1.1.0 ChatReact WordPress plugin obsahuje funkciu Smart Sitemap, ktorá poskytuje ChatReact crawleru štruktúrované metadata obsahu priamo z vašej WordPress stránky.

How It Works

1. Generate an Integration Key v ChatReact dashboarde (Knowledge Base → Websites → CMS Integrations)
2. Paste the key do nastavení WordPress pluginu v karte Integration
3. Select content types ktoré chcete zdieľať (Pages, Posts, Custom Post Types)
4. Set priorities (High/Medium/Low) pre jednotlivé typy obsahu
5. Pri prehľadávaní vašej webstránky ChatReact automaticky použije smart sitemap namiesto bežného objavovania cez odkazy

Benefits

• Faster crawling – Priamy zoznam URL namiesto objavovania odkaz po odkaze
• Content type awareness – Crawler vie, či je URL Page, Post alebo Custom Post Type
• Priority-based indexing – Dôležitý obsah (napr. Pages) môže mať vyššiu váhu než blogové príspevky
• Selective sharing – Zdieľajte len typy obsahu, ktoré chcete
• Per-post exclusion – Vylúčte jednotlivé príspevky/stránky zo sitemapu cez meta box

Priority Levels

Security

Smart sitemap endpoint (/wp-json/chatreact/v1/sitemap) je chránený Integration Key. Nie je viditeľný pre vyhľadávače ani iné crawlery — prístup má iba ChatReact s platným kľúčom.

Excluding Individual Posts

V editore WordPress má každý príspevok/stránka meta box ChatReact Widget s možnosťou "Exclude from ChatReact Sitemap". Zaškrtnuté príspevky sa nebudú zobrazovať v smart sitemap.

Requirements

• WordPress 5.8 alebo vyšší
• PHP 7.4 alebo vyšší
• ChatReact účet (sign up free)

Changelog

1.2.0

• NEW: Zabalené preklady pre všetkých 24 oficiálnych jazykov EÚ

1.1.3

• FIX: FAQ widgety s jednou kategóriou už nezobrazujú zbytočné tlačidlo "All" a štítky kategórií

1.1.2

• NEW: Server-side rendering pre FAQ widgety — FAQ sú viditeľné pre vyhľadávače a LLM bez JavaScriptu
• NEW: JSON-LD štruktúrované dáta (FAQPage schema) pre lepšie SEO a rich výsledky
• NEW: llms.txt endpoint pre zistiteľnosť AI crawlerov
• NEW: Automatické vymazanie FAQ cache pri zmenách obsahu v ChatReact dashboarde

1.1.1

• FIX: Vylepšenia prekladov (rumunčina, holandčina)

1.1.0

• NEW: Smart Sitemap (CMS Integration) — štruktúrované zdieľanie obsahu s ChatReact crawlerom
• NEW: Karta Integration v nastaveniach pluginu
• NEW: Výber typov obsahu s úrovňami priority
• NEW: Vylúčenie jednotlivých príspevkov zo sitemap cez meta box
• NEW: Chránený REST API endpoint pre smart sitemap
• FIX: Plná kompatibilita s caching pluginmi (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
• FIX: Problémy s načítaním widgetu pre odhlásených návštevníkov pri caching pluginoch

1.0.24

• Widget Assignments — priraďovanie chatbotov na stránky priamo z nastavení pluginu
• Podpora Gutenberg blokov
• Integrácia s Elementor
• Preklady do 24 jazykov
• Page-level priradenie widgetu
• CHANGED: Nastavenia widgetu sú teraz spravované centrálne v ChatReact dashboarde — odstránené atribúty shortcodu position, primary_color a auto_open (language je stále podporovaný)

Next Steps

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