EtusivuDokumentaatio

WordPress Plugin

Lisää ChatReact AI -chatbotit, yhteydenottolomakkeet ja FAQ-accordionit WordPress-sivustollesi virallisella laajennuksellamme.

Lataus

Laajennus löytyy virallisesta WordPress Plugin Directory -hakemistosta tai suoran latauksen kautta:

Download ChatReact Plugin v1.2.1

Asennus

Menetelmä 1: WordPress Plugin Directory (suositeltu)

  1. Siirry WordPress-hallinnassa kohtaan Plugins → Add New
  2. Etsi ChatReact
  3. Klikkaa Install Now, sitten Ota käyttöön

Menetelmä 2: Lataa WordPress-hallinnan kautta

  1. Lataa yllä oleva laajennuksen ZIP-tiedosto
  2. Siirry kohtaan Plugins → Add New → Upload Plugin
  3. Valitse ZIP-tiedosto ja klikkaa Install Now
  4. Klikkaa Activate Plugin

Menetelmä 3: Manuaalinen lataus FTP:n kautta

  1. Pura ZIP-tiedosto
  2. Lataa chatreact-kansio /wp-content/plugins/
  3. Siirry WordPress-hallinnan Plugins-kohtaan
  4. Etsi "ChatReact" ja klikkaa Ota käyttöön

Määrittely

Aktivoinnin jälkeen avaa ChatReact-valikko WordPress-hallinnan sivupalkista asetuksia ja käyttöönotto-ohjeita varten.

Chatbotin tunnuksen löytäminen

  1. Kirjaudu sisään chatreact.ai
  2. Avaa chatbotisi ja siirry Upota-välilehdelle
  3. Klikkaa Kopioi koodi kopioidaksesi upotuskoodin, tai lue tunnus data-chatbot-id-attribuutista kopioidusta koodista

Lomakkeen tunnuksen löytäminen

  1. Kirjaudu sisään chatreact.ai
  2. Siirry kohtaan Lomakkeet
  3. Klikkaa Kopioi upotuskoodi lomakkeessasi (tai avaa lomake ja vaihda Upota-välilehdelle)
  4. Lomakkeen ID on kopioidun upotuskoodin data-form-id-arvo

Käyttövaihtoehdot

Laajennus tarjoaa useita tapoja lisätä ChatReact sivustollesi:

1. Shortcodet

Lisää mihin tahansa sivulle, artikkeliin tai widget-alueelle:

Chat-widget:

[chatreact id="YOUR_CHATBOT_ID"]

Valinnaiset attribuutit: language

Yhteydenottolomake:

[chatreact_form id="YOUR_FORM_ID"]

Valinnaiset attribuutit: language

FAQ-accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Valinnaiset attribuutit: categories, container, language

Visuaaliset asetukset kuten sijainti, värit ja automaattinen avaus hallinnoidaan keskitetysti ChatReact-hallintapaneelissa ja soveltuvat automaattisesti WordPress-sivustoosi. language-attribuutti on valinnainen kaikissa shortkodeissa — jos jätät sen pois, nykyisen sivun kieli tunnistetaan automaattisesti (toimii monikielisillä sivustoilla).

2. Gutenberg-lohkot

Lohkoeditorissa:

  1. Klikkaa + lisätäksesi lohkon
  2. Etsi "ChatReact"
  3. Valitse ChatReact Chat, ChatReact Form tai ChatReact FAQ
  4. Syötä tunnuksesi lohkon asetuksiin

3. Elementor

Jos käytät Elementoria:

  1. Muokkaa sivuasi Elementorin avulla
  2. Etsi "ChatReact" widgeteistä
  3. Vedä widget sivullesi
  4. Määritä asetukset vasemmassa paneelissa

4. Widgetin kohdistukset (laajennuksen asetukset)

Näytä chatbot tietyillä sivuilla — tai koko sivustolla — ilman sisällön muokkaamista:

  1. Avaa ChatReact-valikko hallinnan sivupalkissa
  2. Chat Widget -välilehdellä etsi Widget Assignments
  3. Klikkaa Add Assignment, valitse sivu tai artikkeli (tai valitse Everywhere) ja syötä Chatbot ID
  4. Klikkaa Tallenna muutokset

For Everywhere -kohdistuksissa voit sulkea pois tietyt URL-osoitteet — yksi per rivi, villikorttituen kanssa (esim. /blog/* tai /checkout) — piilottaaksesi widgetin laskeutumissivuilta tai kassaprosessin aikana.

Oletuksena haettavina on vain Pages. Klikkaa Post Types -painiketta tehdäkseksi muut sisältötyypit (esim. Posts tai mukautetut sisältötyypit) haettaviksi myös.

5. Sivukohtainen kohdistus

Kohdista chatbot yhdelle sivulle suoraan editorista:

  1. Muokkaa mitä tahansa sivua tai artikkelia
  2. Etsi "ChatReact Widget" -meta-laatikko
  3. Rastita Enable custom widget for this page
  4. Syötä Chatbot ID ja valinnaisesti valitse sijainti (Default, Bottom Right, Bottom Left)
  5. Tallenna sivu

Sama meta-laatikko tarjoaa myös Disable all widgets on this page -vaihtoehdon, jos haluat piilottaa ChatReactin kokonaan tietyillä sivuilla.

Shortcode-esimerkit

Perus chat-widget

[chatreact id="abc123"]

Chat-widget kiinteällä kielellä

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

FAQ kategoriasuodattimella

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

Muotoiltu yhteydenottolomake

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

FAQ-widget: SEO & välimuisti

Hakukoneystävälliset FAQ:t

Versiosta 1.1.2 lähtien FAQ-widgetit renderöidään palvelinpuolella: FAQ:t ovat osa sivun HTML:ää ja sisältävät JSON-LD rakenteisen datan (FAQPage-skeema). Hakukoneet ja AI-avustajat voivat lukea niitä ilman JavaScriptiä.

llms.txt AI-indeksoijille

Laajennus voi tarjota FAQ-sisältösi osoitteessa yoursite.com/llms.txt, löydöstiedosto jota AI-indeksoijat lukevat. Se on oletuksena käytössä. Kytke se päälle/pois tai määritä tietty Chatbot ID kohdassa ChatReact → FAQ Widget → Cache & SEO Settings.

FAQ-välimuisti

FAQ-data välimuistitetaan palvelimellasi nopeiden sivulatausten takaamiseksi. Kohdassa ChatReact → FAQ Widget → Cache & SEO Settings voit:

  • Asettaa Cache Duration — 1, 3, 6 (suositus), 12 tai 24 tuntia, tai poistaa välimuistin käytöstä
  • Klikata Clear Cache päivittääksesi FAQ:t välittömästi

Välimuisti tyhjennetään myös automaattisesti aina kun FAQ:t muuttuvat ChatReact-hallintapaneelissa.

Tuetut kielet

Laajennus tukee 24 EU-kieltä:

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

Versiosta 1.2.0 lähtien kaikkien 24 kielen käännökset sisältyvät laajennukseen. Widgetin kieli tunnistetaan automaattisesti nykyisestä sivusta, joten monikieliset sivustot toimivat suoraan — käytä language-shortcode-attribuuttia vain jos haluat pakottaa tietyn kielen.

Vianmääritys

Widget ei näy

  1. Varmista, että Chatbot ID on oikein
  2. Tarkista, että chatbot on aktiivinen ChatReact-hallintapaneelissasi
  3. Tyhjennä mahdolliset sivuvälimuistilaajennukset (katso alla)
  4. Tarkista selaimen konsoli JavaScript-virheiden varalta

Välimuistilaajennusten yhteensopivuus

Laajennus on täysin yhteensopiva suosittujen välimuisti- ja optimointilaajennusten kanssa, mukaan lukien WP Rocket, LiteSpeed Cache, Autoptimize ja WP Super Cache. Laajennus estää automaattisesti näitä työkaluja minifioimasta tai välimuistittamasta ChatReact-skriptejä.

Jos kohtaat edelleen ongelmia (esim. 404-virheitä, widget ei lataudu uloskirjautuneille kävijöille):

  1. Tyhjennä välimuistilaajennuksesi välimuisti
  2. Sulje chatreact pois JS-minifioinnista/yhdistämisestä välimuistilaajennuksen asetuksissa
  3. Laajennus käyttää data-api-url-attribuutteja varmistuksena oikealle API-yhteydelle

FAQ:t eivät päivity

Jos sivustollasi näkyy vanhentuneita FAQ:ita, siirry kohtaan ChatReact → FAQ Widget ja klikkaa Clear Cache. Välimuisti tyhjentyy myös automaattisesti kun muokkaat FAQ:ita ChatReact-hallintapaneelissa.

Muotoiluongelmat

Jos widget näyttää rikki:

  • Widget käyttää eristettyä CSS:ää
  • Tarkista teemastasi löytyvät CSS !important-säännöt
  • Kokeile tilapäisesti poistaa muut chat-laajennukset käytöstä

Useita widgettejä

Voit käyttää eri chatbotteja eri sivuilla määrittämällä yksilölliset ID:t kuhunkin shortcodeen tai lohkoon.

CMS-integraatio (Smart Sitemap)

Versiosta 1.1.0 lähtien ChatReact WordPress -laajennus sisältää Smart Sitemap -ominaisuuden, joka tarjoaa ChatReact-kraulerille rakenteellista sisältömetatietoa suoraan WordPress-sivustoltasi.

Miten se toimii

  1. Generate an Integration Key ChatReact-hallintapaneelissa (Knowledge Base → Websites → CMS Integrations)
  2. Paste the key WordPress-laajennuksen asetuksiin Integration-välilehdelle
  3. Select content types joita haluat jakaa (Pages, Posts, Custom Post Types)
  4. Set priorities (High/Medium/Low) per sisältötyyppi
  5. Kun indeksoitte sivustoasi, ChatReact käyttää automaattisesti smart sitemapia linkkipohjaisen löydön sijaan

Hyödyt

  • Nopeampi indeksointi – Suora URL-lista linkkikierroksen sijaan
  • Sisältötyyppitietoisuus – Krauleri tietää, onko URL Page, Post vai Custom Post Type
  • Priorisointi – Tärkeä sisältö (esim. Pages) voidaan painottaa enemmän kuin blogikirjoitukset
  • Valikoiva jakaminen – Jaa vain haluamasi sisältötyypit
  • Yksittäisten postausten poissulkeminen – Estä yksittäiset postaukset/sivut sitemapista meta-laatikon avulla

Prioriteettitasot

PriorityDefault forDescription
HighPagesCore business content (About, Services, Contact)
MediumPostsBlog articles, news updates
Low–Supplementary content

Tietoturva

Smart sitemap -päätepiste (/wp-json/chatreact/v1/sitemap) on suojattu Integration Keyllä. Se ei ole näkyvissä hakukoneille tai muille indeksoijille — vain ChatReact pääsee siihen oikealla avaimella.

Jos tietoturvalaajennus rajoittaa WordPress REST API:n kirjautuneille käyttäjille, versiot 1.2.1 ja uudemmat päästävät ChatReact-pyynnöt, joilla on voimassa oleva Integration Key, läpi /wp-json/chatreact/v1/ — kaikki muut REST-reitit pysyvät estettyinä. Jos palomuuri estää päätepisteen ennen kuin WordPress latautuu, salli /wp-json/chatreact/v1/ siellä. Aina kun smart sitemap ei ole saavutettavissa, skannauksen esikatselussa ChatReact-hallintapaneelissa näytetään syy ja käytetään varakarttana julkista sitemapia, joka sivuuttaa sisältötyyppivalintasi.

Yksittäisten postausten poissulkeminen

WordPress-editorissa jokaisella postauksella/sivulla on ChatReact Widget -meta-laatikko, jossa on vaihtoehto "Exclude from ChatReact Sitemap". Valitut postaukset eivät näy smart sitemapissa.

Vaatimukset

  • WordPress 5.8 tai uudempi
  • PHP 7.4 tai uudempi
  • ChatReact-tili (sign up free)

Muutokset (Changelog)

1.2.1

  • FIX: Smart sitemap saavutettavissa jälleen sivustoilla, jotka rajoittavat REST API:n kirjautuneille käyttäjille — pyynnöt, joilla on voimassa oleva Integration Key, päästetään läpi, joten valitut sisältötyypit huomioidaan skannauksen aikana

1.2.0

  • NEW: Käännökset kaikille 24 viralliselle EU-kielelle sisällytetty laajennukseen

1.1.3

  • FIX: Yksittäiskategorian FAQ-widgetit eivät enää näytä tarpeetonta "All"-suodatinpainiketta ja kategoriamerkintöjä

1.1.2

  • NEW: Palvelinpuolen renderöinti FAQ-widgeille — FAQ:t näkyvät hakukoneille ja LLM:ille ilman JavaScriptiä
  • NEW: JSON-LD rakenteellinen data (FAQPage-skeema) parannettua SEO:ta ja rich-tuloksia varten
  • NEW: llms.txt-päätepiste AI-kraulerien löydettävyyteen
  • NEW: Automaattinen FAQ-välimuistin tyhjennys kun sisältö muuttuu ChatReact-hallintapaneelissa

1.1.1

  • FIX: Käännösparannuksia (Romanian, Dutch)

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — rakenteellinen sisällönjako ChatReact-kraulerille
  • NEW: Integration-välilehti laajennuksen asetuksiin
  • NEW: Sisältötyyppivalinta prioriteettitasoilla
  • NEW: Yksittäisten postausten poissulkeminen sitemapista meta-laatikon kautta
  • NEW: Suojattu REST API -päätepiste smart sitemapille
  • FIX: Täysi yhteensopivuus välimuistilaajennusten (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache) kanssa
  • FIX: Widgetin latausongelmat uloskirjautuneille kävijöille välimuistilaajennusten kanssa

1.0.24

  • Widget Assignments — kohdista chatbotteja sivuille suoraan laajennuksen asetuksista
  • Gutenberg-lohkotuki
  • Elementor-integraatio
  • 24 kielen käännöksiä
  • Sivukohtainen widget-kohdistus
  • CHANGED: Widget-asetukset hallinnoidaan nyt keskitetysti ChatReact-hallintapaneelissa — poistettu position, primary_color ja auto_open shortcode-attribuutit (language on edelleen tuettu)

Seuraavat askeleet