Medusa daje szkielet opinii o produktach. Dobudowaliśmy to, czego potrzebuje prawdziwy sklep.

Co Medusa daje w sprawie opinii o produktach?

Medusa nie ma opinii o produktach w standardzie. Dokumentacja mówi to wprost i proponuje oficjalny poradnik, w którym krok po kroku powstaje własny moduł: model opinii z oceną od 1 do 5, tytułem, treścią i statusem (oczekuje, zatwierdzona, odrzucona), powiązanie z produktem, formularz dla zalogowanego klienta, lista zatwierdzonych opinii ze średnią oraz strona w panelu, na której można opinie zatwierdzać i odrzucać.

To dobry punkt startu i dobry przykład, jak rozszerza się Medusę. Poradnik nie odpowiada jednak na pytania, które pojawiają się w dniu uruchomienia sklepu.

Skąd wiadomo, że opinię napisał klient, który kupił produkt?

O tym, czy opinia jest potwierdzona zakupem, decyduje backend. Zanim moduł zapisze opinię, sprawdza, czy oceniany produkt znajduje się w zamówieniu tej osoby. Ukrycie przycisku „Oceń” w interfejsie nie jest zabezpieczeniem, bo żądanie do API może wysłać każdy.

Opinię można wystawić dopiero wtedy, gdy zamówienie ma status „dostarczone”. Wcześniej klient nie miał produktu w rękach, więc nie ma czego oceniać. Późniejszy zwrot produktu nie usuwa opinii: zakup się odbył, a klient produkt poznał. Jeden produkt z jednego zamówienia można ocenić raz, a późniejsze zmiany są edycją tej samej opinii.

Dzięki temu etykieta „Zakup potwierdzony” przy opinii na stronie produktu ma pokrycie w danych, a w panelu przy każdej opinii widać numer zamówienia, z którego pochodzi.

Klient bez konta też może wystawić opinię potwierdzoną zakupem. Link w mailu z prośbą o opinię zawiera token przypisany do zamówienia i ma termin ważności, podany w treści wiadomości. Tokenu nie da się użyć do oceny produktów z innego zamówienia.

Jak zebrać opinie klientów bez zasypywania ich mailami?

Opinie zbierają dwa miejsca: konto klienta i jeden mail. Na koncie zakładka „Opinie” pokazuje listę kupionych produktów, które czekają na ocenę, a baner na stronie głównej konta przypomina, ile ich jest.

Mail z prośbą o opinię wychodzi raz, tydzień po zamówieniu, i tylko do osób, które zaznaczyły zgodę w kasie. Do jednego zamówienia nie wysyłamy kolejnych przypomnień. Z prośby można zrezygnować jednym kliknięciem już w mailu potwierdzającym zamówienie.

Gwiazdki w mailu są klikalne. Kliknięcie przenosi do formularza z już wybraną oceną, więc klient zaczyna od połowy pracy. Formularz podpowiada gotowe zdania dobrane do liczby gwiazdek, które można kliknąć i uzupełnić własnymi słowami. Tytuł jest opcjonalny, a podpis klient ustala sam.

Opinię można później zmienić. Na koncie klient widzi status każdej swojej opinii oraz odpowiedź sklepu, jeśli się pojawiła.

Klient dostaje w sumie cztery rodzaje wiadomości:

1. Prośbę o opinię.
2. Informację, że opinia została opublikowana.
3. Informację, że sklep odpowiedział na opinię.
4. Informację, że opinia została odrzucona, z powodem i sposobem odwołania.

Jak wygląda moderacja opinii w panelu Medusy?

Każda opinia czeka na akceptację, także po edycji przez klienta. Administrator dostaje maila o każdej nowej opinii, a w panelu Medusy ma osobną stronę „Opinie” z kolejką oczekujących, opublikowanych i odrzuconych oraz wyszukiwarką po treści i autorze.

Przy opinii administrator ma trzy decyzje: opublikować, odrzucić z podaniem powodu albo odpowiedzieć publicznie. Opublikowaną opinię można też zdjąć ze strony. Szczegóły pokazują produkt, zamówienie i źródło opinii (konto albo mail), a moduł przechowuje historię zmian każdej opinii.

Te same opinie widać na karcie produktu w panelu, razem ze średnią, liczbą opinii czekających na decyzję i oznaczeniem tych, które klient edytował. Panel liczy też statystyki: średnią ocenę i odsetek próśb, na które klienci odpowiedzieli.

Czy sklep może usunąć negatywną opinię?

Sklep nie powinien usuwać opinii za niską ocenę. W naszym module odrzucić opinię wolno tylko za naruszenie opublikowanych zasad, a odrzucenie wymaga podania powodu, który trafia do autora razem z informacją, jak się odwołać.

Ta reguła nie jest kwestią stylu. Dyrektywa Omnibus zalicza zniekształcanie opinii konsumentów w celu promowania produktów do nieuczciwych praktyk rynkowych. Publikowanie wyłącznie pozytywnych opinii i usuwanie negatywnych jest przykładem takiego zniekształcania. Google wymaga z kolei, żeby sklep przekazywał do programu ocen produktów wszystkie opinie, także te z niską oceną (zasady ocen produktów, stan na październik 2026).

Na niską ocenę lepiej odpowiedzieć publicznie. Odpowiedź sklepu wyświetla się pod opinią, a klient dostaje o niej maila.

Co widzi kupujący na stronie produktu?

Kupujący widzi średnią ocenę, rozkład gwiazdek i listę opinii od najnowszych. Opinie można filtrować po liczbie gwiazdek, a kolejne doładowują się stopniowo, zamiast ładować całą listę naraz. Gwiazdki i średnia pojawiają się też na kartach produktów w listingach.

Średnia i liczba opinii liczą się wyłącznie z opinii opublikowanych. Opinia, która czeka na akceptację albo została odrzucona, nie zmienia oceny produktu ani na jego stronie, ani w listingu.

Dwa elementy wynikają z przepisów. Okno „Jak sprawdzamy opinie” wyjaśnia, że opinie pochodzą od kupujących i przechodzą moderację. Link „Zgłoś” przy każdej opinii pozwala zgłosić treść, która narusza prawo albo zasady.

Jak opinie o produktach trafiają do Google?

Do Google prowadzą dwie osobne drogi. Pierwsza to dane strukturalne na stronie produktu: ocena zbiorcza i pojedyncze opinie opisane w formacie schema.org. Google może wtedy pokazać gwiazdki w wynikach wyszukiwania, pod warunkiem że oznaczone opinie są widoczne dla użytkownika na tej samej stronie (wytyczne Google). Google nie gwarantuje, że gwiazdki się wyświetlą.

Druga droga to plik z opiniami dla Merchant Center, dzięki któremu oceny pojawiają się przy reklamach i ofertach produktowych. Program ocen produktów wymaga co najmniej 50 opinii łącznie dla wszystkich produktów oraz aktualizacji pliku przynajmniej raz w miesiącu (wymagania programu, stan na październik 2026). Dlatego plik włączamy dopiero po zebraniu 50 opinii.

Co Omnibus, DSA i RODO zmieniają w opiniach w sklepie?

Przepisy wpływają na projekt modułu opinii w trzech miejscach: w sposobie weryfikacji, w moderacji i w przechowywaniu danych. Poniżej wymogi, pod które projektowaliśmy moduł.

Regulamin, polityka prywatności i informacja o przetwarzaniu danych w sklepie opisują opinie tak, jak działa moduł.

Jak ten moduł jest zbudowany w Medusie?

Opinie to własny moduł Medusy z trzema tabelami: opinie, prośby o opinię i historia zmian. Osobna tabela próśb pozwala policzyć, na ile maili klienci odpowiedzieli, i pilnuje, żeby do jednego zamówienia wyszła jedna prośba. Historia zmian przechowuje poprzednie wersje edytowanych opinii.

Cztery decyzje techniczne mają największe znaczenie:

1. Zakup sprawdza backend. Reguła „tylko kupujący” jest egzekwowana przy zapisie opinii, a nie w komponencie sklepu.
2. Linki w mailach chroni token. Token wskazuje zamówienie i wygasa, więc link z maila nie daje dostępu do konta ani do innych zamówień.
3. Analityka nie dostaje danych osobowych. GA4 otrzymuje zdarzenie review_submitted, ale tokeny i adresy e-mail do niego nie trafiają.
4. API ma limity. Jeden produkt z jednego zamówienia można ocenić raz, a liczba żądań jest ograniczona, więc opinii nie da się wysyłać hurtowo.

Dopracowanie zachowań zajęło tydzień i szło iteracyjnie: po każdej wersji sprawdzaliśmy, co dzieje się z opublikowaną opinią po edycji, kiedy wychodzi który mail i co klient widzi przy każdym statusie.

Panel administratora rozszerzyliśmy o stronę „Opinie” i sekcję na karcie produktu. Obie korzystają z komponentów panelu Medusy, więc obsługa sklepu nie uczy się nowego narzędzia. Tak samo budujemy inne funkcje w ramach wdrożeń Medusa.js: własny moduł, dane w tej samej bazie co zamówienia i panel, który zespół już zna.

Kiedy własny moduł opinii to zły wybór?

Własny moduł opinii nie opłaca się, gdy wystarczy gotowe narzędzie. Cztery sytuacje, w których tak jest:

• Sklep stoi na platformie z gotową aplikacją do opinii. Na Shopify, Shoperze czy WooCommerce opinie uruchamia się z gotowej aplikacji albo wtyczki i budowanie własnego rozwiązania nie ma uzasadnienia.
• Zależy ci na rozpoznawalnym znaku zewnętrznego serwisu. Serwisy opinii działają też poza sklepem: mają własne profile firm, widgety i rozpoznawalność. Własny moduł tego nie da.
• Zamówień jest mało. Przy kilkunastu zamówieniach miesięcznie moderację i prośby o opinię da się prowadzić ręcznie.
• Chcesz przenieść opinie ze starej platformy. Importu świadomie nie zrobiliśmy. Opinia przeniesiona z innego systemu nie przechodzi tej samej weryfikacji zakupu, więc nie mogłaby stać obok opinii z etykietą „Zakup potwierdzony” bez osobnego oznaczenia.

Własny moduł ma sens, gdy sklep działa na Medusie, opinie mają być powiązane z zamówieniami w tej samej bazie, a dane klientów nie powinny trafiać do kolejnego dostawcy. To ta sama decyzja, którą opisujemy w tekście custom czy gotowe oprogramowanie: buduj tylko to, czego gotowe narzędzie nie robi dobrze.

Opinie to jedna z wielu funkcji, których sklep potrzebuje poza koszykiem i płatnością. Moduł opinii jest częścią naszej podstawy z Medusą, więc w ofercie działający e-commerce w 30 dni nie budujemy go od zera, tylko dopasowujemy do sklepu. Kompletną ścieżkę zakupową zbudowaną przez nas w Medusa.js pokazuje realizacja Alufix.