Pakowanie na Prezent i Wiadomość, kompletny przewodnik
Instalacja, konfiguracja i codzienna obsługa płatnego pakowania na prezent oraz spersonalizowanej kartki z wiadomością przy kasie, dla PrestaShop 8 i 9.
Wprowadzenie
Moduł Pakowanie na Prezent i Wiadomość (dfgiftwrap) dodaje w procesie zamówienia wybór płatnego pakowania na prezent oraz spersonalizowanej kartki z wiadomością. Klient wybiera ilustrowaną opcję pakowania, może dołączyć dowolną wiadomość, a odpowiednie opłaty czysto wchodzą do sumy zamówienia. VAT, walutę i multistore obsługuje rdzeń PrestaShop, aż do faktury.
Opłaty nie są zwykłym elementem wyświetlania: niesie je dedykowany produkt-opłata i cena specyficzna ograniczona do koszyka klienta. Kwota trafia więc naturalnie do sum, zamówienia i faktury, z prawidłowym VAT.
Kompatybilność
- PrestaShop 8.0 do 9.x
- Pojedynczy sklep i multistore
- PHP 7.4 do 8.3
- Motyw Classic i motywy własne
- Interfejs dostarczony po francusku, w pełni tłumaczalny
- Bez zależności (ani Composer, ani framework)
Instalacja
- W back office otwórz Moduły > Menedżer modułów.
- Kliknij Wgraj moduł i wskaż plik
dfgiftwrap.zip. - Po instalacji kliknij Konfiguruj.
Podczas instalacji moduł tworzy swoje tabele, rejestruje hooki (zasoby front, blok przy kasie, zatwierdzenie zamówienia, karta zamówienia w back office, potwierdzenie) i generuje ukryty produkt-opłatę (referencja DF-GIFTWRAP-FEE): wirtualny, niewidoczny w sklepie, z nieujawnianą ceną. To on niesie kwotę za pakowanie i kartkę w koszyku. Nie usuwaj go ręcznie.
Konfiguracja
Ustawienia ogólne
- Włącz pakowanie na prezent: pokazuje lub ukrywa blok opcji pakowania przy kasie.
- Włącz kartkę z wiadomością: pokazuje lub ukrywa opcję kartki i wiadomości.
- Cena kartki: kwota (netto) doliczana, gdy klient dodaje kartkę z wiadomością.
- Maksymalna długość wiadomości: liczba dozwolonych znaków (domyślnie 200). Podczas pisania klientowi towarzyszy licznik.
- Grupa reguł podatkowych: grupa VAT stosowana do opłat za pakowanie i kartkę.
Zarządzanie opcjami pakowania
Na stronie konfiguracji kliknij przycisk zarządzania opcjami, aby otworzyć dedykowany ekran (kontroler AdminDfGiftWrapOptions). Tworzysz tam dowolną liczbę opcji, każdą z:
- Nazwą: wielojęzyczna etykieta opcji (na przykład elegancki papier kraft, pudełko prezentowe premium).
- Ceną: kwota netto opcji pakowania.
- Zdjęciem: wizualizacja opcji (automatycznie normalizowana do formatu JPG).
- Pozycją: kolejność wyświetlania, zmieniana metodą przeciągnij i upuść.
- Statusem aktywności: pokazuje lub ukrywa opcję w sklepie bez jej usuwania.
Nazwa jest polem wielojęzycznym: wybierz język w selektorze pola, aby przetłumaczyć etykietę opcji.
Działanie
Przy kasie
Blok pakowania i kartki jest wstawiany na górze podsumowania zamówienia przez hook displayCheckoutSummaryTop. Klient wybiera opcję pakowania, ewentualnie włącza kartkę i wpisuje wiadomość. Wybór jest zapisywany przez Ajax. Ponieważ wpływa on na kwotę, suma jest odświeżana, aby uwzględnić opłaty; sama wiadomość zapisuje się bez zbędnego przeładowania.
Mechanizm opłat
Przy każdym wyborze moduł oblicza łączną kwotę (opcja pakowania plus kartka) i tworzy cenę specyficzną (SpecificPrice) ograniczoną do bieżącego koszyka, stosowaną do ukrytego produktu-opłaty. Produkt trafia do koszyka, gdy kwota jest większa od zera, a w przeciwnym razie zostaje z niego usunięty. PrestaShop stosuje wtedy VAT, walutę i kontekst multistore, a opłata pojawia się jako zwykła pozycja w sumach, zamówieniu i na fakturze.
Gdzie pojawia się wiadomość
Przy zatwierdzeniu zamówienia (actionValidateOrder) wybór zostaje utrwalony. Wiadomość wpisana przez klienta jest widoczna w trzech miejscach:
- na karcie zamówienia w back office (dedykowany blok przez
displayAdminOrderMain); - na stronie potwierdzenia wyświetlanej klientowi po zakupie;
- w natywnym polu prezentu zamówienia (
gift_message, zgift = 1), dzięki czemu pojawia się w standardowych e-mailach PrestaShop.
Ponieważ wiadomość jest zapisywana także w natywnym polu prezentu, Twoje szablony e-maili i narzędzia do kompletacji, które już korzystają z tego pola, wyświetlą tekst klienta bez dodatkowej konfiguracji.
FAQ i rozwiązywanie problemów
Czy to karta podarunkowa lub bon zakupowy?
Nie. Moduł obsługuje usługę pakowania na prezent i kartkę z wiadomością, a nie metodę płatności ani bon zakupowy. Klient płaci za pakowanie i może dołączyć dedykację.
Opłata nie pojawia się w sumie
Sprawdź, czy ukryty produkt-opłata (DF-GIFTWRAP-FEE) nadal istnieje i czy co najmniej jedna opcja pakowania jest aktywna. Wyczyść pamięć podręczną PrestaShop, a następnie odśwież stronę zamówienia. Opłata jest naliczana tylko wtedy, gdy obliczona kwota przekracza zero.
Strona główna lub sklep staje się biała po instalacji
Upewnij się, że używasz najnowszej wersji modułu, i wyczyść pamięć podręczną. Produkt-opłata celowo pozostaje niewidoczny w sklepie; nie udostępniaj go ani nie usuwaj ręcznie.
Wiadomość jest ucięta
Wiadomość jest ograniczona ustawieniem Maksymalna długość wiadomości. Zwiększ tę wartość w konfiguracji, jeśli Twoi klienci potrzebują dłuższych tekstów.
Jak dodać angielski, hiszpański, niemiecki lub włoski?
Interfejs jest dostarczony po francusku i w pełni tłumaczalny. Przejdź do Ustawienia zaawansowane > Tłumaczenia > Tłumaczenia zainstalowanych modułów, wybierz dfgiftwrap oraz język, a następnie przetłumacz teksty. Nazwy opcji pakowania tłumaczy się bezpośrednio w ich polu wielojęzycznym.
Czy moduł jest kompatybilny z PrestaShop 9?
Tak. Moduł został zaprojektowany i przetestowany od PrestaShop 8.0 do 9.x, z kontrolerem administracyjnym legacy, w pojedynczym sklepie oraz w multistore.