DomovDokumentacija

WordPress vtičnik

Dodajte ChatReact AI klepetalnike, kontaktne obrazce in FAQ akordeone na svojo WordPress stran z našim uradnim vtičnikom.

Prenos

Vtičnik je na voljo v uradnem WordPress Plugin Directory, ali kot neposredni prenos:

Download ChatReact Plugin v1.2.0

Namestitev

Metoda 1: WordPress Plugin Directory (Priporočeno)

  1. Pojdite v Vtičniki → Dodaj nov v vašem WordPress upravnem delu
  2. Poiščite ChatReact
  3. Kliknite Namesti zdaj, nato Aktiviraj

Metoda 2: Naložite preko WordPress upravnega vmesnika

  1. Prenesite zgoraj navedeno ZIP datoteko vtičnika
  2. Pojdite v Vtičniki → Dodaj nov → Naloži vtičnik
  3. Izberite ZIP datoteko in kliknite Namesti zdaj
  4. Kliknite Aktiviraj vtičnik

Metoda 3: Ročni prenos preko FTP

  1. Razširite ZIP datoteko
  2. Naložite mapo chatreact v /wp-content/plugins/
  3. Pojdite v Vtičniki v WordPress upravnem delu
  4. Poiščite "ChatReact" in kliknite Aktiviraj

Konfiguracija

Po aktivaciji odprite meni ChatReact v stranski vrstici WordPress upravnega dela za nastavitve in navodila za uporabo.

Kje najti ID vašega klepetalnika

  1. Prijavite se na chatreact.ai
  2. Pojdite na nadzorno ploščo (Dashboard) vašega klepetalnika
  3. Kliknite gumb Copy poleg Chatbot ID (prikazan na vrhu)

Kje najti ID obrazca

  1. Prijavite se na chatreact.ai
  2. Pojdite na Forms
  3. Kliknite Copy embed code na vašem obrazcu (ali odprite obrazec in preklopite na zavihek Embed)
  4. Vaš Form ID je vrednost data-form-id v kopirani embed kodi

Možnosti uporabe

Vtičnik ponuja več načinov za dodajanje ChatReact na vašo spletno stran:

1. Shortcode-i

Dodajte na katerokoli stran, objavo ali področje gradnika:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Neobvezni atributi: language

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Neobvezni atributi: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Neobvezni atributi: categories, container, language

Vizualne nastavitve, kot so položaj, barve in samodejno odpiranje, se upravljajo centralno na vaši ChatReact nadzorni plošči in se samodejno uporabijo na vaši WordPress strani. Atribut language je neobvezen pri vseh shortcode-ih — če ga izpustite, se trenutni jezik strani zazna samodejno (deluje z večjezičnimi spletnimi mesti).

2. Gutenberg bloki

V urejevalniku blokov:

  1. Kliknite + za dodajanje bloka
  2. Poiščite "ChatReact"
  3. Izberite ChatReact Chat, ChatReact Form, ali ChatReact FAQ
  4. Vnesite svoj ID v nastavitvah bloka

3. Elementor

Če uporabljate Elementor:

  1. Uredite svojo stran z Elementorjem
  2. V iskalniku gradnikov poiščite "ChatReact"
  3. Povlecite gradnik na stran
  4. Konfigurirajte v levem panelu

4. Dodelitve gradnikov (nastavitve vtičnika)

Prikažite klepetalnik na določenih straneh — ali na celotnem spletišču — brez urejanja vsebine:

  1. Odprite meni ChatReact v stranski vrstici upravne konzole
  2. Na zavihku Chat Widget poiščite Widget Assignments
  3. Kliknite Add Assignment, izberite stran ali objavo (ali izberite Everywhere) in vnesite vaš Chatbot ID
  4. Kliknite Save Changes

Za dodelitve Everywhere lahko izključite določene URL-je — en URL na vrstico, z podporo za wildcard (npr. /blog/* ali /checkout) — da skrijete gradnik na pristajalnih straneh ali med postopkom nakupa.

Privzeto so pri iskanju za dodelitve iskane samo Strani (Pages). Kliknite gumb Post Types, da tudi druge vrste vsebin (npr. Posts ali prilagojene vrste objav) postanejo iskane.

5. Dodelitev na ravni strani

Dodelite klepetalnik posamezni strani neposredno iz urejevalnika:

  1. Uredite katerokoli stran ali objavo
  2. Poiščite meta polje "ChatReact Widget"
  3. Označite Enable custom widget for this page
  4. Vnesite vaš Chatbot ID in po želji izberite položaj (Default, Bottom Right, Bottom Left)
  5. Shrani stran

Isto meta polje ponuja tudi možnost Disable all widgets on this page, če želite na določenih straneh popolnoma skriti ChatReact.

Primeri shortcode-ov

Osnovni Chat Widget

[chatreact id="abc123"]

Chat Widget z določenim jezikom

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

FAQ s filtrom po kategorijah

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

Stiliziran kontaktni obrazec

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

FAQ widget: SEO & predpomnjenje

SEO-prijazni FAQ-i

Od različice 1.1.2 so FAQ widgeti upodobljeni na strežniku: vaši FAQ-i so del HTML strani in vključujejo JSON-LD strukturirane podatke (FAQPage shema). Iskalniki in AI asistenti jih lahko preberejo brez zagona JavaScripta.

llms.txt za AI pajke

Vtičnik lahko postreže vsebino vaših FAQ-ov na yoursite.com/llms.txt, datoteko za odkrivanje, ki jo berejo AI pajki. Privzeto je omogočena. Če jo želite vklopiti/izklopiti ali nastaviti določen Chatbot ID za datoteko, pojdite v ChatReact → FAQ Widget → Cache & SEO Settings.

Predpomnjenje FAQ-ov

Podatki FAQ so predpomnjeni na vašem strežniku za hitro nalaganje strani. V ChatReact → FAQ Widget → Cache & SEO Settings lahko:

  • Nastavite Cache Duration — 1, 3, 6 (priporočeno), 12 ali 24 ur, ali izklopite predpomnjenje
  • Kliknite Clear Cache, da takoj osvežite vaše FAQ-e

Predpomnilnik se samodejno izprazni tudi vsakič, ko se vaši FAQ-i spremenijo na ChatReact nadzorni plošči.

Podprti jeziki

Vtičnik podpira 24 jezikov EU:

  • Bolgarščina, Hrvaščina, Češčina, Danščina, Nizozemščina, Angleščina
  • Estonščina, Finščina, Francoščina, Nemščina, Grščina, Madžarščina
  • Irščina, Italijanščina, Latviščina, Litovščina, Maltaščina, Poljščina
  • Portugalščina, Romunščina, Slovaščina, Slovenščina, Španščina, Švedščina

Od različice 1.2.0 so prevodi za vseh 24 jezikov vključeni v vtičnik. Jezik gradnika se samodejno zazna iz trenutne strani, zato večjezična spletna mesta delujejo takoj — atributa language shortcode uporabite le, če želite prisiliti določen jezik.

Odpravljanje težav

Gradnik se ne prikazuje

  1. Preverite, ali je vaš Chatbot ID pravilen
  2. Preverite, ali je klepetalnik aktiven na vaši ChatReact nadzorni plošči
  3. Počistite morebitne vtičnike za predpomnjenje strani (glejte spodaj)
  4. Preverite konzolo brskalnika za JavaScript napake

Združljivost z vtičniki za predpomnjenje

Vtičnik je popolnoma združljiv s priljubljenimi vtičniki za predpomnjenje in optimizacijo, vključno z WP Rocket, LiteSpeed Cache, Autoptimize in WP Super Cache. Vtičnik samodejno prepreči tem orodjem, da minificirajo ali predpomnijo ChatReact skripte.

Če še vedno doživljate težave (npr. 404 napake, gradnik se ne naloži za odjavljene obiskovalce):

  1. Počistite predpomnilnik vašega vtičnika za predpomnjenje
  2. Izključite chatreact iz JS minifikacije/združitve v nastavitvah vtičnika za predpomnjenje
  3. Vtičnik uporablja atribut data-api-url kot rezervno rešitev za zagotovitev pravilne komunikacije z API-jem

FAQ-i se ne posodabljajo

Če vaša stran prikazuje zastarele FAQ-e, pojdite v ChatReact → FAQ Widget in kliknite Clear Cache. Predpomnilnik se izprazni tudi samodejno, ko uredite FAQ-e na ChatReact nadzorni plošči.

Konflikti s stiliranjem

Če gradnik izgleda pokvarjen:

  • Gradnik uporablja izoliran CSS
  • Preverite prisotnost CSS !important pravil v vaši temi
  • Poskusite začasno onemogočiti druge klepetalne vtičnike

Več gradnikov

Lahko uporabite različne klepetalnike na različnih straneh tako, da v vsakem shortcode-u ali bloku navedete različne ID-je.

Integracija CMS (Smart Sitemap)

Začenši z različico 1.1.0 vtičnik ChatReact za WordPress vključuje funkcijo Smart Sitemap, ki ChatReact pajkom zagotavlja strukturirane metapodatke o vsebini neposredno iz vašega WordPress spletnega mesta.

Kako deluje

  1. Ustvarite Integration Key na ChatReact nadzorni plošči (Knowledge Base → Websites → CMS Integrations)
  2. Prilepite ključ v nastavitve vtičnika v WordPressu pod zavihkom Integration
  3. Izberite vrste vsebin, ki jih želite deliti (Pages, Posts, Custom Post Types)
  4. Nastavite prioritete (High/Medium/Low) za vsako vrsto vsebine
  5. Ko pajk preišče vaše spletno mesto, bo ChatReact samodejno uporabil smart sitemap namesto običajnega odkrivanja po povezavah

Prednosti

  • Hitrejše preiskovanje – neposreden seznam URL-jev namesto odkrivanja po povezavah
  • Zavedanje vrste vsebine – pajk ve, ali je URL Stran, Objavo ali Prilagojena vrsta objave
  • Indeksiranje na podlagi prioritet – pomembna vsebina (npr. Strani) je lahko utežena višje kot blog objave
  • Selektivno deljenje – delite samo vrste vsebin, ki jih želite
  • Izključitev na ravni objave – izključite posamezne objave/strani iz sitemapa prek meta polja

Ravni prioritet

PriorityDefault forDescription
HighPagesOsnovna poslovna vsebina (O nas, Storitve, Kontakt)
MediumPostsBlog članki, novice
LowDopolnilna vsebina

Varnost

Končna točka smart sitemapa (/wp-json/chatreact/v1/sitemap) je zaščitena z Integration Key. Ni vidna iskalnikom ali drugim pajkom — do nje lahko dostopa le ChatReact z veljavnim ključem.

Izključitev posameznih objav

V urejevalniku WordPress ima vsaka objava/stran meta polje ChatReact Widget z možnostjo "Exclude from ChatReact Sitemap". Označene objave se ne bodo pojavile v smart sitemapu.

Zahteve

  • WordPress 5.8 ali novejši
  • PHP 7.4 ali novejši
  • ChatReact račun (sign up free)

Zapis sprememb (Changelog)

1.2.0

  • NEW: Vključeni prevodi za vseh 24 uradnih jezikov EU

1.1.3

  • FIX: FAQ widgeti z eno samo kategorijo več ne prikazujejo nepotrebnega gumba "All" in značk kategorij

1.1.2

  • NEW: Upodabljanje na strežniku za FAQ widgete — FAQ-i so vidni iskalnikom in LLM-jem brez JavaScripta
  • NEW: JSON-LD strukturirani podatki (FAQPage shema) za izboljšan SEO in bogate rezultate
  • NEW: llms.txt končna točka za odkrivanje s strani AI pajkov
  • NEW: Samodejno izpraznjenje predpomnilnika FAQ-ov, ko se vsebina spremeni na ChatReact nadzorni plošči

1.1.1

  • FIX: Izboljšave prevodov (romunščina, nizozemščina)

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — strukturirano deljenje vsebin s ChatReact pajkom
  • NEW: Zavihek Integration v nastavitvah vtičnika
  • NEW: Izbira vrst vsebine s prioriteto
  • NEW: Izključitev na ravni objave prek meta polja
  • NEW: Zaščitena REST API končna točka za smart sitemap
  • FIX: Popolna združljivost z vtičniki za predpomnjenje (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
  • FIX: Težave z nalaganjem gradnika za odjavljene obiskovalce pri vtičnikih za predpomnjenje

1.0.24

  • Dodelitve gradnikov — dodelite klepetalnike stranem neposredno iz nastavitev vtičnika
  • Podpora za Gutenberg bloke
  • Integracija z Elementorjem
  • 24 prevodov jezikov
  • Dodelitev gradnika na ravni strani
  • CHANGED: Nastavitve gradnika se zdaj upravljajo centralno na ChatReact nadzorni plošči — odstranjeni atributi shortcode position, primary_color in auto_open (language je še vedno podprt)

Naslednji koraki