DataFirefly Zweryfikowane Opinie: dokumentacja

Wymagania i instalacja

DataFirefly Zweryfikowane Opinie działa na PrestaShop od 8.0 do 9.0 z PHP od 8.0 do 8.4. Od wersji 1.1.0 jeden plik ZIP obsługuje obie gałęzie: przy pobieraniu nie trzeba wybierać między wersją dla PS 8 a wersją dla PS 9.

1. W panelu administracyjnym otwórz Moduły → Menedżer modułów i kliknij Wgraj moduł.
2. Przeciągnij plik dfreviews.zip pobrany z konta DataFirefly.
3. Po zakończeniu instalacji kliknij Konfiguruj.

Instalacja tworzy sześć dedykowanych tabel (opinie, media, prośby, głosy przydatności, podsumowania AI, statystyki) i dodaje zakładkę Zweryfikowane Opinie w menu Katalog. To z tej zakładki moderujesz opinie; ekran konfiguracji pozostaje dostępny z menedżera modułów.

Konfiguracja wyzwalacza próśb o opinię

To serce modułu. Dwa ustawienia w sekcji Ustawienia ogólne:

• Wyzwalaj po statusie: Wysłane (domyślnie) lub Dostarczone. Wybierz ten, który w twoim rzeczywistym procesie oznacza, że klient ma produkt w ręku.
• Opóźnienie przed wysyłką: domyślnie 3 dni. Doliczaj czas dostawy plus kilka dni użytkowania. Przy produktach ocenianych dopiero po pewnym czasie (kosmetyki, materace) zwiększ do 10 lub 15 dni.

Gdy zamówienie osiąga wybrany status, prośba trafia do kolejki z wyliczoną datą wysyłki. Nie jest wysyłana natychmiast: zajmuje się tym CRON.

Uruchomienie CRON-a

Bez CRON-a nie wychodzi żaden e-mail. Adres URL do wywołania jest wyświetlany u góry ekranu konfiguracji modułu i zawiera unikalny token wygenerowany podczas instalacji. Zaplanuj go co godzinę u swojego hostingodawcy:

0 * * * * wget -q -O /dev/null "ADRES_CRON_WYSWIETLONY_W_MODULE"

Przy każdym przebiegu CRON wykonuje trzy zadania i zwraca podsumowanie JSON wykonanej pracy:

• wysyłka próśb, których termin nadszedł, partiami po 50;
• wysyłka przypomnień dla próśb bez odpowiedzi;
• wygaszanie próśb starszych niż 60 dni.

Przypomnienia i kod rabatowy jako nagroda

Sekcja Przypomnienie włącza drugi e-mail, jeśli opinia nie została wystawiona po konfigurowalnym czasie (domyślnie 5 dni, liczone od pierwszej wysyłki). Na jedną prośbę wysyłane jest tylko jedno przypomnienie.

Sekcja Kod rabatowy motywacyjny generuje kupon zniżkowy, gdy tylko zidentyfikowany klient opublikuje opinię. Ustalasz procent (domyślnie 10 %) i okres ważności (30 dni). Utworzony kod to natywna reguła koszyka PrestaShop, imienna i jednorazowa, znajdziesz go więc w Katalog → Rabaty.

Włączenie podsumowania AI

Wprowadź klucz API OpenAI w sekcji Sztuczna inteligencja i wybierz model. Domyślny jest gpt-4o-mini: najbardziej ekonomiczny, rzędu pół centa za podsumowanie.

Podsumowanie uruchamia się od trzech opublikowanych opinii o produkcie. Moduł wysyła do OpenAI maksymalnie 100 opinii i odbiera trzy uporządkowane elementy: mocne strony, słabe strony, syntezę ogólną. Wynik jest zapisywany w pamięci podręcznej dla produktu, sklepu i języka, a następnie wyświetlany na górze sekcji opinii na karcie produktu.

Wyświetlanie można wyłączyć bez usuwania klucza dzięki opcji Pokaż podsumowanie AI na stronie produktu.

Rich snippets i wyświetlanie w sklepie

Gdy opcja Rich Snippets jest aktywna, moduł wstrzykuje dane strukturalne Schema.org (AggregateRating, Review, Offer, Brand) na każdej karcie produktu, która osiąga skonfigurowaną minimalną liczbę opinii. Po wizycie robota sprawdź wynik narzędziem Google do testowania wyników z elementami rozszerzonymi.

Po stronie wyświetlania moduł podpina się do natywnych hooków motywu:

• displayProductAdditionalInfo: gwiazdki i średnia ocena pod tytułem produktu;
• displayProductExtraContent: zakładka „Opinie klientów” z listą, filtrami i formularzem;
• displayProductListReviews: gwiazdki na listach kategorii;
• displayCustomerAccount: link „Moje opinie” na koncie klienta.

Te hooki istnieją w motywach Classic i Hummingbird. W motywie na zamówienie, który je usunął, trzeba je przywrócić w odpowiednich szablonach, inaczej opinie nie pojawią się nigdzie.

Moderacja opinii

Ekran Katalog → Zweryfikowane Opinie pokazuje pulpit (łącznie, opublikowane, oczekujące, zgłoszone, średnia ocena, prośby w kolejce), a pod nim pełną listę opinii.

Domyślnie każda opinia czeka na twoje zatwierdzenie. Włącz Automatyczne zatwierdzanie, jeśli wolisz natychmiastową publikację. Z listy możesz zatwierdzać lub odrzucać zbiorczo oraz otworzyć opinię, aby ją edytować lub na nią odpowiedzieć.

Odpowiedź sprzedawcy wyświetla się publicznie pod opinią. Jeśli skonfigurowano klucz OpenAI, przycisk Sugestia odpowiedzi AI proponuje szkic dopasowany do tonu opinii, do przeczytania i poprawienia przed zapisem, nigdy do publikacji w niezmienionej formie.

Zdjęcia klientów

Klienci mogą dołączyć do opinii maksymalnie N zdjęć (domyślnie 3). Akceptowane formaty: JPEG, PNG i WebP, maksymalnie 5 MB na plik. Rzeczywisty typ pliku jest weryfikowany przy odbiorze, niezależnie od jego nazwy.

Obrazy przechowywane są w modules/dfreviews/uploads/. Uwzględnij ten katalog w kopiach zapasowych: usunięcie opinii usuwa również jej pliki.

Import i eksport opinii

Na ekranie Zweryfikowane Opinie przycisk Eksportuj CSV tworzy plik UTF-8 rozdzielany średnikami, otwierany bezpośrednio w Excelu. Blok importu tuż poniżej pozwala wczytać plik w tym samym formacie.

Dwie kolumny są obowiązkowe: id_product i rating (od 1 do 5). Pozostałe są opcjonalne: customer_name, customer_email, title, content, id_customer, id_order, verified_purchase, active, merchant_reply i date_add. Wiersze, których produkt nie istnieje, są pomijane i zgłaszane. Zaznacz Zatwierdzaj automatycznie, aby od razu publikować zaimportowane opinie.

Najprostszy sposób na przygotowanie migracji z Trustpilota lub starego modułu: najpierw wyeksportuj plik z modułu, aby uzyskać dokładny nagłówek, a potem wlej do niego swoje dane.

Multisklep i wielojęzyczność

Cała konfiguracja jest niezależna dla każdego podsklepu: klucz OpenAI, status wyzwalający, opóźnienia, kolory, nagroda. Opinie są rozdzielone przez id_shop, więc ten sam produkt obecny w kilku sklepach może wyświetlać różne zestawy opinii zależnie od kontekstu.

Opinie i podsumowania AI są zapisywane wraz z ich id_lang. Podsumowanie generowane jest dla języka, w którym o nie poproszono.

Przejście z PrestaShop 8 na PrestaShop 9

Migracja danych nie jest potrzebna: schemat jest identyczny w obu gałęziach. Zastąp moduł wersją 1.1.0 przed aktualizacją PrestaShop albo po niej, w dowolnej kolejności.

Jeśli aktualizujesz z wersji 1.0.x w sklepie już przeniesionym na PS 9, warto znać dwie rzeczy: wersje wcześniejsze niż 1.1.0 nie instalują się na PS 9 (rejestracja hooków bez odpowiadającej metody jest tam odrzucana), a istniejąca konfiguracja jest w całości zachowywana podczas aktualizacji.

Rozwiązywanie problemów

Nie wychodzi żaden e-mail z prośbą. Najpierw sprawdź, czy CRON faktycznie działa, wywołując jego adres ręcznie: odpowiedź JSON podaje liczbę wysyłek. Następnie sprawdź skonfigurowany status wyzwalający i ustawienia e-mail sklepu w Parametry zaawansowane → E-mail.

Gwiazdki nie pojawiają się na karcie produktu. Motyw prawdopodobnie nie wywołuje wymienionych wyżej hooków. Sprawdź też, czy opublikowana jest przynajmniej jedna opinia: bez aktywnej opinii nic się nie wyświetla.

Podsumowanie AI nie jest generowane. Potrzebne są minimum trzy opublikowane opinie oraz ważny klucz OpenAI ze środkami. Błędy wywołań API są rejestrowane w Parametry zaawansowane → Logi.

Gwiazdki nie pojawiają się w Google. Indeksowanie trwa od kilku dni do kilku tygodni. Zweryfikuj znaczniki narzędziem do testowania wyników z elementami rozszerzonymi i sprawdź, czy inny moduł SEO nie wstrzykuje konkurencyjnego drugiego bloku Product na tej samej stronie.

Import CSV nic nie robi. To była wada wersji 1.0.x, poprawiona w 1.1.0.