DomůDokumentace

WordPress Plugin

Přidejte ChatReact AI chatboty, kontaktní formuláře a FAQ akordeony na své WordPress stránky s naším oficiálním pluginem.

Download

Plugin je dostupný v oficiálním WordPress Plugin Directory, nebo jako přímé stažení:

Download ChatReact Plugin v1.2.1

Installation

Method 1: WordPress Plugin Directory (Recommended)

  1. Přejděte do Plugins → Add New ve WordPress administraci
  2. Vyhledejte ChatReact
  3. Klikněte na Install Now, poté Aktivovat

Method 2: Upload via WordPress Admin

  1. Stáhněte výše uvedený ZIP soubor pluginu
  2. Přejděte do Plugins → Add New → Upload Plugin
  3. Vyberte ZIP soubor a klikněte Install Now
  4. Klikněte Activate Plugin

Method 3: Manual Upload via FTP

  1. Rozbalte ZIP soubor
  2. Nahrajte složku chatreact do /wp-content/plugins/
  3. Přejděte do Plugins v administraci WordPress
  4. Najděte "ChatReact" a klikněte Aktivovat

Configuration

Po aktivaci otevřete v postranním menu administrace položku ChatReact pro nastavení a pokyny k použití.

Finding Your Chatbot ID

  1. Přihlaste se na chatreact.ai
  2. Otevřete svého chatbota a přejděte na kartu Vložení
  3. Klikněte Kopírovat kód pro kopírování embed snippet, nebo si přečtěte ID z atributu data-chatbot-id ve zkopírovaném kódu

Finding Your Form ID

  1. Přihlaste se na chatreact.ai
  2. Přejděte na Formuláře
  3. Klikněte Zkopírovat embed kód u svého formuláře (nebo otevřete formulář a přepněte na kartu Vložení)
  4. Vaše Form ID je hodnota data-form-id ve zkopírovaném embed kódu

Usage Options

Plugin nabízí několik způsobů, jak přidat ChatReact na vaše stránky:

1. Shortcodes

Přidejte do kterékoliv stránky, příspěvku nebo widget oblasti:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Volitelné atributy: language

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Volitelné atributy: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Volitelné atributy: categories, container, language

Vizuální nastavení jako pozice, barvy a automatické otevírání jsou spravována centrálně v dashboardu ChatReact a automaticky se aplikují na váš WordPress. Atribut language je volitelný u všech shortcodů — pokud jej vynecháte, jazyk aktuální stránky je detekován automaticky (funguje na vícejazyčných stránkách).

2. Gutenberg Blocks

V editoru bloků:

  1. Klikněte + pro přidání bloku
  2. Vyhledejte "ChatReact"
  3. Zvolte ChatReact Chat, ChatReact Form nebo ChatReact FAQ
  4. Zadejte své ID v nastavení bloku

3. Elementor

Pokud používáte Elementor:

  1. Upravte stránku v Elementoru
  2. Vyhledejte "ChatReact" mezi widgety
  3. Přetáhněte widget na stránku
  4. Nakonfigurujte v levém panelu

4. Widget Assignments (Plugin Settings)

Zobrazte chatbota na konkrétních stránkách — nebo na celém webu — bez úprav obsahu:

  1. Otevřete v postranním menu administrace položku ChatReact
  2. Na záložce Chat Widget najděte Widget Assignments
  3. Klikněte Add Assignment, vyberte stránku nebo příspěvek (nebo zvolte Everywhere) a vložte své Chatbot ID
  4. Klikněte Uložit změny

U přiřazení typu Everywhere můžete vyloučit konkrétní URL — jednu na řádek, s podporou wildcardů (např. /blog/* nebo /checkout) — pro skrytí widgetu na landing page nebo během pokladny.

Ve výchozím nastavení jsou při přiřazování prohledávány pouze Pages. Klikněte na tlačítko Post Types pro zpřístupnění dalších typů obsahu (např. Posts nebo vlastní typy) pro vyhledávání.

5. Page-Level Assignment

Přiřaďte chatbota jediné stránce přímo z editoru:

  1. Upravte jakoukoli stránku nebo příspěvek
  2. Najděte meta box "ChatReact Widget"
  3. Zaškrtněte Enable custom widget for this page
  4. Zadejte své Chatbot ID a volitelně vyberte pozici (Default, Bottom Right, Bottom Left)
  5. Uložte stránku

Tentýž meta box také nabízí možnost Disable all widgets on this page, pokud chcete ChatReact na některých stránkách úplně skrýt.

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 verze 1.1.2 jsou FAQ widgety renderovány na serveru: vaše FAQ jsou součástí HTML stránky a obsahují JSON-LD strukturovaná data (FAQPage schema). Vyhledávače a AI asistenti je mohou číst bez spuštění JavaScriptu.

llms.txt for AI Crawlers

Plugin může poskytovat obsah vašich FAQ na yoursite.com/llms.txt, což je soubor pro objevování čtený AI crawlery. Je povolen ve výchozím nastavení. Chcete-li jej přepnout nebo nastavit konkrétní Chatbot ID pro tento soubor, přejděte do ChatReact → FAQ Widget → Cache & SEO Settings.

FAQ Caching

Data FAQ jsou ukládána do mezipaměti na vašem serveru pro rychlé načítání stránek. V ChatReact → FAQ Widget → Cache & SEO Settings můžete:

  • Nastavit Cache Duration — 1, 3, 6 (doporučeno), 12 nebo 24 hodin, nebo mezipaměť deaktivovat
  • Kliknout Clear Cache pro okamžité obnovení FAQ

Mezipaměť se také automaticky vyprázdní vždy, když se vaše FAQ změní v dashboardu ChatReact.

Supported Languages

Plugin podporuje 24 jazyků EU:

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

Od verze 1.2.0 jsou překlady pro všech 24 jazyků zahrnuty v pluginu. Jazyk widgetu je automaticky detekován z aktuální stránky, takže vícejazyčné stránky fungují bez další konfigurace — použijte atribut language u shortcodu pouze pokud chcete vynutit konkrétní jazyk.

Troubleshooting

Widget Not Appearing

  1. Ověřte, že vaše Chatbot ID je správné
  2. Zkontrolujte, zda je chatbot aktivní ve vašem ChatReact dashboardu
  3. Vymažte jakékoli cache pluginy stránek (viz níže)
  4. Zkontrolujte konzoli prohlížeče na JavaScript chyby

Caching Plugin Compatibility

Plugin je plně kompatibilní s populárními caching a optimalizačními pluginy včetně WP Rocket, LiteSpeed Cache, Autoptimize a WP Super Cache. Plugin automaticky brání těmto nástrojům v minifikaci nebo cachování ChatReact skriptů.

Pokud stále máte problémy (např. 404 chyby, widget se nenačítá pro odhlášené návštěvníky):

  1. Vymažte cache vašeho caching pluginu
  2. Vyloučte chatreact z JS minifikace/kombinace v nastavení caching pluginu
  3. Plugin používá data-api-url atributy jako fallback pro zajištění správné komunikace s API

FAQs Not Updating

Pokud váš web zobrazuje zastaralé FAQ, přejděte do ChatReact → FAQ Widget a klikněte Clear Cache. Cache se také automaticky vymaže, když upravíte FAQ v ChatReact dashboardu.

Styling Conflicts

Pokud widget vypadá rozbitě:

  • Widget používá izolované CSS
  • Zkontrolujte pravidla CSS !important ve vašem tématu
  • Zkuste dočasně deaktivovat jiné chat pluginy

Multiple Widgets

Na různých stránkách můžete používat různé chatboty zadáním unikátních ID v každém shortcodu nebo bloku.

CMS Integration (Smart Sitemap)

Od verze 1.1.0 obsahuje ChatReact WordPress plugin funkci Smart Sitemap, která poskytuje ChatReact crawleru strukturovaná metadata obsahu přímo z vašeho WordPress webu.

How It Works

  1. Generate an Integration Key v ChatReact dashboardu (Knowledge Base → Websites → CMS Integrations)
  2. Vložte klíč do nastavení WordPress pluginu pod záložkou Integration
  3. Vyberte typy obsahu, které chcete sdílet (Pages, Posts, Custom Post Types)
  4. Nastavte priority (High/Medium/Low) pro každý typ obsahu
  5. Při procházení vašeho webu ChatReact automaticky použije smart sitemap místo běžného objevování odkazem

Benefits

  • Faster crawling – Přímý seznam URL místo objevování odkaz po odkazu
  • Content type awareness – Crawler ví, zda je URL Page, Post nebo Custom Post Type
  • Priority-based indexing – Důležitý obsah (např. Pages) může mít vyšší váhu než blogové příspěvky
  • Selective sharing – Sdílejte pouze typy obsahu, které chcete
  • Per-post exclusion – Vyloučte jednotlivé příspěvky/stránky ze sitemapu pomocí meta boxu

Priority Levels

PriorityDefault forDescription
HighPagesZákladní obchodní obsah (About, Services, Contact)
MediumPostsBlogové články, novinky
Low–Doplňkový obsah

Security

Smart sitemap endpoint (/wp-json/chatreact/v1/sitemap) je chráněn Integration Key. Není viditelný pro vyhledávače nebo jiné crawlery — přistupuje k němu pouze ChatReact s platným klíčem.

Pokud bezpečnostní plugin omezuje WordPress REST API pouze na přihlášené uživatele, verze 1.2.1 a novější stále propouští požadavky ChatReact s platným Integration Key na /wp-json/chatreact/v1/ — všechny ostatní REST trasy zůstávají blokovány. Pokud firewall blokuje endpoint dříve, než se WordPress načte, povolte /wp-json/chatreact/v1/ v něm. Kdykoli není smart sitemap dostupný, ukáže náhled skenování v ChatReact dashboardu důvod a použije záložní veřejnou sitemapu, která ignoruje vaše výběry typů obsahu.

Excluding Individual Posts

V editoru WordPress má každý příspěvek/stránka meta box ChatReact Widget s možností "Exclude from ChatReact Sitemap". Zaškrtnuté příspěvky se ve smart sitemapu nezobrazí.

Requirements

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

Changelog

1.2.1

  • FIX: Smart sitemap opět dostupný na webech, které omezují REST API na přihlášené uživatele — požadavky s platným Integration Key jsou propouštěny, takže vybrané typy obsahu jsou respektovány při skenování

1.2.0

  • NEW: Zahrnuté překlady pro všech 24 oficiálních jazyků EU

1.1.3

  • FIX: Jedno-kategoriové FAQ widgety už nezobrazují zbytečné tlačítko "All" a značky kategorií

1.1.2

  • NEW: Server-side rendering pro FAQ widgety — FAQ jsou viditelná pro vyhledávače a LLM bez JavaScriptu
  • NEW: JSON-LD strukturovaná data (FAQPage schema) pro lepší SEO a bohaté výsledky
  • NEW: llms.txt endpoint pro objevitelnost AI crawlerů
  • NEW: Automatické vyprázdnění cache FAQ při změnách obsahu v ChatReact dashboardu

1.1.1

  • FIX: Zlepšení překladů (Romanian, Dutch)

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — strukturované sdílení obsahu s ChatReact crawlerem
  • NEW: Záložka Integration v nastavení pluginu
  • NEW: Výběr typů obsahu s úrovněmi priority
  • NEW: Vyloučení jednotlivých příspěvků ze sitemapu přes meta box
  • NEW: Chráněný REST API endpoint pro smart sitemap
  • FIX: Plná kompatibilita s caching pluginy (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
  • FIX: Problémy s načítáním widgetu pro odhlášené návštěvníky s caching pluginy

1.0.24

  • Widget Assignments — přiřazení chatbotů na stránky přímo z nastavení pluginu
  • Podpora Gutenberg bloků
  • Integrace s Elementorem
  • Překlady do 24 jazyků
  • Přiřazení widgetu na úrovni stránky
  • CHANGED: Nastavení widgetu jsou nyní spravována centrálně v ChatReact dashboardu — odstraněny shortcode atributy position, primary_color a auto_open (language je stále podporován)

Next Steps