Karta produktu PDF – instrukcja obsługi modułu PrestaShop

1. Do czego służy moduł

Moduł dodaje na stronie produktu przycisk Pobierz kartę PDF. Jedno kliknięcie i klient dostaje przejrzystą kartę produktu do wydruku: nazwę, zdjęcia, cenę, dostępność, cechy, warianty i inne dane, w swoim języku i walucie, dla wybranej kombinacji. W konfiguracji decydujesz, co znajdzie się w pliku i jak będzie wyglądał. Na stronie produktu w panelu administracyjnym możesz też wygenerować taką kartę dla klienta w dowolnym języku, walucie i dla dowolnej grupy klientów.

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

1. Pobierz moduł z Moje konto → Historia zamówień w addonspresta.com.
2. W panelu administracyjnym otwórz Moduły → Menedżer modułów i kliknij Załaduj moduł.
3. Upuść plik ap_productpdf_v1.0.0.zip i poczekaj na potwierdzenie.
4. Kliknij Konfiguruj na karcie modułu.

Zaraz po instalacji przycisk pojawia się na stronach produktów z ustawieniami domyślnymi.

3. Jak to działa

Plik PDF powstaje w chwili kliknięcia, z aktualnych danych produktu. Ceny liczy sam PrestaShop dla danego klienta: z cenami specyficznymi, regułami cenowymi katalogu i rabatami grup, w walucie odwiedzającego i z podatkiem właściwym dla jego adresu. Gdy klient zmieni kombinację na stronie produktu, przycisk zmienia się razem z nią: PDF pokazuje wybrany wariant, jego zdjęcia, indeks i cenę.

PDF nigdy nie powstaje dla produktu, którego sklep nie pokazuje danemu odwiedzającemu: nieaktywnego, z innego sklepu, ukrytego wszędzie albo z kategorii zamkniętej dla jego grupy. Tak samo, gdy ukryjesz przycisk dla grupy, kategorii lub produktu: przestaje działać również link do PDF.

Żeby oszczędzać serwer, PDF wygenerowany dla niezalogowanego odwiedzającego jest przechowywany przez 60 minut (czas możesz zmienić); zalogowani klienci, którzy mogą mieć własne ceny, zawsze dostają świeży plik. Zapis ustawień albo edycja produktu od razu tworzy nowy plik. PDF rysuje biblioteka TCPDF wbudowana w PrestaShop. Moduł nie zmienia tabel PrestaShop i nie łączy się z addonspresta.com ani z żadnym innym serwerem; zdjęcia i linki z opisu produktu nie trafiają do pliku.

Ceny w trybie katalogu. PDF pokazuje ceny zgodnie z ustawieniami modułu, także w trybie katalogu, dla grup klientów, które nie widzą cen, i dla produktów z ukrytą ceną. Jeśli sklep celowo ukrywa ceny (na przykład przed zalogowaniem klientów B2B), włącz Ukryj ceny, gdy sklep je ukrywa.

4. Funkcje i ustawienia

Otwórz Moduły → Menedżer modułów → Karta produktu 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 na karcie produktu

• Włącz kartę PDF — po wyłączeniu przycisk znika, a linki do PDF przestają działać. Panel w zapleczu sklepu działa nadal.
• Położenie przycisku — pod przyciskiem „Dodaj do koszyka”, obok niego albo w bloku z zapewnieniami (reassurance). Dokładne miejsce zależy od szablonu.
• 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.
• Ukryj w kategoriach — produkty z którejkolwiek zaznaczonej kategorii nie mają przycisku.
• Ukryj dla produktów — identyfikatory produktów oddzielone przecinkami, maksymalnie 500.

Zawartość PDF

Każdy przełącznik dodaje jedną część karty: nazwę produktu, indeks, kody EAN-13 / UPC / ISBN / MPN, markę, kategorię domyślną, krótki opis, opis, cenę, cenę regularną i rabat, cenę jednostkową, dostępność i czas dostawy, stan magazynowy, atrybuty wybranej kombinacji, tabelę wszystkich kombinacji, cechy, wagę i wymiary, nazwy załączonych dokumentów, link do strony produktu, kod QR i kod kreskowy EAN-13.

• Zdjęcia — bez zdjęć, tylko zdjęcie główne, zdjęcie główne z miniaturami albo wszystkie zdjęcia w siatce. Najpierw idą zdjęcia wybranej kombinacji. Maksymalna liczba zdjęć ogranicza ich liczbę (od 1 do 12), a Rozmiar zdjęć wybiera jeden z typów zdjęć produktów w sklepie: większe są ostrzejsze, ale plik jest cięższy.
• Cena — tak, jak grupa klienta widzi ceny (brutto albo netto), brutto, netto, obie albo bez cen.
• Ukryj ceny, gdy sklep je ukrywa — patrz „Jak to działa”.
• Stan magazynowy — drukowany tylko przy włączonym zarządzaniu stanami magazynowymi.
• Tabela wszystkich kombinacji — wiersz dla każdej kombinacji z zaznaczonymi kolumnami (indeks, EAN-13, cena, ilość, dostępność), do ustawionego limitu (od 1 do 500).
• Kod kreskowy EAN-13 — drukowany tylko wtedy, gdy produkt albo kombinacja ma poprawny kod EAN-13.
• Opis — nagłówki, listy, pogrubienia i tabele zostają zachowane.

Wygląd

• Format papieru — A4 albo Letter.
• Kolor akcentu — kolor w zapisie szesnastkowym, np. #333333: linia pod tytułem, nagłówki sekcji 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 i Data wygenerowania w stopce.

Teksty

Trzy teksty dla każdego języka: nad produktem (do 300 znaków), uwaga pod produktem (do 1000) i stopka (do 300). To zwykły tekst; {shop_name}, {shop_url}, {date}, {product_name} i {reference} są zastępowane danymi sklepu i produktu. Domyślna uwaga brzmi: „Ceny i dostępność aktualne na dzień {date}. Dokument nie stanowi oferty handlowej.”

Pamięć podręczna

Przechowuj wygenerowane PDF przez (minuty) — od 0 do 10080 (tydzień); 0 oznacza tworzenie każdego pliku od nowa. Wyczyść pamięć podręczną PDF od razu usuwa zapisane pliki, na przykład po zmianie cen regułą cenową katalogu. Przeterminowane pliki są usuwane automatycznie. Strona konfiguracji ostrzega, gdy pamięć podręczna jest wyłączona i gdy sklep ukrywa ceny, a PDF je pokazuje.

PDF w panelu administracyjnym

Na stronie produktu w panelu otwórz zakładkę Moduły i wybierz Karta produktu PDF. Wybierz język, walutę, grupę klientów, której ceny ma pokazać karta, oraz kombinację i kliknij Generuj PDF. Plik otworzy się w nowej karcie; wyślij go klientowi jak każdy inny załącznik. Ustawienia przycisku (grupy, kategorie, produkty, włączenie) tutaj nie obowiązują. Panel widzą tylko pracownicy, których profil ma uprawnienie „Wyświetlanie” do modułu i dostęp do Katalog → Produkty; 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. PDF każdego sklepu korzysta z jego produktów, cen, stanów, zdjęć, logo i danych kontaktowych. W panelu PDF powstaje dla sklepu wybranego w nagłówku, a w kontekście wszystkich sklepów — dla sklepu domyślnego produktu. Jedna licencja obejmuje wszystkie sklepy instalacji.

6. Odinstalowanie

Menedżer modułów → Karta produktu PDF → Odinstaluj usuwa ustawienia modułu, jego ukrytą stronę w panelu i zapisane pliki PDF. Ż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 kartę PDF, czy grupa odwiedzającego jest zaznaczona w Grupy klientów, czy produkt i jego kategorie nie są ukryte i czy szablon wyświetla wybrane położenie. Wybierz Pod przyciskiem „Dodaj do koszyka”, a potem wyczyść pamięć podręczną w Zaawansowane → Wydajność.

PDF pokazuje starą cenę. Cena zmieniona przez cenę specyficzną z datami albo regułę cenową katalogu pojawi się, gdy wygaśnie zapisany plik. Kliknij Wyczyść pamięć podręczną PDF albo skróć czas przechowywania.

W PDF nie ma kodu QR ani kodu kreskowego. Serwer potrzebuje rozszerzenia PHP GD lub Imagick; strona konfiguracji ostrzega, gdy brakuje obu. Kod kreskowy wymaga też poprawnego kodu EAN-13.

Brakuje zdjęcia albo filmu z opisu. To celowe: PDF zawiera tylko tekst opisu, jego formatowanie i tabele.

Czy mogę zmienić układ PDF? Tak. Skopiuj views/templates/pdf/sheet.tpl (oraz header.tpl i footer.tpl) do themes/<twój-szablon>/modules/ap_productpdf/views/templates/pdf/ i edytuj kopie. Programista może też dodać dane przez hook actionApProductpdfData 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.

Wróć do: Instrukcje modułów