WordPress Plugin

Přidejte ChatReact AI chatboty, kontaktní formuláře a FAQ akordeony na své WordPress stránky pomocí našeho oficiálního pluginu.

Stažení

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

Download ChatReact Plugin v1.2.0

Instalace

Metoda 1: WordPress Plugin Directory (Doporučeno)

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

Metoda 2: Nahrání přes WordPress administraci

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

Metoda 3: Ruční nahrání přes 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 na Activate

Konfigurace

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

Jak najít ID chatbota

1. Přihlaste se na chatreact.ai
2. Přejděte na Dashboard vašeho chatbota
3. Klikněte na tlačítko Copy vedle Chatbot ID (zobrazené nahoře)

Jak najít ID formuláře

1. Přihlaste se na chatreact.ai
2. Přejděte na Forms
3. Klikněte na Copy embed code u svého formuláře (nebo otevřete formulář a přepněte na kartu Embed)
4. Vaše Form ID je hodnota data-form-id v zkopírovaném embed kódu

Možnosti použití

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

1. Shortcodes

Přidejte na jakoukoli stránku, příspěvek nebo oblast widgetu:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Nepovinné atributy: language

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Nepovinné atributy: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Nepovinné atributy: categories, container, language

2. Gutenberg Blocks

V editoru bloků:

1. Klikněte na + 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. Upravit stránku s Elementor
2. Vyhledejte "ChatReact" mezi widgety
3. Přetáhněte widget na stránku
4. Nakonfigurujte v levém panelu

4. Přiřazení widgetů (nastavení pluginu)

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

1. Otevřete menu ChatReact v postranním panelu administrace
2. Na kartě Chat Widget najděte Widget Assignments
3. Klikněte na Add Assignment, zvolte stránku nebo příspěvek (nebo vyberte Everywhere) a zadejte své Chatbot ID
4. Klikněte na Save Changes

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

Ve výchozím nastavení jsou při přiřazování prohledatelné pouze Pages. Klikněte na tlačítko Post Types, aby byly prohledatelné i jiné typy obsahu (např. Posts nebo vlastní typy příspěvků).

5. Přiřazení na úrovni stránky

Přiřaďte chatbota jedné 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 na určitých stránkách ChatReact úplně skrýt.

Příklady shortcode

Základní Chat Widget

[chatreact id="abc123"]

Chat Widget s pevně nastaveným jazykem

[chatreact id="abc123" language="de"]

FAQ s filtrem kategorií

[chatreact_faq id="abc123" categories="shipping,returns"]

Stylovaný kontaktní formulář

[chatreact_form id="form123" language="en"]

FAQ Widget: SEO & Caching

SEO-friendly FAQ

Od verze 1.1.2 jsou FAQ widgety renderovány server-side: 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 pro AI crawlery

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

Cache FAQ

Data FAQ jsou cachována 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 cache vypnout
• Kliknout na Clear Cache pro okamžité obnovení vašich FAQ

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

Podporované jazyky

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 detekován automaticky z aktuální stránky, takže vícejazyčné weby fungují ihned — používejte atribut language ve shortcode pouze, pokud chcete vynutit konkrétní jazyk.

Řešení problémů

Widget se nezobrazuje

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 cache jakýchkoli pluginů pro stránkování (viz níže)
4. Zkontrolujte konzoli prohlížeče na chyby JavaScriptu

Kompatibilita s caching pluginy

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 zabrání těmto nástrojům v minifikaci nebo cachování ChatReact skriptů.

Pokud stále zažívá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 minifikace/kombinace JS v nastavení caching pluginu
3. Plugin používá atributy data-api-url jako fallback, aby zajistil správnou komunikaci s API

FAQ se neaktualizují

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

Konflikty se styly

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

Více widgetů

Můžete používat různé chatboty na různých stránkách tím, že zadáte unikátní ID v každém shortcode nebo bloku.

Integrace CMS (Smart Sitemap)

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

Jak to funguje

1. Vygenerujte Integration Key v ChatReact dashboardu (Knowledge Base → Websites → CMS Integrations)
2. Vložte klíč do nastavení WordPress pluginu pod kartou 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í odkaz po odkazu

Přínosy

• Rychlejší crawlování – Přímý seznam URL místo objevování odkaz po odkazu
• Povědomí o typech obsahu – Crawler ví, zda je URL Page, Post nebo Custom Post Type
• Indexování podle priority – Důležitý obsah (jako Pages) může mít vyšší váhu než blogové příspěvky
• Selektivní sdílení – Sdílejte pouze typy obsahu, které chcete
• Vyloučení po příspěvku – Vylučte jednotlivé příspěvky/stránky ze sitemap přes meta box

Úrovně priorit

Zabezpečení

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

Vyloučení jednotlivých příspěvků

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 v smart sitemap nezobrazí.

Požadavky

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

Změny

1.2.0

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

1.1.3

• FIX: FAQ widgety s jednou kategorií již nezobrazují zbytečné tlačítko filtru "All" a odznaky 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ě obsahu v ChatReact dashboardu

1.1.1

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

1.1.0

• NEW: Smart Sitemap (CMS Integration) — strukturované sdílení obsahu s ChatReact crawlerem
• NEW: Karta Integration v nastavení pluginu
• NEW: Výběr typů obsahu s úrovněmi priority
• NEW: Vyloučení po příspěvku ze sitemap 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ů ke stránkám přímo z nastavení pluginu
• Podpora Gutenberg bloků
• Integrace s Elementorem
• 24 jazykových překladů
• Přiřazení widgetu na úrovni stránky
• CHANGED: Nastavení widgetu jsou nyní spravována centrálně v ChatReact dashboardu — atributy shortcode position, primary_color a auto_open byly odstraněny (language je stále podporován)

Další kroky

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