Opis

ZenQori Assistant Free dodaje widżet czatu, który odpowiada na pytania odwiedzających wyłącznie na podstawie Twoich treści: produktów WooCommerce (w tym wariantów i opinii), stron, wpisów oraz własnych wpisów Q&A. Wszystko działa wewnątrz WordPressa – bez zewnętrznego serwera automatyzacji i bez osobnego konta poza kluczem API OpenAI.

Dwa typy witryn w jednej wtyczce: sklep internetowy (WooCommerce) albo blog / strona / baza wiedzy. Tryb automatyczny wybiera typ sklepu, gdy WooCommerce jest aktywny.

Funkcje:

Widżet czatu z odpowiedziami w trybie strumieniowym, przyciskami szybkich pytań, własnym tytułem, wiadomością powitalną, kolorem, położeniem i ikoną.
Wbudowany potok RAG: pamięć rozmowy, przepisywanie zapytań i wykrywanie intencji, dokładne wyszukiwanie po SKU, próg podobieństwa, rerankowanie wyników przez LLM, porównywanie produktów i rekomendacje.
Baza wiedzy znajduje się w bazie danych Twojego WordPressa – nie trzeba nic więcej konfigurować.
Automatyczne indeksowanie produktów WooCommerce, wariantów, opinii, stron, wpisów i własnych wpisów Q&A (dodaj własne odpowiedzi, na przykład regulamin, jako wpisy „Baza wiedzy”). Natychmiastowe aktualizacje w tle, cogodzinne uzgadnianie, pełna reindeksacja z panelu lub WP-CLI (wp zqpro reindex).
Tryb bloga: artykuły są dzielone według nagłówków, odpowiedzi wskazują właściwe artykuły, a pod odpowiedziami pokazywane są karty artykułów (tytuł, zajawka, miniatura). Nieopublikowane wpisy i wpisy chronione hasłem nie są nigdy używane.
Podstawowa analityka: rozmowy, wiadomości, rozmowy dziennie i najczęstsze pytania.
Ochrona przed nadużyciami i kosztami: limit na odwiedzającego, zabezpieczenie na adres IP, dzienny limit wiadomości, dzienny budżet tokenów AI, limit długości wiadomości.
Klucz OpenAI można przechowywać w wp-config.php (ZQPRO_OPENAI_KEY).

ZenQori Assistant Pro

Wersja Pro dodaje Claude i innych dostawców AI, indeks wektorowy Pinecone, wiedzę z plików PDF/DOCX/TXT, zbieranie kontaktów (formularz, e-mail, webhook), status zamówienia i przyciski dodawania do koszyka dla WooCommerce, oceny odpowiedzi, pełną analitykę (pytania bez odpowiedzi, najczęściej używane źródła), obsługę wielu języków (Polylang, WPML) oraz noindex. Ustawienia i dane zostają po przejściu między wersjami.

Wymagania

Klucz API OpenAI (odpowiedzi i osadzenia do wyszukiwania są tworzone przez OpenAI).
PHP 7.4 lub nowszy. WooCommerce jest opcjonalny.

Usługi zewnętrzne

Ta wtyczka wysyła dane do usług zewnętrznych:

OpenAI (https://openai.com) – wiadomość odwiedzającego, ostatnie wypowiedzi rozmowy i odpowiednie fragmenty bazy wiedzy są wysyłane w celu wygenerowania odpowiedzi; treść Twoich produktów, stron i wpisów jest wysyłana w celu utworzenia osadzeń (embeddings). Polityka prywatności: https://openai.com/policies/privacy-policy/ Warunki: https://openai.com/policies/terms-of-use/
Freemius (https://freemius.com) – usługa licencjonowania i aktualizacji. Nic nie jest wysyłane, dopóki nie wyrazisz zgody na ekranie aktywacji; jeśli to zrobisz, wysyłany jest adres witryny, wersje WordPressa, PHP i wtyczki oraz Twój e-mail i imię administratora, aby można było aktualizować i wspierać wtyczkę. Możesz pominąć zgodę, a wtyczka działa tak samo. Polityka prywatności: https://freemius.com/privacy/ Warunki: https://freemius.com/terms/
Opcjonalna zmiana adresu – domyślnie każde zapytanie trafia na https://api.openai.com/v1. Deweloper może wskazać inny adres (na przykład proxy) filtrem zqpro_openai_base_url; wtedy dane wymienione powyżej są wysyłane na ten adres, wybrany przez właściciela witryny. Wersja Pro, będąca osobnym pakietem, może łączyć się z innymi dostawcami AI i Pinecone; kod połączeń z tymi usługami nie jest częścią tej wtyczki Free, która nigdy się z nimi nie łączy.

Rozmowy są przechowywane w bazie danych Twojego WordPressa przez okres retencji ustawiony w ustawieniach wtyczki (domyślnie 30 dni). Losowy identyfikator sesji jest zapisywany w pamięci lokalnej przeglądarki odwiedzającego.

ZenQori nie otrzymuje żadnych wiadomości z czatu ani nie przechowuje treści. Właściciel witryny odpowiada za poinformowanie odwiedzających (polityka prywatności) oraz za wybór podstawy prawnej.

Ta wtyczka jest niezależną integracją i nie jest powiązana z OpenAI.

Dołączone biblioteki

Freemius SDK (https://github.com/Freemius/wordpress-sdk), GPLv3, w vendor/freemius/ – licencjonowanie i aktualizacje.

Instalacja

Wgraj folder wtyczki do /wp-content/plugins/ lub zainstaluj plik ZIP przez Wtyczki > Dodaj nową > Wyślij wtyczkę na serwer.
Aktywuj „ZenQori Content Assistant”.
Otwórz ZenQori Assistant > Ustawienia, wpisz swój klucz OpenAI i zapisz.
Otwórz ZenQori Assistant > Indeksowanie i uruchom „Start full re-index” (lub wp zqpro reindex).
Wróć do Ustawień i włącz chatbota.

Recenzje

Wtyczka nie ma jeszcze żadnej recenzji.

Kontrybutorzy i deweloperzy

„ZenQori Content Assistant” jest oprogramowaniem open source. Poniższe osoby miały wkład w rozwój wtyczki.

ZenQori

Wtyczka „ZenQori Content Assistant” została przetłumaczona na 1 język. Podziękuj tłumaczom za ich wkład.

Przetłumacz wtyczkę “ZenQori Content Assistant” na swój język.

Interesuje cię rozwój wtyczki?

Przeglądaj kod, sprawdź repozytorium SVN lub czytaj dziennik rozwoju przez RSS.

Rejestr zmian

3.16.3

Naprawiono: wiersz pola wpisywania w czacie mógł być ucięty u dołu widżetu w motywach, które globalnie zmieniają style pól tekstowych i przycisków.

3.16.2

Zmieniono: nazwa wtyczki nie zawiera już słowa „Free”.
Naprawiono: style panelu administracyjnego są ładowane przez wp_enqueue_style zamiast znaczników style w treści; kod ikony przycisku czatu jest oczyszczany przez wp_kses; dodatkowe atrybuty pól ustawień są escapowane.
Zmieniono: readme opisuje każdą usługę zewnętrzną, w tym opcjonalny filtr adresu.

3.16.1

Zmieniono: pliki językowe nie są już dołączane; tłumaczenia dostarcza translate.wordpress.org. Interfejs jest w pełni tłumaczalny (text domain zenqori-assistant).

3.15.3

Dodano (pakiet Pro): funkcje Pro wymagają ważnej licencji. Bez niej wtyczka działa jak wersja darmowa i zachowuje Twoje ustawienia Pro; wracają one, gdy tylko licencja zostanie aktywowana. Wygasła licencja nie wyłącza funkcji (przestają działać tylko aktualizacje i wsparcie).

3.15.2

Zmieniono: nazwa w nagłówku pakietu Pro to „ZenQori Assistant – AI Chatbot for Support & Sales”, a Freemius dodaje przyrostek „(Pro)” (bez podwójnego „Pro” na liście wtyczek).

3.15.1

Zmieniono: czyszczenie danych przy odinstalowaniu działa teraz przez hak Freemius after_uninstall (bez pliku uninstall.php). Usuwane są te same dane co wcześniej.

3.15.0

Dodano: licencjonowanie i aktualizacje Freemius (Pro: aktywacja licencji i automatyczne aktualizacje przez rok; Free: opcjonalna zgoda i strona uaktualnienia). Wtyczka działa tak samo bez zgody.
Zmieniono: funkcje Pro działają dalej po wygaśnięciu licencji; przestają działać tylko aktualizacje i wsparcie.

3.14.3

Naprawiono: ostrzeżenia Plugin Check dotyczące nazw haków rdzenia WooCommerce w kodzie ilości dodawanej do koszyka (Pro).

3.14.2

Naprawiono: ostrzeżenie Plugin Check dotyczące load_plugin_textdomain() w pakiecie WordPress.org (Free) – WordPress sam ładuje tam tłumaczenia.

3.14.1

Zmieniono: ostateczne nazwy produktów – „ZenQori Assistant – AI Chatbot for Support and Sales” i „ZenQori Assistant Pro – AI Chatbot for Support & Sales”; folder/slug zenqori-assistant. Ustawienia i dane bez zmian.

3.14.0

Zmieniono: wersje nazywają się teraz Free i Pro (wcześniej PRO i PRO Plus). Ustawienia i dane bez zmian.
Naprawiono: czytelny (nieminifikowany) arkusz stylów widżetu, komentarz dla tłumaczy.

3.13.5

Język odpowiedzi: pytanie po polsku zawsze otrzymuje odpowiedź po polsku, nawet gdy zawiera angielskie nazwy produktów lub kody.

3.13.4

Ustawienia: przycisk testu nazywa się teraz po prostu „Test connections” i zawiera informację, że sprawdza tylko zapisane ustawienia.

3.13.3

Ustawienia: pola liczbowe (limity, budżety) to zwykłe pola tekstowe, w które można wpisywać; koniec z małymi polami ze strzałkami.

3.13.2

Ustawienia: zaznacz „Remove the saved key” obok klucza API, aby go usunąć (np. po zmianie dostawcy).

3.13.1

Test połączenia opisuje problemy z dostawcą prostym językiem (model niedostępny, klucz odrzucony, brak środków, limit zapytań) jako ostrzeżenie zamiast surowego błędu.
Ustawienie Google Gemini: szybki model to teraz gemini-3.5-flash-lite (2.5 lite jest zamknięty dla nowych kont).

3.13.0

Gdy asystent nie może odpowiedzieć (błąd dostawcy, wyczerpany limit lub budżet, sieć), czat pokazuje krótkie przeprosiny i formularz kontaktowy zamiast błędu bez wyjścia (tylko gdy zbieranie kontaktów jest włączone; działa bez klucza API).

3.12.3

Karty produktów: produkty w promocji pokazują tylko aktualną cenę (bez ukrytego tekstu „cena pierwotna”).
Gdy limit wiadomości zostanie osiągnięty, czat pokazuje komunikat z serwera zamiast ogólnego błędu.
Listy numerowane zachowują numery; słowa o dostępności są tłumaczone na język klienta; język pytania jest wykrywany wyłącznie na podstawie bieżącego pytania; ogólne „co polecasz” pozostaje ogólne.

3.12.2

Asystent zawsze odpowiada teraz w języku pytania klienta (język pytania jest wykrywany i wprost przekazywany modelowi), nawet gdy dane produktów są w innym języku.

3.12.1

Karty produktów z „Dodaj do koszyka” pojawiają się teraz tylko wtedy, gdy klient chce kupić (ustawienie: Pokazuj karty – tylko przy zakupie / zawsze).
Naprawiono: okno czatu było ucięte u dołu (ukryte pole wpisywania), gdy wyświetlany był pasek Kontakt / Status zamówienia.

3.12.0

Przyciski Kontakt / Status zamówienia znajdują się teraz we własnym wierszu paska narzędzi pod nagłówkiem.
Rozmowa jest zachowywana, gdy odwiedzający przechodzi na inną stronę (osobno dla każdej karty przeglądarki).
Produkty dostępne na zamówienie (backorder) są indeksowane i pokazywane jako „na zamówienie”, a nie jako dostępne w magazynie. Po aktualizacji zaindeksuj produkty ponownie.
Lepsze odpowiedzi na ogólne prośby, takie jak „polecisz produkt”; asystent nie wspomina już o swojej „bazie wiedzy”.
Dodano polskie tłumaczenie (pl_PL) interfejsu czatu.

3.11.1

Naprawiono: otwarcie jednego formularza w czacie zamyka drugi.

3.11.0

Zmieniono nazwę na „ZenQori AI Chatbot PRO” (rozszerzona wersja to „PRO Plus”).

3.10.0

Pierwsze wydanie (wspólna baza kodu i ustawienia z wersją PRO Plus).