Zaokrąglenie Charytatywne i Darowizna przy Kasie

Prezentacja

Moduł Zaokrąglenie Charytatywne i Darowizna przy Kasie (dfsolidarityround) pozwala Twoim klientom wesprzeć organizację charytatywną w kilka sekund, bezpośrednio w koszyku: przez zaokrąglenie zamówienia do pełnego euro, wybór predefiniowanej kwoty darowizny lub wpisanie kwoty dowolnej. Darowizna jest czysto integrowana z sumą zamówienia: VAT, waluta i multisklep są obsługiwane przez rdzeń PrestaShop, aż do faktury.

Zgodność

• PrestaShop 8.0 do 9.x
• Jeden sklep i multisklep
• PHP 7.4 do 8.3
• Motyw Classic i motywy własne
• Interfejs dostarczany po francusku, angielsku, hiszpańsku, niemiecku i włosku
• Brak zależności (bez Composera i bez frameworka)

Instalacja

1. W zapleczu otwórz Moduły > Menedżer modułów.
2. Kliknij Zainstaluj moduł, a następnie wybierz plik dfsolidarityround.zip.
3. Po instalacji kliknij Konfiguruj.

Konfiguracja

Tryby darowizny

Dostępne są trzy tryby, aktywowane niezależnie. Możesz zaproponować tylko jeden albo wszystkie trzy naraz.

• Zaokrąglenie do pełnego euro: proponuje klientowi podniesienie zamówienia do najbliższej okrągłej kwoty. Krok zaokrąglenia jest konfigurowalny (1,00 dla pełnego euro, 0,50 dla pół euro itd.).
• Kwoty stałe: wyświetla gotowe do kliknięcia przyciski. Lista kwot jest konfigurowalna (na przykład 1;2;5).
• Kwota dowolna: pozwala klientowi wpisać wybraną sumę, ograniczoną przez darowiznę minimalną i darowiznę maksymalną.

Personalizacja organizacji

• Tytuł bloku: nagłówek wyświetlany na górze bloku (pole wielojęzyczne).
• Nazwa organizacji: nazwa wspieranej sprawy (pole wielojęzyczne).
• Opis: krótki tekst towarzyszący (pole wielojęzyczne).
• Logo organizacji: grafika wyświetlana w bloku (PNG, JPG, GIF, WEBP lub SVG).

Miejsca wyświetlania

• Wyświetl na stronie Koszyk: pokazuje blok na dole strony koszyka (miejsce główne i niezawodne).
• Wyświetl w ścieżce zamówienia: pokazuje blok w podsumowaniu zamówienia, jeśli Twój motyw udostępnia odpowiedni punkt zaczepienia.

Działanie po stronie klienta

Zaokrąglenie do pełnego euro

Klient widzi przycisk w rodzaju „Zaokrąglij i przekaż 0,73 €”. Proponowana kwota odpowiada różnicy między jego sumą a najbliższą okrągłą kwotą, zgodnie ze skonfigurowanym krokiem.

Kwoty stałe

Klient klika jedną z proponowanych kwot (1 €, 2 €, 5 €…). Odpowiadająca darowizna jest dodawana natychmiast.

Kwota dowolna

Klient wpisuje wybraną kwotę i zatwierdza. Wartość jest kontrolowana względem zdefiniowanego minimum i maksimum.

Jak darowizna jest dodawana do koszyka

Przy każdym wyborze moduł tworzy cenę specyficzną (SpecificPrice) ograniczoną do bieżącego koszyka (id_cart) i stosuje ją do produktu wirtualnego „Darowizna charytatywna”. Produkt jest dodawany do koszyka, gdy kwota jest większa od zera, a usuwany w przeciwnym razie. PrestaShop stosuje wtedy walutę i kontekst multisklepu, a darowizna pojawia się jako czytelna pozycja w sumach, zamówieniu i na fakturze.

Automatyczne przeliczanie zaokrąglenia

W trybie zaokrąglenia kwota darowizny jest przeliczana przy każdym wyświetleniu bloku. Jeśli klient zmieni koszyk po wybraniu zaokrąglenia, darowizna pozostaje spójna z nową sumą aż do płatności.

Darowizna bez VAT

Produkt „Darowizna charytatywna” jest tworzony bez reguły podatkowej: kwota wyświetlana i zbierana odpowiada dokładnie gestowi klienta, bez niespodzianek z VAT.

Śledzenie darowizn w zapleczu

Pod menu Zamówienia dodawana jest zakładka Darowizny charytatywne (kontroler AdminDfDonations). Wymienia ona każdą darowiznę wraz z:

• kwotą darowizny;
• użytym trybem (zaokrąglenie, kwota stała lub kwota dowolna);
• klientem i powiązanym zamówieniem;
• datą darowizny.

Pasek podsumowania pokazuje sumę zebraną i liczbę darowizn. Darowizna jest utrwalana w historii przy zatwierdzeniu zamówienia (actionValidateOrder).

Przekazanie środków organizacji

Zgodność z PrestaShop 9

Moduł jest zaprojektowany i testowany od PrestaShop 8.0 do 9.x:

• kontroler zaplecza używa ModuleAdminController, zgodnego z 8 i 9;
• kod unika metod usuniętych w PrestaShop 9 (przenośny token AJAX i przenośne formatowanie cen);
• kontroler AJAX zwraca bezpośrednio JSON, bez nadpisywania niekompatybilnej sygnatury.

FAQ i rozwiązywanie problemów

Blok nie wyświetla się w ścieżce zamówienia

Blok wyświetla się niezawodnie na dole strony koszyka. W podsumowaniu zamówienia wyświetlanie zależy od motywu, który musi udostępniać odpowiedni punkt zaczepienia. Darowizna wybrana na stronie koszyka jest w każdym przypadku zachowana aż do płatności.

Suma nie aktualizuje się po kliknięciu

Blok wywołuje odświeżenie koszyka po dodaniu lub usunięciu darowizny. Wyczyść pamięć podręczną PrestaShop, a następnie przeładuj stronę. Sprawdź też, czy produkt „Darowizna charytatywna” nie został usunięty ręcznie.

Sklep robi się biały po instalacji

Upewnij się, że używasz najnowszej wersji modułu, i wyczyść pamięć podręczną. Produkt darowizny jest celowo niewidoczny w sklepie; nie ustawiaj go jako widocznego i nie usuwaj go ręcznie.

Kwota zaokrąglenia wydaje się nieprawidłowa

Sprawdź skonfigurowany krok zaokrąglenia. W trybie zaokrąglenia darowizna jest przeliczana przy każdym wyświetleniu bloku na podstawie sumy bez darowizny; jeśli koszyk się zmieni, kwota jest dopasowywana automatycznie.

Jak przetłumaczyć blok na inny język?

Tytuł, nazwa organizacji i opis to pola wielojęzyczne: wybierz każdy język w konfiguracji, aby je przetłumaczyć. Etykiety interfejsu tłumaczy się przez Zaawansowane > Tłumaczenia > Tłumaczenia zainstalowanych modułów, wybierając dfsolidarityround.

Czy moduł jest zgodny z PrestaShop 9?

Tak. Moduł jest zaprojektowany i testowany od PrestaShop 8.0 do 9.x, zarówno w jednym sklepie, jak i w multisklepie.

Odinstalowanie

Odinstalowanie usuwa produkt „Darowizna charytatywna”, zakładkę zaplecza i tabelę historii darowizn. Jeśli chcesz zachować historię, dezaktywuj moduł bez odinstalowywania.