Feature Requests & Voting — Dokumentacja

Daj klientom osobne miejsce na stronach produktów, w którym mogą zgłaszać pomysły na ulepszenia, głosować na najważniejsze dla nich propozycje i śledzić publiczną roadmapę. Feature Requests & Voting zamienia powtarzające się wiadomości typu „czy możecie to dodać?” w widoczną tablicę zgłoszeń z liczbą głosów, etykietami statusu, odpowiedziami administratora i hubem roadmapy, który można podlinkować w sklepie.

Feature Requests & Voting

Feature Requests & Voting dodaje do stron produktów obszar zgłoszeń od klientów. Klienci mogą przesłać pomysł na funkcję dla aktualnego produktu, głosować na istniejące zgłoszenia i sprawdzić, czy pomysł jest w trakcie analizy, zaplanowany, w realizacji, wdrożony albo odrzucony.

Dla sprzedawców moduł dodaje dashboard w panelu administracyjnym oraz menedżer zgłoszeń, w którym można przeglądać nowe pomysły, zmieniać statusy, dodawać publiczną notatkę administratora, filtrować zgłoszenia, eksportować listę i używać głosów do oceny, które ulepszenia są dla klientów najważniejsze.

Zgodność: PrestaShop 1.6 do 9.0 (najnowsza wersja), PHP 7.1+. Nadal wspieramy kolejne wersje PrestaShop.

Jak to działa

Na każdej stronie produktu moduł może wyświetlać zakładkę Propozycje funkcji. Odwiedzający mogą otworzyć formularz zgłoszenia, wpisać tytuł i opis, a następnie przesłać pomysł dla danego produktu. Zalogowani klienci są rozpoznawani automatycznie; goście mogą wysłać zgłoszenie z imieniem i adresem e-mail, chyba że wymagane jest logowanie.

Każde nowe zgłoszenie otrzymuje jeden automatyczny głos od autora. Inni odwiedzający mogą głosować na widoczne zgłoszenia albo wycofać swój głos. Głosy są liczone według klienta w przypadku zalogowanych użytkowników albo według adresu IP przy głosowaniu gości.

Domyślny publiczny workflow używa tych rzeczywistych kluczy statusu:

submitted     = Submitted
under_review  = Under Review
planned       = Planned
in_progress   = In Progress
implemented   = Implemented
declined      = Declined

Zgłoszenia ze statusem submitted czekają na weryfikację i są widoczne tylko dla autora. Zgłoszenia ze statusem declined są ukryte w publicznym front office. Zatwierdzone publiczne zgłoszenia pojawiają się w zakładce produktu, na stronach zgłoszeń dla konkretnego produktu oraz w hubie roadmapy.

Instalacja

1. W panelu administracyjnym przejdź do Modules → Module Manager
2. Kliknij Upload a module i wybierz plik ZIP
3. Zainstaluj moduł
4. Kliknij Configure
5. Sprawdź ustawienia w Feature Requests → Settings
6. Otwórz stronę produktu i sprawdź zakładkę Feature Requests

Moduł instaluje trzy tabele bazy danych dla zgłoszeń, głosów oraz komentarzy/odpowiedzi administratora:

mprfeaturerequest_request
mprfeaturerequest_vote
mprfeaturerequest_comment

Konfiguracja

Ustawienia modułu w panelu administracyjnym są podzielone na zakładki: Ogólne, Głosowanie, Wyświetlanie, SEO i Powiadomienia.

Ustawienia ogólne

ENABLED = 1
REQUIRE_LOGIN = 0
REQUIRE_APPROVAL = 1
REQUESTS_PER_PAGE = 10

Włącz propozycje funkcji włącza lub wyłącza obszar zgłaszania propozycji w front office.

Wymagaj logowania do zgłoszenia określa, czy goście mogą przesyłać pomysły. Gdy opcja jest wyłączona, goście muszą podać imię i adres e-mail.

Wymagaj zatwierdzenia przez administratora utrzymuje nowe zgłoszenia w statusie submitted do czasu ich sprawdzenia. Gdy opcja jest wyłączona, nowe zgłoszenia zaczynają ze statusem under_review.

Zgłoszeń na stronę określa, ile zgłoszeń ze strony produktu jest ładowanych jednocześnie w zakładce.

Formularz zgłoszenia w front office używa tych limitów:

title: minimum 5 characters, maximum 255 characters
description: minimum 10 characters, maximum 2000 characters
guest name: maximum 128 characters
guest email: maximum 255 characters
rate limit: 3 requests per product per IP address per day

Ustawienia głosowania

VOTING_ENABLED = 1
GUEST_VOTING = 0

Włącz głosowanie pozwala klientom głosować na propozycje funkcji.

Zezwól na głosowanie gości pozwala odwiedzającym głosować bez logowania. Jeśli głosowanie gości jest wyłączone, głosować mogą tylko zalogowani klienci.

Śledzenie głosów używa ID klienta dla zalogowanych klientów i adresu IP odwiedzającego dla gości:

logged-in vote: id_request + id_customer
guest vote:     id_request + ip_address

Głosowanie działa jak przełącznik. Jedno kliknięcie dodaje głos; kolejne kliknięcie go usuwa.

Ustawienia wyświetlania

SHOW_ON_PRODUCT = 1
SHOW_VOTE_COUNT = 1
SHOW_STATUS_BADGE = 1
SHOW_ADMIN_COMMENTS = 1
SHOW_ROADMAP_PAGE = 1

Pokaż zakładkę na stronach produktów dodaje zakładkę propozycji funkcji do stron produktów.

Pokaż liczbę głosów wyświetla liczbę głosów obok każdego zgłoszenia.

Pokaż etykiety statusu wyświetla publiczne etykiety statusu, takie jak W analizie, Zaplanowane, W realizacji i Wdrożone.

Pokaż odpowiedzi administratora wyświetla publiczną notatkę administratora dodaną w edytorze zgłoszenia.

Włącz stronę roadmapy włącza publiczny hub roadmapy, który pokazuje widoczne zgłoszenia z różnych produktów.

Ustawienia SEO

INDEX_ROADMAP_PAGE = 1
INCLUDE_IN_SITEMAP = 1

Hub roadmapy może być indeksowany. Strony szczegółów oraz strony zgłoszeń modułu/produktu są celowo ustawione jako noindex.

roadmap page: configurable index/noindex
detail pages: noindex
module/product request pages: noindex
AJAX endpoints: noindex, nofollow, noarchive

Gdy dodawanie do sitemap jest włączone, a strona roadmapy może być indeksowana, moduł może dodać URL roadmapy do zgodnego generatora sitemap przez ten hook:

gSitemapAppendUrls

Wpis w sitemap używa:

priority: 0.5
changefreq: weekly
lastmod: latest public request update, or current date if no request date exists

Publiczne adresy URL

Moduł tworzy zlokalizowane trasy front office dla roadmapy, stron szczegółów oraz stron zgłoszeń dla konkretnych produktów.

Domyślne angielskie adresy URL używają:

/feature-requests
/feature-requests/{request-slug}
/feature-requests/module/{product-slug}
/feature-requests/module/{product-slug}/page/{page}

Zlokalizowane prefiksy tras zawarte w module to:

en: feature-requests
de: funktionswuensche
fr: demandes-de-fonctionnalites
pl: propozycje-funkcji
it: richieste-funzionalita
es: solicitudes-de-funciones

W sklepach wielojęzycznych moduł buduje adresy URL roadmapy zależne od języka oraz alternatywne adresy dla innych języków.

Zarządzanie w panelu administracyjnym

Po instalacji moduł dodaje menu Feature Requests z pozycjami:

Dashboard
Requests
Settings
Integrity
License
Support
Update

Dashboard pokazuje:

• Łączną liczbę zgłoszeń
• Nowe/przesłane zgłoszenia
• Zaplanowane/realizowane zgłoszenia
• Wdrożone zgłoszenia
• Łączną liczbę głosów
• Zgłoszenia dodane w tym miesiącu
• Ostatnie zgłoszenia
• Otwarte zgłoszenia z największą liczbą głosów

Lista zgłoszeń zawiera kolumny:

ID
Product
Customer
Title
Votes
Status
Date

W edytorze zgłoszenia możesz sprawdzić przesłany tytuł i opis, zobaczyć imię/nazwę klienta oraz e-mail, sprawdzić liczbę głosów, zmienić status i dodać Notatkę administratora. Notatka administratora jest publiczna, gdy włączone jest Pokaż odpowiedzi administratora.

Dostępne są akcje masowe do usuwania zgłoszeń i zmiany statusu zgłoszenia:

Set status: Submitted
Set status: Under Review
Set status: Planned
Set status: In Progress
Set status: Implemented
Set status: Declined

Doświadczenie klienta

Klient może:

• Otworzyć zakładkę Feature Requests na stronie produktu
• Przesłać pomysł dla tego produktu
• Głosować na widoczne zgłoszenia
• Sortować zgłoszenia produktu według największej liczby głosów, najnowszych lub najstarszych
• Wczytać więcej zgłoszeń bez opuszczania strony produktu
• Otworzyć szczegóły zgłoszenia z roadmapy
• Zobaczyć publiczne etykiety statusu, jeśli są włączone
• Zobaczyć publiczną odpowiedź administratora, jeśli jest włączona

Formularz na stronie produktu wysyła te akcje AJAX front office:

getToken
submitRequest
vote
loadRequests
loadComments

Akcje zapisu używają sprawdzenia tokena PrestaShop przed zaakceptowaniem zgłoszenia lub głosu.

Wskazówki

• Pozostaw Wymagaj zatwierdzenia przez administratora włączone, jeśli chcesz sprawdzać zgłoszenia przed ich publicznym wyświetleniem.
• Szybko przenoś zaakceptowane zgłoszenia ze statusu submitted. Tablica pełna oczekujących pozycji zniechęca klientów do dodawania kolejnych pomysłów.
• Używaj under_review dla pomysłów, które nadal oceniasz, planned dla zaakceptowanych prac, in_progress dla aktywnej realizacji i implemented po wydaniu.
• Dodaj krótką notatkę administratora, gdy zmieniasz ważne zgłoszenie na Zaplanowane, W realizacji, Wdrożone lub Odrzucone. Daje to klientom kontekst bez potrzeby osobnej odpowiedzi z supportu.
• Pozostaw zgłoszenia gości włączone, jeśli chcesz zmniejszyć bariery, ale wyłącz głosowanie gości, jeśli jakość głosów jest ważniejsza niż ich liczba.
• Podlinkuj hub roadmapy w stopce, obszarze konta lub na stronach wsparcia produktu, gdy chcesz, aby klienci łatwo znaleźli tablicę zgłoszeń.

Najczęściej zadawane pytania

Czy klient może głosować na własne zgłoszenie?
Tak. Nowe zgłoszenie zaczyna z jednym automatycznym głosem autora.

Czy goście mogą przesyłać zgłoszenia?
Tak, chyba że włączysz Wymagaj logowania do zgłoszenia. Zgłoszenia gości wymagają imienia i adresu e-mail.

Czy goście mogą głosować?
Tylko jeśli włączone jest Zezwól na głosowanie gości. W przeciwnym razie odwiedzający muszą się zalogować, aby zagłosować.

Jak sortowane są zgłoszenia na stronach produktów?
Domyślne sortowanie pokazuje najpierw zgłoszenia z największą liczbą głosów. Klienci mogą też sortować od najnowszych lub najstarszych.

Czy nowe zgłoszenia od razu pojawiają się publicznie?
Domyślnie nie. Gdy włączone jest Wymagaj zatwierdzenia przez administratora, nowe zgłoszenia używają statusu submitted i są widoczne tylko dla autora, dopóki nie zmienisz ich statusu.

Które statusy są ukryte na publicznej liście?
Zgłoszenia submitted są ukryte dla wszystkich poza autorem, a zgłoszenia declined są ukryte w front office.

Czy mogę pokazać publiczną odpowiedź na zgłoszenie?
Tak. Dodaj Notatkę administratora w edytorze zgłoszenia i pozostaw włączone Pokaż odpowiedzi administratora.

Czy moduł tworzy indeksowalną stronę roadmapy?
Tak. Główny hub roadmapy może być indeksowany, gdy włączone jest Index Feature Requests Hub. Strony szczegółów, strony filtrowane/modułu oraz endpointy AJAX pozostają noindex.

Czy roadmapa może zostać dodana do sitemap XML?
Tak, gdy włączone jest Include Feature Requests Hub in Sitemap, a strona roadmapy może być indeksowana.