# Zweryfikowane opinie WooCommerce: dokumentacja
> DataFirefly Reviews (dfreviews) zamienia natywny system opinii WooCommerce w maszynę do budowania dowodu społecznego: automatyczne prośby o opinię po zakupie, odznaka Zakup zweryfikowany, zdjęcia klientów, głosy przydatności, podsumowanie AI opinii…
- Strona:
- Język: pl
- Zaktualizowano: 2026-07-29
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfreviews/index.md), [en](https://www.datafirefly.com/en/documentation/dfreviews/index.md), [es](https://www.datafirefly.com/es/documentation/dfreviews/index.md), [de](https://www.datafirefly.com/de/documentation/dfreviews/index.md), [it](https://www.datafirefly.com/it/documentation/dfreviews/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfreviews/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfreviews/index.md)
- Indeks:
DataFirefly Reviews (dfreviews) zamienia natywny system opinii WooCommerce w maszynę do budowania dowodu społecznego: automatyczne prośby o opinię po zakupie, odznaka Zakup zweryfikowany, zdjęcia klientów, głosy przydatności, podsumowanie AI opinii na karcie produktu, automatyczna odpowiedź AI na opinie, kod rabatowy w nagrodę i rich snippety Schema.org. Ta dokumentacja obejmuje instalację, pełną konfigurację i rozwiązywanie problemów.
## Instalacja
1. W panelu administracyjnym WordPressa otwórz **Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer**.
2. Wybierz plik `dfreviews-1.0.0.zip`, kliknij **Zainstaluj teraz**, a następnie **Włącz**.
3. Pojawi się nowe podmenu **WooCommerce → DF Reviews**: to centrum sterowania wtyczką.
Wtyczka opiera się na natywnych opiniach WooCommerce: Twoje dotychczasowe opinie zostają zachowane i są od razu wykorzystywane. Migracja nie jest potrzebna.
Wymagania: WooCommerce 8 lub 9, WordPress 6.0+, PHP 8.0 do 8.3. Wtyczka jest zgodna z HPOS (High-Performance Order Storage) i działa bez jQuery oraz bez Composera.
## Konfiguracja klucza OpenAI
Podsumowanie AI i automatyczne odpowiedzi korzystają z Twojego własnego klucza API OpenAI:
1. Utwórz klucz na [platform.openai.com](https://platform.openai.com/api-keys).
2. Wklej go w **WooCommerce → DF Reviews → Settings**, sekcja **OpenAI**.
3. Domyślny model to `gpt-4o-mini`: najbardziej ekonomiczny, zalecany. Podsumowanie albo odpowiedź kosztuje zwykle znacznie mniej niż grosz.
Bez klucza OpenAI wszystkie pozostałe funkcje (prośby o opinię, zdjęcia, głosy, kupony, rich snippety) pozostają w pełni sprawne. Zakładka **AI tools** pokazuje stan konfiguracji AI.
## Automatyczne prośby o opinię
Sekcja **Review requests** w ustawieniach:
- **Status wyzwalający**: prośba trafia do kolejki, gdy zamówienie osiąga ten status (domyślnie _Zamówienie zrealizowane_).
- **Opóźnienie wysyłki**: liczba dni oczekiwania po osiągnięciu statusu wyzwalającego (domyślnie: 3 dni).
- **Przypomnienie**: jeden e-mail przypominający wychodzi, jeśli opinia nie została wystawiona (domyślnie: 5 dni po pierwszym e-mailu).
Każdy e-mail zawiera osobisty link do opinii z tokenem: opinia wystawiona przez ten link automatycznie otrzymuje odznakę **Zakup zweryfikowany**. Wysyłka odbywa się partiami po 50 przy każdym przebiegu crona. Zakładka **Request queue** pokazuje 100 ostatnich próśb z ich statusem (pending, sent, reminded, completed, failed, unsubscribed) i pozwala uruchomić przetwarzanie ręcznie.
Każdy e-mail zawiera link do rezygnacji. Adresy wypisane są przechowywane w postaci skrótu SHA-256 i nigdy więcej nie otrzymują prośby.
## Podsumowanie AI opinii
Gdy produkt osiągnie minimalną liczbę opublikowanych opinii (domyślnie: 3), cron generuje blok wyświetlany na początku zakładki opinii na karcie produktu: **mocne strony**, **punkty uwagi** i **synteza**.
- Podsumowanie jest cache'owane per produkt **i per język**: z Polylang albo WPML każda wersja językowa wyświetla podsumowanie we własnym języku.
- Jest regenerowane automatycznie po opublikowaniu nowych opinii (unieważnienie na podstawie odcisku analizowanych opinii).
- Ustawienie **Max reviews analyzed** ogranicza liczbę opinii wysyłanych do modelu.
Zakładka **AI tools** pokazuje wygenerowane podsumowania z językiem i datą.
## Automatyczna odpowiedź AI na opinie
Każda opublikowana opinia może otrzymać odpowiedź sklepu wygenerowaną przez AI, napisaną **w języku opinii**. Kluczowe ustawienia:
- **Tryb publikacji**: _Szkic_ (zalecany na start, każda odpowiedź czeka na Twoje zatwierdzenie w menu Komentarze) albo _Publikacja natychmiastowa_.
- **Ton**: ciepły, profesjonalny lub zwięzły.
- **Nazwa w podpisie**: wyświetlana jako autor odpowiedzi (puste pole = nazwa witryny).
- **Odpowiadaj na oceny od**: 1, aby odpowiadać na wszystkie opinie. To zalecane, bo to właśnie opinie negatywne najbardziej zyskują na odpowiedzi.
Wbudowane zabezpieczenia: przy ocenach 3/5 i niższych odpowiedź zawiera przeprosiny i kieruje do wsparcia, nigdy nie obiecując zwrotu pieniędzy. Odpowiedź jest ograniczona do około 70 słów i wyświetla się z odznaką **Oficjalna odpowiedź**, wyłączona ze średnich ocen i z rich snippetów.
Dla opinii istniejących lub zaimportowanych: akcja **Generate AI reply** na liście komentarzy WordPressa albo zbiorcze przetwarzanie zaległości przez cron.
## Zdjęcia, głosy i kod rabatowy w nagrodę
- **Zdjęcia klientów**: klienci dołączają do opinii maksymalnie 3 zdjęcia (konfigurowalne, do 10), formaty jpg, png, webp, gif, maks. 5 MB, wyświetlanie w lightboxie.
- **Głosy przydatności**: przyciski „Czy ta opinia była przydatna?" z ochroną przed duplikatami per konto i per zahashowany adres IP. Nigdy nie pojawiają się przy odpowiedziach sklepu.
- **Kod rabatowy**: po publikacji opinii klient otrzymuje kupon procentowy (domyślnie: 10 %, 30 dni), unikalny, jednorazowy, ograniczony do jego adresu e-mail. Ochrona przed nadużyciami: jedna nagroda na adres e-mail i produkt.
## Formularz i wyświetlanie
- **Pole tytułu** opinii, opcjonalne lub obowiązkowe.
- **Minimalna długość** opinii w znakach (domyślnie: 10).
- **Blok rozkładu ocen** (paski od 5★ do 1★) nad listą opinii.
- **Kolor gwiazdek** konfigurowalny (heksadecymalnie, domyślnie #e7a11a).
## Rich snippety Schema.org
Wtyczka zachowuje natywne znaczniki AggregateRating i Review z WooCommerce, porządkując je: odpowiedzi sklepu są wyłączone ze znaczników i ze średnich, dzięki czemu gwiazdki w Google pozostają dokładne. Opcję można wyłączyć w ustawieniach, co usuwa wtedy całe znakowanie opinii.
## Cron: niezawodna wysyłka
Przetwarzanie (prośby, przypomnienia, podsumowania AI, odpowiedzi zaległe) uruchamia się co godzinę przez WP-Cron. Ponieważ WP-Cron odpala się tylko przy odwiedzinach witryny, skonfiguruj prawdziwy cron serwerowy dla niezawodnej wysyłki:
1. Skopiuj **adres cron z tokenem** wyświetlany w **Settings → Cron**.
2. Dodaj go do crona u swojego hostingodawcy (lub do crontab), co 15 do 60 minut, na przykład poleceniem `curl -s "URL" > /dev/null`.
Blokada antywspółbieżnościowa zapobiega dwóm równoczesnym przebiegom. Przycisk **Run processing now** w zakładce Request queue uruchamia przetwarzanie ręcznie w dowolnym momencie.
## Import i eksport CSV
Zakładka **Import / Export**:
- **Eksport**: wszystkie opinie produktów z oceną, tytułem, znacznikiem weryfikacji i datami.
- **Import**: CSV z wierszem nagłówkowym i kolumnami `product_id` lub `sku`, `author`, `email`, `rating`, `title`, `content`, `date` (Y-m-d H:i:s, opcjonalnie), `verified` (1/0, opcjonalnie). Statystyki ocen są przeliczane automatycznie po imporcie.
## Panel klienta
Do konta klienta (Moje konto) dodawana jest zakładka **Moje opinie**: każdy klient znajdzie tam swoje opinie ze statusem moderacji, gwiazdkami i odznaką weryfikacji. Jeśli zakładka zwraca błąd 404 po aktywacji, zapisz ponownie bezpośrednie odnośniki w **Ustawienia → Bezpośrednie odnośniki → Zapisz**.
## RODO i dane
- Link do rezygnacji w każdym e-mailu z prośbą, adresy wypisane przechowywane w postaci skrótu SHA-256, nigdy jawnie.
- Adresy IP głosujących hashowane z użyciem soli WordPressa.
- Jedyne wywołanie wychodzące: API OpenAI, które kontrolujesz, wyłącznie po skonfigurowaniu klucza.
- Deinstalacja usuwa tabele i ustawienia wtyczki, ale **zachowuje wszystkie opinie** (natywne opinie WooCommerce).
## Rozwiązywanie problemów
- **Prośby nie wychodzą**: sprawdź, czy funkcja jest włączona, czy zamówienia osiągają status wyzwalający i czy cron działa (ostatni przebieg widoczny w AI tools). Skonfiguruj serwerowy adres cron.
- **Brak podsumowania AI**: czy klucz OpenAI jest skonfigurowany? Czy osiągnięto minimalną liczbę opublikowanych opinii? Podsumowanie powstaje przy przebiegu crona, nie natychmiast.
- **Brak odpowiedzi AI**: sprawdź tryb (w trybie szkicu odpowiedź czeka w Komentarze → Oczekujące), skonfigurowaną minimalną ocenę i klucz API.
- **E-maile nie dochodzą**: wtyczka wysyła przez mailer WooCommerce, przetestuj globalną konfigurację e-mail (zalecana wtyczka SMTP).