PočetnaDokumentacija

WordPress Plugin

Dodajte ChatReact AI chatbote, kontakt forme i FAQ akordeone na svoju WordPress stranicu s našim službenim dodatkom.

Preuzimanje

Dodatak je dostupan u službenom WordPress Plugin Directory, ili kao direktno preuzimanje:

Download ChatReact Plugin v1.2.0

Instalacija

Metoda 1: WordPress Plugin Directory (Preporučeno)

  1. Idite na Plugins → Add New u WordPress administratorskom sučelju
  2. Potražite ChatReact
  3. Kliknite Install Now, zatim Activate

Metoda 2: Upload putem WordPress administracije

  1. Preuzmite ZIP datoteku dodatka gore
  2. Idite na Plugins → Add New → Upload Plugin
  3. Odaberite ZIP datoteku i kliknite Install Now
  4. Kliknite Activate Plugin

Metoda 3: Ručni upload preko FTP-a

  1. Raspakirajte ZIP datoteku
  2. Učitajte mapu chatreact u /wp-content/plugins/
  3. Idite na Plugins u WordPress administraciji
  4. Pronađite "ChatReact" i kliknite Activate

Konfiguracija

Nakon aktivacije, otvorite izbornik ChatReact u bočnoj traci vaše WordPress administracije za postavke i upute za korištenje.

Pronalaženje ID-a chatbota

  1. Prijavite se na chatreact.ai
  2. Idite na nadzornu ploču (Dashboard) vašeg chatbota
  3. Kliknite gumb Copy pored Chatbot ID-a (prikazan pri vrhu)

Pronalaženje ID-a forme

  1. Prijavite se na chatreact.ai
  2. Idite na Forms
  3. Kliknite Copy embed code na vašoj formi (ili otvorite formu i prebacite se na karticu Embed)
  4. Vaš Form ID je vrijednost data-form-id u kopiranom embed kodu

Opcije korištenja

Dodatak nudi više načina za dodavanje ChatReact-a na vašu stranicu:

1. Shortcodeovi

Dodajte na bilo koju stranicu, post ili widget područje:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Opcionalni atributi: language

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Opcionalni atributi: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Opcionalni atributi: categories, container, language

Vizualne postavke poput položaja, boja i automatskog otvaranja upravljaju se centralno na vašoj ChatReact nadzornoj ploči i primjenjuju se na vašu WordPress stranicu automatski. Atribut language je opcionalan kod svih shortcodeova — ako ga izostavite, trenutni jezik stranice se automatski detektira (radi s višejezičnim stranicama).

2. Gutenberg blokovi

U block editoru:

  1. Kliknite + za dodavanje bloka
  2. Potražite "ChatReact"
  3. Odaberite ChatReact Chat, ChatReact Form, ili ChatReact FAQ
  4. Unesite svoj ID u postavkama bloka

3. Elementor

Ako koristite Elementor:

  1. Uredite svoju stranicu s Elementorom
  2. Potražite "ChatReact" u widgetima
  3. Povucite widget na stranicu
  4. Konfigurirajte u lijevom panelu

4. Dodjela widgeta (postavke dodatka)

Prikaz chatbota na određenim stranicama — ili na cijeloj stranici — bez uređivanja sadržaja:

  1. Otvorite izbornik ChatReact u bočnoj traci administracije
  2. Na kartici Chat Widget pronađite Widget Assignments
  3. Kliknite Add Assignment, odaberite stranicu ili post (ili odaberite Everywhere), i unesite vaš Chatbot ID
  4. Kliknite Save Changes

Za Everywhere dodjele možete isključiti specifične URL-ove — jedan po retku, s podrškom za wildcard (npr. /blog/* ili /checkout) — kako biste sakrili widget na landing stranicama ili tijekom checkout-a.

Po defaultu su pretraživane samo Pages prilikom dodjele. Kliknite gumb Post Types da biste omogućili pretraživanje drugih tipova sadržaja (npr. Posts ili custom post types).

5. Dodjela na razini stranice

Dodijelite chatbota jednoj stranici izravno iz editora:

  1. Uredite bilo koju stranicu ili post
  2. Pronađite meta box "ChatReact Widget"
  3. Označite Enable custom widget for this page
  4. Unesite vaš Chatbot ID i opcionalno odaberite položaj (Default, Bottom Right, Bottom Left)
  5. Spremite stranicu

Isti meta box također nudi opciju Disable all widgets on this page ako želite potpuno sakriti ChatReact na određenim stranicama.

Primjeri shortcodeova

Osnovni Chat Widget

[chatreact id="abc123"]

Chat Widget s fiksnim jezikom

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

FAQ s filtriranjem po kategoriji

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

Stilizirana kontakt forma

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

FAQ Widget: SEO & Cache

SEO-prijateljski FAQ-ovi

Od verzije 1.1.2, FAQ widgeti se renderiraju server-side: vaši FAQ-ovi su dio HTML stranice i uključuju JSON-LD strukturirane podatke (FAQPage shema). Tražilice i AI asistenti ih mogu čitati bez izvođenja bilo kakvog JavaScripta.

llms.txt za AI crawlere

Dodatak može poslužiti vaš FAQ sadržaj na yoursite.com/llms.txt, datoteci za otkrivanje koju čitaju AI crawlovi. Omogućen je prema zadanim postavkama. Za uključivanje/isključivanje ili postavljanje specifičnog Chatbot ID-a za datoteku, idite na ChatReact → FAQ Widget → Cache & SEO Settings.

Keširanje FAQ-ova

Podaci FAQ-a su keširani na vašem poslužitelju radi brzog učitavanja stranica. U ChatReact → FAQ Widget → Cache & SEO Settings možete:

  • Postaviti Cache Duration — 1, 3, 6 (preporučeno), 12 ili 24 sata, ili onemogućiti keširanje
  • Kliknuti Clear Cache za trenutno osvježavanje vaših FAQ-ova

Keš se također automatski briše kad god se vaši FAQ-ovi promijene na ChatReact nadzornoj ploči.

Podržani jezici

Dodatak podržava 24 jezika EU:

  • Bugarski, Hrvatski, Češki, Danski, Nizozemski, Engleski
  • Estonski, Finski, Francuski, Njemački, Grčki, Mađarski
  • Irski, Talijanski, Latvijski, Litavski, Malteški, Poljski
  • Portugalski, Rumunjski, Slovacki, Slovenski, Španjolski, Švedski

Od verzije 1.2.0, prijevodi za svih 24 jezika su uključeni s dodatkom. Jezik widgeta se automatski detektira iz trenutne stranice, pa višejezične stranice rade odmah — koristite language shortcode atribut samo ako želite forsirati određeni jezik.

Otklanjanje poteškoća

Widget se ne prikazuje

  1. Provjerite je li vaš Chatbot ID točan
  2. Provjerite je li chatbot aktivan na vašoj ChatReact nadzornoj ploči
  3. Očistite sve pluginove za keširanje stranica (vidi dolje)
  4. Provjerite konzolu preglednika za JavaScript greške

Kompatibilnost s keširnim pluginovima

Dodatak je potpuno kompatibilan s popularnim caching i optimization pluginovima uključujući WP Rocket, LiteSpeed Cache, Autoptimize, i WP Super Cache. Dodatak automatski sprječava ove alate da minificiraju ili keširaju ChatReact skripte.

Ako i dalje imate problema (npr. 404 greške, widget se ne učitava za odjavljene posjetitelje):

  1. Očistite keš vašeg caching plugina
  2. Isključite chatreact iz JS minifikacije/komponiranja u postavkama caching plugina
  3. Dodatak koristi data-api-url atribute kao fallback kako bi osigurao ispravnu API komunikaciju

FAQ-ovi se ne ažuriraju

Ako vaša stranica prikazuje zastarjele FAQ-ove, idite na ChatReact → FAQ Widget i kliknite Clear Cache. Keš se također briše automatski kada uredite FAQ-ove na ChatReact nadzornoj ploči.

Sukobi u stilu

Ako widget izgleda pokvareno:

  • Widget koristi izolirani CSS
  • Provjerite ima li u vašoj temi CSS !important pravila
  • Pokušajte privremeno onemogućiti druge chat plugine

Više widgeta

Možete koristiti različite chatbote na različitim stranicama tako da navedete jedinstvene ID-e u svakom shortcodeu ili bloku.

Integracija CMS-a (Smart Sitemap)

Počevši od verzije 1.1.0, ChatReact WordPress dodatak uključuje značajku Smart Sitemap koja pruža ChatReact crawleru strukturirane metapodatke sadržaja izravno s vaše WordPress stranice.

Kako radi

  1. Generirajte Integration Key na ChatReact nadzornoj ploči (Knowledge Base → Websites → CMS Integrations)
  2. Zalijepite ključ u postavke WordPress dodatka pod karticom Integration
  3. Odaberite tipove sadržaja koje želite dijeliti (Pages, Posts, Custom Post Types)
  4. Postavite prioritete (High/Medium/Low) po tipu sadržaja
  5. Kad crawlate svoju web stranicu, ChatReact će automatski koristiti smart sitemap umjesto regularnog otkrivanja po linkovima

Prednosti

  • Brže crawlanje – izravan popis URL-ova umjesto otkrivanja link-po-link
  • Svijest o tipu sadržaja – crawler zna je li URL Page, Post ili Custom Post Type
  • Indexiranje po prioritetu – važan sadržaj (kao Pages) može imati veću težinu od blog postova
  • Selektivno dijeljenje – dijelite samo tipove sadržaja koje želite
  • Isključivanje po postu – isključite pojedinačne postove/stranice iz sitemap-a putem meta boxa

Razine prioriteta

PriorityDefault forDescription
HighPagesTemeljni poslovni sadržaj (About, Services, Contact)
MediumPostsBlog članci, novosti
LowPomoćni sadržaj

Sigurnost

Smart sitemap endpoint (/wp-json/chatreact/v1/sitemap) zaštićen je Integration Key-om. Nije vidljiv tražilicama ili drugim crawlerima — samo ChatReact može pristupiti njemu s ispravnim ključem.

Isključivanje pojedinačnih postova

U WordPress editoru, svaki post/stranica ima ChatReact Widget meta box s opcijom "Exclude from ChatReact Sitemap". Označeni postovi se neće pojaviti u smart sitemap-u.

Zahtjevi

  • WordPress 5.8 ili noviji
  • PHP 7.4 ili noviji
  • ChatReact račun (sign up free)

Changelog

1.2.0

  • NEW: Uključeni prijevodi za svih 24 službena jezika EU

1.1.3

  • FIX: FAQ widgeti s jednom kategorijom više ne prikazuju nepotreban gumb filtra "All" i oznake kategorija

1.1.2

  • NEW: Server-side renderiranje za FAQ widgete — FAQ-ovi su vidljivi tražilicama i LLM-ovima bez JavaScripta
  • NEW: JSON-LD strukturirani podaci (FAQPage shema) za poboljšani SEO i rich rezultate
  • NEW: llms.txt endpoint za otkrivanje od strane AI crawlova
  • NEW: Automatsko čišćenje cache-a FAQ-ova kada se sadržaj promijeni na ChatReact nadzornoj ploči

1.1.1

  • FIX: Poboljšanja prijevoda (Rumunjski, Nizozemski)

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — strukturirano dijeljenje sadržaja s ChatReact crawlerom
  • NEW: Integration kartica u postavkama dodatka
  • NEW: Odabir tipova sadržaja s razinama prioriteta
  • NEW: Isključivanje po postu iz sitemap-a putem meta boxa
  • NEW: Zaštićeni REST API endpoint za smart sitemap
  • FIX: Potpuna kompatibilnost s caching pluginovima (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
  • FIX: Problemi pri učitavanju widgeta za odjavljene posjetitelje s caching pluginovima

1.0.24

  • Dodjele widgeta — dodijelite chatbote stranicama izravno iz postavki dodatka
  • Podrška za Gutenberg blokove
  • Integracija s Elementorem
  • 24 prijevoda jezika
  • Dodjela widgeta na razini stranice
  • CHANGED: Postavke widgeta sada se upravljaju centralno na ChatReact nadzornoj ploči — uklonjeni atributi shortcode-a position, primary_color, i auto_open (language je i dalje podržan)

Sljedeći koraci