EtusivuDokumentaatio

WordPress-laajennus

Lisää ChatReact AI -chatbotteja, yhteydenottolomakkeita ja UKK-accordioneja WordPress-sivustollesi virallisella laajennuksellamme.

Lataa

Laajennus on saatavilla virallisessa WordPress Plugin Directory-hakemistossa tai suoran latauksen kautta:

Lataa ChatReact Plugin v1.2.0

Asennus

Menetelmä 1: WordPress Plugin Directory (suositeltu)

  1. Siirry WordPress-hallinnassa kohtaan Plugins → Add New
  2. Etsi ChatReact
  3. Klikkaa Install Now, sitten Activate

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:llä

  1. Pura ZIP-tiedosto
  2. Lataa chatreact-kansio hakemistoon /wp-content/plugins/
  3. Siirry WordPress-hallinnassa kohtaan Plugins
  4. Etsi "ChatReact" ja klikkaa Activate

Määritys

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

Chatbotin tunnuksen löytäminen

  1. Kirjaudu sisään osoitteeseen chatreact.ai
  2. Siirry chatbotisi Dashboard-sivulle
  3. Klikkaa Chatbot ID:n vieressä olevaa Copy-painiketta (näkyy yläreunassa)

Lomakkeen tunnuksen löytäminen

  1. Kirjaudu sisään osoitteeseen chatreact.ai
  2. Siirry kohtaan Forms
  3. Klikkaa lomakkeellasi Copy embed code (tai avaa lomake ja vaihda Embed-välilehdelle)
  4. Lomakkeen Form ID on kopioidussa embed-koodissa data-form-id-arvon 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

UKK-accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Valinnaiset attribuutit: categories, container, language

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

2. Gutenberg-lohkot

Lohkotoimittajassa:

  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ätte Elementoria:

  1. Muokkaa sivua Elementorilla
  2. Etsi widgeteistä "ChatReact"
  3. Vedä widget sivullesi
  4. Määritä asetukset vasemmassa paneelissa

4. Widget-määritykset (laajennuksen asetukset)

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

  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 anna Chatbot ID
  4. Klikkaa Save Changes

Everywhere-määrityksille voit poistaa käytöstä tiettyjä URL-osoitteita — yksi per rivi, wildcard-tuki (esim. /blog/* tai /checkout) — piilottaaksesi widgetin landing-sivuilta tai kassasivun aikana.

Oletuksena vain Pages ovat haettavissa määritystä tehtäessä. Klikkaa Post Types -painiketta tehdäksesi muut sisältötyypit (esim. Posts tai mukautetut post-tyypit) haettaviksi myös.

5. Sivutasoinen määritys

Määritä chatbot yksittäiselle 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 vaihtoehdon Disable all widgets on this page, 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"]

UKK kategoriasuodattimella

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

Tyylitelty yhteydenottolomake

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

UKK-widget: SEO & välimuisti

Hakukoneystävälliset UKK:t

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

llms.txt AI-crawlereille

Laajennus voi tarjota UKK-sisältönne osoitteessa yoursite.com/llms.txt, löytötiedosto jota AI-crawlers lukevat. Se on oletuksena käytössä. Vaihtaaksenne sitä tai asettaaksenne tietyn Chatbot ID:n tiedostolle, siirtykää kohtaan ChatReact → FAQ Widget → Cache & SEO Settings.

UKK-välimuisti

UKK-dataa välimuistitetaan palvelimellanne nopeiden sivulatausten varmistamiseksi. Kohdassa ChatReact → FAQ Widget → Cache & SEO Settings voitte:

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

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

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 käännökset kaikille 24 kielelle 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. Varmistakaa, että Chatbot ID on oikein
  2. Tarkistakaa, onko chatbot aktiivinen ChatReact-dashboardissanne
  3. Tyhjentäkää mahdolliset sivun välimuistilaajennukset (katso alla)
  4. Tarkistakaa selaimen konsoli mahdollisten JavaScript-virheiden varalta

Välimuistilaajennusten yhteensopivuus

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

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

  1. Tyhjentäkää välimuistilaajennuksen välimuisti
  2. Sulkekaa chatreact pois JS-minifikaatiosta / yhdistämisestä välimuistilaajennuksen asetuksissa
  3. Laajennus käyttää data-api-url-attribuutteja varajärjestelmänä varmistaakseen oikean API-yhteyden

UKK:t eivät päivity

Jos sivustollanne näkyy vanhentuneita UKK:ita, siirtykää kohtaan ChatReact → FAQ Widget ja klikatkaa Clear Cache. Välimuisti tyhjennetään myös automaattisesti kun muokkaatte UKK:ita ChatReact-dashboardissa.

Tyylikonfliktit

Jos widget näyttää rikkoutuneelta:

  • Widget käyttää eristettyä CSS:ää
  • Tarkistakaa teeman CSS:stä !important-säännöt
  • Kokeilkaa ottaa muut chat-laajennukset väliaikaisesti pois käytöstä

Useita widgettejä

Voitte 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 -toiminnon, joka tarjoaa ChatReact-crawlerille strukturoitua sisältömetatietoa suoraan WordPress-sivustoltanne.

Miten se toimii

  1. Generoi Integration Key ChatReact-dashboardissa (Knowledge Base → Websites → CMS Integrations)
  2. Liitä avain WordPress-laajennuksen asetuksiin Integration-välilehdelle
  3. Valitse sisältötyypit, joita haluat jakaa (Pages, Posts, Custom Post Types)
  4. Aseta prioriteetit (High/Medium/Low) per sisältötyyppi
  5. Kun crawlataan sivustoanne, ChatReact käyttää automaattisesti smart sitemapia sen sijaan, että etsisi linkeittäin

Hyödyt

  • Nopeampi indeksointi – Suora URL-lista linkkipohjaisen löydön sijaan
  • Sisältötyyppitietoisuus – Crawler tietää, onko URL Page, Post vai Custom Post Type
  • Prioriteettipohjainen indeksointi – Tärkeälle sisällölle (esim. Pages) voidaan antaa suurempi painoarvo kuin blogikirjoituksille
  • Valikoiva jakaminen – Jaa vain haluamasi sisältötyypit
  • Post-kohtainen poissulkeminen – Poissulje yksittäiset postaukset/sivut sitemapista meta-laatikon kautta

Prioriteettitasot

PriorityDefault forDescription
HighPagesYrityksen ydinsisältö (About, Services, Contact)
MediumPostsBlogikirjoitukset, uutispäivitykset
LowLisäsisältö

Turvallisuus

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

Yksittäisten postausten poissulkeminen

WordPress-editorissa jokaisella postauksella/sivulla on ChatReact Widget -meta-laatikko, jossa on vaihtoehto "Exclude from ChatReact Sitemap". Rastitut postaukset eivät tule smart sitemapin listalle.

Vaatimukset

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

Changelog

1.2.0

  • NEW: Mukana käännökset kaikille 24 viralliselle EU-kielelle

1.1.3

  • FIX: Yksikategoriset UKK-widgetit eivät enää näytä tarpeetonta "All"-suodatinpainiketta ja kategoriateippejä

1.1.2

  • NEW: Server-side rendering UKK-widgeille — UKK:t ovat näkyvissä hakukoneille ja LLM:ille ilman JavaScriptiä
  • NEW: JSON-LD -rakenteinen data (FAQPage-skeema) parantamaan SEO:ta ja rikastettuja tuloksia
  • NEW: llms.txt-päätepiste AI-crawlerien löydettävyyteen
  • NEW: Automaattinen UKK-välimuistin tyhjennys kun sisältö muuttuu ChatReact-dashboardissa

1.1.1

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

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — strukturoitu sisällön jakaminen ChatReact-crawlerille
  • NEW: Integration-välilehti laajennuksen asetuksiin
  • NEW: Sisältötyyppivalinta prioriteettitasoilla
  • NEW: Post-kohtainen poissulkeminen sitemapista meta-laatikon kautta
  • NEW: Suojattu REST API -päätepiste smart sitemapille
  • FIX: Täysi yhteensopivuus välimuistilaajennusten kanssa (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
  • FIX: Widgetin latausongelmat uloskirjautuneille vierailijoille välimuistilaajennusten kanssa

1.0.24

  • Widget Assignments — määritä chatbotteja sivuille suoraan laajennuksen asetuksista
  • Gutenberg-lohkojen tuki
  • Elementor-integraatio
  • 24 kielikäännöstä
  • Sivutason widget-määritys
  • CHANGED: Widget-asetukset hallitaan nyt keskitetysti ChatReact-dashboardissa — poistettiin position, primary_color ja auto_open -shortcode-attribuutit (language on edelleen tuettu)

Seuraavat vaiheet