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 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ą.

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.
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.

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.

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.

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).