DF Samples: zamawianie próbek (PrestaShop 8 i 9)

Wprowadzenie

DF Samples dodaje na kartach produktów przycisk „Zamów próbkę”. Próbka może być bezpłatna albo płatna. Moduł automatycznie generuje ukryty produkt próbkowy dla każdego produktu zapisanego do programu, stosuje limity na klienta, śledzi konwersję z próbki na zakup i automatycznie przypomina się klientom e-mailem, opcjonalnie z kuponem rabatowym.

Moduł jest zgodny z PrestaShop od 8.0 do 9.x, obsługuje multistore i wiele języków oraz nie używa żadnych nadpisań rdzenia.

Instalacja

1. W panelu administracyjnym przejdź do Moduły > Menedżer modułów.
2. Kliknij Wgraj moduł i wskaż plik dfsamples.zip.
3. Podczas instalacji moduł tworzy swoje dwie tabele, ustawienia domyślne, token zabezpieczający zadanie cron oraz zakładkę administracyjną Katalog > Próbki (DF).

Moduł rejestruje się na hookach displayProductActions, displayProductAdditionalInfo, actionFrontControllerSetMedia, actionValidateOrder i actionObjectProductDeleteAfter.

Dodawanie produktu do programu próbek

1. Otwórz Katalog > Próbki (DF).
2. Kliknij Dodaj.
3. Wyszukaj produkt po nazwie lub indeksie w polu z autouzupełnianiem, a następnie wybierz go z listy. Produkty już zapisane do programu oraz same produkty próbkowe są automatycznie wykluczane z wyników.
4. Wpisz cenę próbki brutto. Wpisz 0,00 dla próbki bezpłatnej.
5. Ustaw maksimum na klienta dla tego produktu (0 oznacza bez limitu).
6. Zapisz.

Co moduł robi przy zapisie

Moduł automatycznie tworzy ukryty produkt próbkowy:

• Nazwa z prefiksem przetłumaczonym na Twoje języki: Échantillon, Sample, Muestra, Muster, Campione.
• Dedykowany indeks w formacie SMPL, po którym następuje identyfikator produktu źródłowego.
• Cena netto wyliczona z wpisanej ceny brutto i stawki VAT produktu źródłowego.
• Zdjęcie główne produktu źródłowego skopiowane i przeskalowane we wszystkich formatach.
• Widoczność ustawiona na „nigdzie”: produkt nie pojawia się ani w nawigacji, ani w wyszukiwarce.
• Nieograniczony stan magazynowy (zgoda na zamawianie przy braku towaru), aby nigdy nie zablokować zgłoszenia.
• Waga próbki pobrana z ustawienia globalnego, wykorzystywana przez przewoźników.

Jeśli później zmienisz cenę, wagę globalną lub status aktywności, produkt próbkowy zostanie zsynchronizowany ponownie. Jeśli produkt próbkowy został ręcznie usunięty z katalogu, będzie odtworzony przy następnym zapisie.

Ustawienia

Ustawienia znajdują się na dole strony Katalog > Próbki (DF), pod listą produktów.

Ustawienia ogólne

• Pozycja przycisku: pod przyciskiem dodania do koszyka (displayProductActions) albo w bloku informacji dodatkowych (displayProductAdditionalInfo). Zmień to ustawienie, jeśli Twój motyw nie renderuje pierwszego hooka.
• Domyślna cena próbki brutto: wartość wypełniana wstępnie przy tworzeniu nowej próbki.
• Waga próbki: w kilogramach, stosowana do wszystkich generowanych produktów próbkowych. Używana do wyliczenia kosztów wysyłki.
• Wymagane konto klienta: zalecane i włączone domyślnie. Limity na klienta można rzetelnie egzekwować tylko wobec zidentyfikowanych klientów.
• Konwersja liczona na: wyłącznie zakup produktu, którego dotyczyła próbka, albo dowolny późniejszy zakup.

Limity

• Maksymalna liczba próbek w koszyku: 0 oznacza bez limitu.
• Maksymalna liczba próbek na klienta w oknie czasowym: łącznie dla wszystkich produktów próbkowych. 0 oznacza bez limitu.
• Okno kroczące: w dniach, domyślnie 30. Liczniki na klienta obejmują ten kroczący okres.

Ta sama próbka nigdy nie może zostać dodana dwa razy do tego samego koszyka, niezależnie od konfiguracji.

Automatyczne przypomnienie

• Włącz e-maile przypominające.
• Opóźnienie po zamówieniu próbki: w dniach, domyślnie 14.
• Dołącz kupon rabatowy: dla każdego przypomnienia generowany jest imienny kupon jednorazowego użytku.
• Wartość kuponu: w procentach, domyślnie 10.
• Ważność kuponu: w dniach, domyślnie 30.

Adres URL zadania cron, zabezpieczony tokenem, jest wyświetlany w tej sekcji oraz w panelu statystyk.

Konfiguracja zadania cron

Przypomnienia są wysyłane przez zadanie cron. Zaplanuj wywołanie adresu URL wyświetlonego w ustawieniach co godzinę. Przykładowy wpis w crontabie:

0 * * * * wget -q -O /dev/null "https://twoj-sklep.pl/module/dfsamples/cron?token=TWOJ_TOKEN"

Każde uruchomienie obsługuje do pięćdziesięciu oczekujących przypomnień i zwraca podsumowanie w formacie JSON: liczbę rekordów przetworzonych, wysłanych, pominiętych i oczekujących.

Reguły stosowane przez zadanie cron

• Brane pod uwagę są wyłącznie próbki jeszcze nieprzekonwertowane i takie, do których nie wysłano jeszcze przypomnienia.
• Zamówienie próbki musi mieć status opłacone, wysłane lub dostarczone.
• Zamówienia anulowane lub z błędem płatności są pomijane trwale.
• Zamówienia oczekujące na płatność są przesuwane do następnego uruchomienia.

Śledzenie konwersji

Przy zatwierdzeniu każdego zamówienia moduł zapisuje pozycje próbkowe: klienta, adres e-mail, produkt źródłowy, język i sklep.

Gdy ten sam klient złoży późniejsze zamówienie, moduł oznacza odpowiednie próbki jako przekonwertowane:

• W trybie produkt (domyślnym): tylko jeśli zamówienie zawiera produkt, którego próbkę klient otrzymał.
• W trybie dowolny zakup: gdy tylko zamówienie zawiera jakikolwiek zwykły produkt.

Bieżące zamówienie jest wyłączone z obliczeń: zamówienie próbki i jej produktu w tym samym koszyku nie liczy się jako konwersja.

Panel statystyk

Panel wyświetlany nad listą produktów prezentuje:

• Zamówione próbki: łączną liczbę zapisanych pozycji próbkowych.
• Konwersje: liczbę próbek, po których nastąpił zakup, oraz powiązany współczynnik konwersji.
• Obrót z konwersji: sumę kwot brutto zamówień konwertujących.
• Oczekujące przypomnienia: liczbę próbek kwalifikujących się do przypomnienia, które nie zostało jeszcze wysłane.

Lista produktów pokazuje dodatkowo dla każdego produktu liczbę zamówionych próbek i liczbę konwersji.

E-maile przypominające

Szablony znajdują się w folderze mails modułu, w pięciu językach: fr, en, es, de, it. Każdy język ma wersję HTML i wersję tekstową szablonu dfsamples_followup.

Dostępne zmienne: firstname, lastname, product_name, product_link, voucher_block i shop_name. Blok voucher_block zawiera sformatowany kupon rabatowy albo pusty ciąg znaków, jeśli kupon jest wyłączony.

Możesz dowolnie dostosować te szablony. Zachowaj zmienne w nawiasach klamrowych, aby podstawianie działało.

Kupony rabatowe

Gdy opcja jest włączona, każde przypomnienie generuje regułę koszyka PrestaShop:

• Kod w formacie SMPL, po którym następuje osiem losowych znaków.
• Ograniczony do klienta będącego odbiorcą.
• Do wykorzystania tylko raz.
• Rabat procentowy, liczony od kwoty brutto.
• Konfigurowalny okres ważności.

Wygenerowane kupony są widoczne w Promocje > Reguły koszyka.

Deinstalacja

Podczas deinstalacji moduł usuwa swoje dwie tabele, ustawienia i zakładkę administracyjną. Wygenerowane produkty próbkowe są wyłączane, a nie usuwane, aby historia dotychczasowych zamówień pozostała spójna. Możesz je usunąć ręcznie z katalogu, jeśli chcesz.

Rozwiązywanie problemów

Przycisk nie pojawia się na karcie produktu

Sprawdź, czy produkt jest zapisany do programu i aktywny w Katalog > Próbki (DF). Jeśli produkt jest aktywny, zmień ustawienie „Pozycja przycisku”: niektóre motywy nie renderują hooka displayProductActions.

Przypomnienia nie wychodzą

Sprawdź, czy zadanie cron jest zaplanowane i czy adres URL zawiera prawidłowy token. Wywołaj adres ręcznie w przeglądarce: moduł zwróci podsumowanie w formacie JSON. Sprawdź również, czy opcja przypomnień jest włączona i czy skonfigurowane opóźnienie faktycznie minęło od zamówień próbek.

Cena próbki nie jest taka, jakiej oczekiwano

Cenę wpisuje się brutto, a moduł przelicza ją na netto według stawki VAT produktu źródłowego. Jeśli produkt źródłowy nie ma przypisanej reguły podatkowej, cena netto jest równa cenie wpisanej.

Klient przekracza swoje limity

Limity na klienta obowiązują wyłącznie zidentyfikowanych klientów. Włącz ustawienie „Wymagane konto klienta”, aby stały się skuteczne.