1. Do czego służy moduł
Moduł dodaje w koszyku, a opcjonalnie także w podsumowaniu na stronie zamówienia, przycisk Zapisz koszyk jako PDF, gdy tylko koszyk nie jest pusty. Klient dostaje podsumowanie koszyka do wydruku: produkty ze zdjęciami, kombinacjami i cenami, kody rabatowe, dostawę, podatek i sumy dokładnie tak, jak pokazuje je koszyk, a gdy już je poda — adresy, przewoźnika i wiadomość do zamówienia oraz sekcję płatności z Twoim tekstem i metodami płatności dostępnymi dla tego koszyka. Firmy dołączają taki dokument do wniosku o zakup, inni klienci zachowują go, żeby dokończyć zakupy później. W konfiguracji decydujesz, co znajdzie się w pliku. W panelu administracyjnym ten sam PDF otworzysz dla ostatnich koszyków klienta, na stronie klienta.
Działa z PrestaShop 1.7.8, 8.x i 9.x (PHP 7.2.5 lub nowszy), z szablonami Classic i Hummingbird oraz w trybie multistore.
2. Instalacja
- Pobierz moduł z Moje konto → Historia zamówień w addonspresta.com.
- W panelu administracyjnym otwórz Moduły → Menedżer modułów i kliknij Załaduj moduł.
- Upuść plik
ap_cartpdf_v1.0.0.zipi poczekaj na potwierdzenie. - Kliknij Konfiguruj na karcie modułu.
Zaraz po instalacji przycisk pojawia się w koszyku z ustawieniami domyślnymi.
3. Jak to działa
Plik PDF powstaje w chwili kliknięcia, z aktualnego koszyka. Pozycje i sumy liczy sam PrestaShop, więc zawsze zgadzają się z koszykiem: z cenami specyficznymi, regułami cenowymi katalogu, rabatami grup i kodami rabatowymi, brutto albo netto tak, jak grupa klienta widzi ceny, w języku i walucie koszyka. Sekcja podatku dodaje sumę netto i brutto.
Wydrukować można tylko własny koszyk odwiedzającego: adres PDF nie zawiera numeru koszyka, koszyk pochodzi z sesji odwiedzającego. Gdy ukryjesz przycisk (grupy klientów, tylko zalogowani, minimalna wartość), przestaje działać także adres PDF, a w trybie katalogowym nie ma ani przycisku, ani PDF. PDF wypisuje do 150 produktów, ze zdjęciami dla pierwszych 50; przy większym koszyku pod listą pojawia się uwaga, a sumy nadal obejmują cały koszyk.
Koszyk nie ma jeszcze metody płatności — klient wybiera ją w ostatnim kroku zamówienia. Sekcja płatności pokazuje więc Twój tekst (np. dane do przelewu) i moduły płatności dozwolone dla kraju, grupy klientów i waluty koszyka w Płatność → Preferencje. Własne warunki modułu płatności, np. limit kwoty, mogą go jeszcze ukryć w trakcie zamówienia.
Adresy, przewoźnik i wiadomość pojawiają się, gdy klient poda je w trakcie zamówienia; imię i nazwisko, adresy i wiadomość — tylko gdy klient jest zalogowany (albo zamawia jako gość). Pliki PDF nie są zapisywane na serwerze, a moduł nie łączy się z addonspresta.com ani z żadnym innym serwerem.
4. Funkcje i ustawienia
Otwórz Moduły → Menedżer modułów → Koszyk do PDF → Konfiguruj. Ramka Pomoc na górze prowadzi do tej instrukcji i do strony modułu na addonspresta.com, w języku Twojego panelu.
Przycisk w koszyku
- Włącz PDF koszyka — po wyłączeniu przycisk znika, a adres PDF przestaje działać. Panel w zapleczu sklepu działa nadal.
- Położenie przycisku w koszyku — pod przyciskiem „Przejdź do realizacji zamówienia”, pod listą produktów albo nad podsumowaniem koszyka. Dokładne miejsce zależy od szablonu.
- Przycisk w podsumowaniu na stronie zamówienia — ten sam przycisk przy podsumowaniu w trakcie zamówienia, gdzie PDF może już pokazać adresy, przewoźnika i wiadomość.
- Napis na przycisku — tekst w każdym języku, do 64 znaków. Puste pole oznacza napis domyślny.
- Otwieranie PDF — pobranie pliku albo otwarcie w nowej karcie przeglądarki.
- Grupy klientów — przycisk widzą tylko klienci z zaznaczonych grup. Niezalogowani odwiedzający należą do grupy „Odwiedzający”.
- Tylko dla zalogowanych klientów — ukrywa przycisk przed niezalogowanymi.
- Minimalna wartość koszyka — brutto, w domyślnej walucie sklepu; 0 pokazuje przycisk przy każdym niepustym koszyku.
Zawartość PDF
Każdy przełącznik dodaje jedną część pliku: zdjęcia produktów (w wybranym rozmiarze), indeks, atrybuty kombinacji, personalizacje wpisane przez klienta, cenę jednostkową, dostępność każdego produktu, kody rabatowe i rabaty, koszt dostawy i przewoźnika, sumę netto, podatek i sumę brutto, adresy dostawy i faktury, wiadomość klienta, dostępne metody płatności, kod QR z adresem sklepu i datę wygenerowania.
Wygląd
- Format papieru — A4 albo Letter.
- Kolor akcentu — kolor w zapisie szesnastkowym, np.
#333333: linie, nagłówki i nagłówek tabeli. - Logo sklepu w nagłówku — logo faktury, a gdy go nie ma, logo sklepu.
- Dane sklepu w nagłówku — nazwa, adres, telefon i e-mail z Preferencje → Kontakt → Sklepy.
- Numery stron w stopce.
Teksty
Dla każdego języka: tytuł dokumentu (domyślnie „Twój koszyk”), tekst nad produktami, informacje o płatności (np. numer
konta), uwaga pod sumami (domyślnie „Ceny i dostępność aktualne na dzień {date}. Dokument nie jest zamówieniem.”)
i stopka. To zwykły tekst; {shop_name}, {shop_url}, {date} i {customer_name} są zastępowane danymi sklepu
i klienta.
PDF w panelu administracyjnym
Na stronie klienta w Klienci → Klienci panel Koszyki w PDF pokazuje 10 ostatnich niepustych koszyków klienta z datą, liczbą produktów, sklepem i zamówieniem złożonym z koszyka. Link PDF otwiera koszyk w jego języku i walucie, niezależnie od ustawień przycisku. Panel widzą tylko pracownicy, których profil ma uprawnienie „Wyświetlanie” do modułu i dostęp do Klienci; uprawnienie do modułu nadasz w Zaawansowane → Zespół → Uprawnienia.
5. Multistore
Ustawienia zapisują się dla sklepu albo grupy sklepów wybranej w nagłówku panelu. Wybierz Wszystkie sklepy, żeby ustawić te same wartości wszędzie, albo jeden sklep, żeby dać mu własny przycisk, zawartość i teksty. W kontekście wszystkich sklepów lub grupy zapisać może tylko pracownik, który zarządza każdym z nich. Koszyk zawsze drukuje się z ustawieniami, logo i danymi swojego sklepu; panel w zapleczu pokazuje tylko koszyki sklepów, którymi pracownik zarządza. Jedna licencja obejmuje wszystkie sklepy instalacji.
6. Odinstalowanie
Menedżer modułów → Koszyk do PDF → Odinstaluj usuwa ustawienia modułu i jego ukrytą stronę w panelu. Żeby zachować ustawienia, wybierz zamiast tego Wyłącz.
7. Najczęstsze pytania i problemy
Przycisk się nie pokazuje. Sprawdź, czy włączona jest opcja Włącz PDF koszyka, czy koszyk nie jest pusty i osiąga minimalną wartość, czy grupa odwiedzającego jest zaznaczona w Grupy klientów i czy szablon wyświetla wybrane położenie. Wybierz Pod przyciskiem „Przejdź do realizacji zamówienia”, a potem wyczyść pamięć podręczną w Zaawansowane → Wydajność.
PDF pokazuje ceny netto. PDF trzyma się koszyka: grupa klienta widzi ceny netto (Klienci → Grupy). Włącz Suma netto, podatek i suma brutto, żeby wydrukować obie sumy.
W PDF brakuje jakiejś metody płatności. Sprawdź jej ograniczenia krajów, grup i walut w Płatność → Preferencje. Lista nie zna własnych warunków modułu płatności, np. limitu kwoty.
W PDF nie ma adresów ani przewoźnika. Pojawiają się, gdy klient poda je w trakcie zamówienia. Przycisk w podsumowaniu na stronie zamówienia je drukuje.
Czy mogę zmienić układ PDF?
Tak. Skopiuj views/templates/pdf/cart.tpl (oraz header.tpl i footer.tpl) do
themes/<twój-szablon>/modules/ap_cartpdf/views/templates/pdf/ i edytuj kopie. Programista może też dodać dane przez
hook actionApCartpdfData opisany w README.md.
Tekst jest po angielsku w polskim sklepie. Uzupełnij napis na przycisku i teksty dla tego języka w konfiguracji modułu. Pozostałe sformułowania zmienisz w Międzynarodowy → Tłumaczenia → Tłumaczenia zainstalowanych modułów.
8. Aktualizacje i wsparcie
Aktualizacje są bezpłatne dożywotnio: nowe wersje pobierasz z Moje konto → Historia zamówień w addonspresta.com i wgrywasz tak samo jak nowy moduł. Ustawienia zostają zachowane.
Wsparcie obejmuje 12 miesięcy od zamówienia: napisz na mail@addonspresta.com albo przez formularz kontaktowy na 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.