1. Do czego służy moduł
Moduł dodaje na karcie produktu przycisk „Zapytaj o produkt”. Otwiera on krótki formularz: imię i nazwisko, e-mail, pytanie i zgodę. Pytanie trafia na Twoją skrzynkę z nazwą produktu, indeksem, wybranym wariantem i linkiem, a odpowiadasz po prostu odpisując na e-mail. Klient dostaje potwierdzenie, że pytanie dotarło.
Działa z PrestaShop 1.7.8, 8.x i 9.x (PHP 7.2.5 lub nowszy), z szablonami Classic i Hummingbird oraz z trybem multistore.
2. Instalacja
- Pobierz moduł z Moje konto → Historia zamówień w sklepie addonspresta.com.
- W panelu sklepu otwórz Moduły → Menedżer modułów i kliknij Załaduj moduł.
- Upuść plik
ap_productquestion_v1.0.0.zipi poczekaj na potwierdzenie. - Kliknij Konfiguruj na karcie modułu.
Zaraz po instalacji przycisk jest widoczny przy każdym produkcie, a pytania trafiają na adres e-mail sklepu (Preferencje → Kontakt). Wyślij sobie pytanie testowe, żeby sprawdzić, czy sklep wysyła e-maile (Zaawansowane → E-mail).
3. Jak to działa
Przycisk pojawia się pod przyciskiem dodawania do koszyka każdego aktywnego produktu, także w szybkim podglądzie na listach produktów. Kliknięcie otwiera pod nim formularz, kolejne go zwija. Zalogowany klient ma już wpisane imię i adres e-mail. Formularz działa również bez JavaScriptu — wtedy po wysłaniu karta produktu przeładowuje się z wynikiem.
Gdy klient wysyła formularz, moduł sprawdza pola (imię i nazwisko, poprawny e-mail, pytanie od 10 do 2000 znaków, zaznaczoną zgodę) i pokazuje, czego brakuje. Potem wysyła:
- do Ciebie — pytanie z nazwą produktu, indeksem, wariantem i linkiem, imieniem i adresem e-mail klienta oraz językiem strony, z której pisał. Adres do odpowiedzi (Reply-To) to adres klienta, więc Odpowiedz trafia prosto do niego. Wiadomość jest w języku domyślnym sklepu.
- do klienta (jeśli włączone) — krótkie potwierdzenie, że pytanie dotarło, z linkiem do produktu, w języku klienta. Nie powtarza treści pytania, a jeden adres dostaje najwyżej jedno potwierdzenie na dobę: adres nie jest weryfikowany, więc sklep nigdy nie wysyła na niego tekstu wpisanego przez obcą osobę.
Szablony wiadomości są po angielsku, polsku i francusku; pozostałe języki dostają angielskie.
Moduł chroni przed spamem bez captchy i bez zewnętrznych usług:
- ukryte pole, którego ludzie nie widzą — formularz z wypełnionym polem jest pomijany;
- minimalny czas: formularz wysłany szybciej niż 3 sekundy po otwarciu strony albo później niż po 2 godzinach jest pomijany;
- limit pytań na odwiedzającego na godzinę i 100 pytań na sklep na godzinę. Odwiedzający jest rozpoznawany po zaszyfrowanym kluczem odcisku adresu IP, przechowywanym 24 godziny; sam adres nigdy nie jest zapisywany;
- formularze wysłane z innej strony internetowej są odrzucane.
Pominięty formularz wygląda dla wysyłającego na wysłany, więc automaty niczego się nie dowiadują. Same pytania nie są zapisywane w sklepie — tylko wysyłane e-mailem. Moduł nie łączy się z addonspresta.com ani z żadnym innym serwerem.
4. Funkcje i ustawienia
Otwórz Moduły → Menedżer modułów → Zapytaj o produkt → Konfiguruj. Ramka Pomoc na górze prowadzi do tej instrukcji i do strony modułu w addonspresta.com, w języku Twojego panelu. Panel pokazuje adres, na który trafiają pytania.
- Etykieta przycisku — tekst przycisku, np. „Zapytaj o produkt”, w każdym języku.
- Wysyłaj pytania na adres — adres, na który trafiają pytania. Zostaw puste, żeby używać adresu sklepu.
- Wysyłaj potwierdzenie do klienta — klient dostaje krótkie potwierdzenie z linkiem do produktu (domyślnie włączone).
- Treść zgody — tekst obok pola, które klient musi zaznaczyć, w każdym języku.
- Strona polityki prywatności — strona CMS podlinkowana po treści zgody, zwykle polityka prywatności.
- Pytań na odwiedzającego na godzinę — od 1 do 50 (domyślnie 5). Kolejne pytania tego samego odwiedzającego są odrzucane z komunikatem, dopóki nie minie godzina.
5. Multistore
Ustawienia zapisują się dla sklepu lub grupy sklepów wybranej w nagłówku panelu, więc każdy sklep może wysyłać pytania na własny adres i mieć własne teksty. W kontekście wszystkich sklepów albo grupy zapisać może tylko pracownik, który zarządza każdym jej sklepem. Jedna licencja obejmuje wszystkie sklepy instalacji.
6. Odinstalowanie
Menedżer modułów → Zapytaj o produkt → Odinstaluj usuwa ustawienia modułu i jego tabelę. Żeby zachować ustawienia, użyj Wyłącz.
7. Najczęstsze pytania i problemy
Klient widzi „Dziękujemy”, ale e-mail nie dochodzi. Sprawdź Zaawansowane → E-mail: sklep musi mieć włączone wysyłanie e-maili, a e-mail testowy musi dochodzić. Sprawdź adres w Wysyłaj pytania na adres i folder spamu.
Czy mogę zmienić treść e-maili?
Tak. Skopiuj katalog modułu mails/<język> do themes/<twój-szablon>/modules/ap_productquestion/mails/<język> i zmień
kopie. Zostaw zmienne {…}; w szablonie HTML używaj tych zakończonych na _html.
Klient nie może już wysyłać pytań. Wyczerpał limit pytań na godzinę. Zwiększ Pytań na odwiedzającego na godzinę, jeśli klienci pytają dużo.
Czy mogę wysyłać pytania do CRM-a albo systemu zgłoszeń?
Tak, własnym małym modułem korzystającym z hooka actionApProductquestionBeforeSend (opis w README.md).
Czy mogę zmienić wygląd formularza?
Tak. Dodaj do szablonu CSS dla klas .ap-productquestion albo skopiuj views/templates/hook/form.tpl do
themes/<twój-szablon>/modules/ap_productquestion/views/templates/hook/ i zmień kopię.
8. Aktualizacje i wsparcie
Aktualizacje są bezpłatne dożywotnio: nowe wersje pobierasz z Moje konto → Historia zamówień w addonspresta.com i wgrywasz jak nowy moduł. Ustawienia zostają zachowane.
Wsparcie obejmuje 12 miesięcy od zamówienia: napisz na mail@addonspresta.com albo przez formularz kontaktowy w addonspresta.com (od poniedziałku do piątku, 10:00–16:00; odpowiadamy zwykle w ciągu 2 dni roboczych). Podaj wersję PrestaShop, wersję modułu i kroki, które prowadzą do problemu.