Funkcje dla klienta sklepu
- Dobrowolne dodanie darowizny: klient sam zatwierdza wybraną kwotę przyciskiem formularza. Wyświetlenie kwoty domyślnej nie oznacza doliczenia jej do zakupów.
- Proponowane kwoty: przy włączonej własnej kwocie przyciski propozycji uzupełniają pole formularza. W trybie ograniczonym do propozycji klient wybiera wartość z listy.
- Własna kwota w ustalonym zakresie: sklep może pozwolić na wpisanie wartości pomiędzy ustawionym minimum i maksimum. Formularz pokazuje dozwolony zakres oraz walutę.
- Zmiana i usuwanie: przed złożeniem zamówienia klient może zastąpić bieżącą kwotę inną albo zrezygnować z darowizny.
- Jedna aktualna pozycja darowizny: zmiana kwoty aktualizuje darowiznę w danym koszyku zamiast dodawać kolejne egzemplarze. Kwota jednego koszyka nie ustala ceny darowizny w pozostałych koszykach.
- Obsługa osób niezalogowanych: formularz darowizny nie wymaga konta klienta. Samo złożenie zamówienia nadal podlega ustawieniom sklepu dotyczącym zakupów gościnnych i logowania.
- Kwota w walucie zakupów: klient widzi propozycje, limity i aktualną darowiznę w swojej walucie. Wartości uwzględniają jej precyzję oraz możliwości obliczeniowe używanej wersji sklepu.
- Informacja o niepoprawnej kwocie: moduł wyświetla komunikaty między innymi przy przekroczeniu limitów lub wpisaniu niedozwolonej wartości. Akceptuje przecinek albo kropkę jako separator dziesiętny.
Ustawienia kampanii i obsługa sklepu
- Włączanie i wyłączanie darowizn: administrator decyduje, czy udostępnić dodawanie i zmianę kwoty. Wyłączenie funkcji pozwala nadal usunąć darowiznę znajdującą się w otwartym koszyku.
- Minimum, maksimum i kwota domyślna: wszystkie te wartości ustawia się jako kwoty brutto w domyślnej walucie sklepu. Domyślna kwota musi mieścić się w wybranym zakresie.
- Do ośmiu propozycji: można skonfigurować maksymalnie osiem różnych dodatnich kwot, rozdzielonych średnikami, na przykład 5;10;20. Propozycje muszą mieścić się w limitach.
- Wybór sposobu podawania kwoty: dostępny jest tryb z własną kwotą oraz tryb ograniczony do propozycji. Przy wyłączonej własnej kwocie wartość domyślna musi znajdować się na liście propozycji.
- Nazwa darowizny w językach sklepu: administrator może ustawić nazwę widoczną w formularzu, koszyku i zamówieniu, do 128 znaków dla każdego języka.
- Komunikat kampanii: tekst do 500 znaków dla każdego języka pozwala przedstawić cel wsparcia lub beneficjenta. Pole przyjmuje zwykły tekst, bez znaczników HTML.
- Odnośnik do strony informacyjnej: formularz może prowadzić do wybranej aktywnej strony CMS danego sklepu, zawierającej szczegóły kampanii.
- Zdjęcie kampanii: można wgrać JPG, PNG lub GIF do 2 MB i 16 megapikseli. Obraz jest ponownie kodowany i proporcjonalnie zmniejszany do maksymalnie 400 pikseli na każdej osi, bez powiększania małych grafik.
- Miniatury pozycji darowizny: zdjęcie kampanii jest również kopiowane do obrazu produktu darowizny i jego miniatur według typów obrazów skonfigurowanych w PrestaShop.
- Formularz w podsumowaniu zamówienia: jego wyświetlanie można włączyć lub wyłączyć niezależnie od formularza w koszyku.
- Wybór grupy reguł podatkowych: domyślnie ustawiony jest brak podatku. Administrator może wybrać dostępną w sklepie grupę reguł odpowiednią dla prowadzonej kampanii.
- Osobne ustawienia w multistore: każdy sklep może mieć własną nazwę, treść kampanii, zdjęcie i zasady dotyczące kwot. Konfiguracja oraz raport wymagają wyboru pojedynczego sklepu.
- Panel z trzema zakładkami: Ustawienia, Raport darowizn i Pomoc porządkują konfigurację, zestawienia oraz objaśnienia działania modułu.
Raport darowizn w panelu PrestaShop
- Podsumowanie według waluty: raport przedstawia liczbę zamówień z darowiznami i sumę brutto ich pozycji, osobno dla każdej waluty. Do podsumowania trafiają zamówienia oznaczone przez PrestaShop jako poprawne.
- Ostatnie 50 zamówień z darowizną: lista pokazuje identyfikator i numer referencyjny zamówienia, datę, kwotę brutto, walutę oraz informację o uznaniu zamówienia za poprawne.
- Dane wybranego sklepu: raport odnosi się do sklepu wybranego w panelu, co pozwala przeglądać darowizny oddzielnie w instalacji multistore.
Raport korzysta z kwot pozycji zapisanych w zamówieniach. Nie odejmuje rabatów naliczanych na cały koszyk, zwrotów ani wypłat beneficjentom i nie stanowi raportu przelewów ani rozliczenia księgowego.
Jak przebiega dodanie darowizny do zamówienia?
- Klient dodaje do koszyka produkt spoza modułu darowizn.
- W formularzu wybiera proponowaną kwotę lub wpisuje własną, jeżeli sklep na to pozwala, i zatwierdza darowiznę.
- Darowizna pojawia się jako osobna pozycja koszyka. Przed zamówieniem klient może zmienić jej kwotę lub ją usunąć.
- Po złożeniu zamówienia kwota jest pobierana razem z zakupami przez wybraną metodę płatności sklepu. Moduł nie dodaje odrębnej bramki płatniczej.
Zasady działania, które warto znać
- Darowizna to dodatek do zakupów: aktualna darowizna wymaga innego produktu w koszyku. Usunięcie ostatniego takiego produktu usuwa również aktualną pozycję darowizny.
- Produkt wirtualny: moduł tworzy dla sklepu ukryty produkt darowizny, który nie zwiększa wagi przesyłki. Ostateczny koszt dostawy nadal wynika z reguł przewoźników i konfiguracji sklepu.
- Rabaty i podatki: rabat na cały koszyk może obniżyć wartość darowizny. Zmiana adresu, podatków lub reguł grupy klienta może wpłynąć na jej kwotę w otwartym koszyku; obowiązuje końcowa wartość wyliczona przez PrestaShop.
- Jeden zestaw ustawień kampanii na sklep: moduł nie udostępnia wyboru kilku beneficjentów w jednym formularzu ani cyklicznych darowizn abonamentowych.
- Przekazanie środków pozostaje poza modułem: kwota jest pobierana w ramach zamówienia sklepu. Moduł nie zleca przelewów na rzecz fundacji lub innych organizacji.
- Zachowanie historii: aktualizacja rozpoznaje produkty darowizn starszej wersji i zachowuje ich historię. Darowiznę dodaną przed aktualizacją trzeba usunąć z listy produktów koszyka przed wybraniem nowej kwoty przez formularz.
Zgodność i wymagania motywu
Moduł jest przeznaczony dla PrestaShop 1.7.x, 8.x i 9.x. Korzysta ze składni PHP od wersji 7.0, przy czym serwer musi spełniać także wymagania PHP używanej wersji PrestaShop. Dostarczone tłumaczenia interfejsu obejmują język polski i angielski, a nazwę oraz komunikat kampanii można zapisać w językach sklepu.
Formularz w koszyku korzysta z hooka displayShoppingCartFooter, a formularz w podsumowaniu zamówienia z displayCheckoutSummaryTop. Niestandardowy motyw lub zewnętrzny moduł składania zamówień musi udostępniać te miejsca wyświetlania.