Karty podarunkowe – instrukcja obsługi modułu PrestaShop

1. Do czego służy moduł

Karty podarunkowe pozwalają sprzedawać karty podarunkowe w sklepie PrestaShop bez drugiego systemu kodów obok tego, który już masz. Sam wskazujesz, które produkty są kartami. Gdy zamówienie z takim produktem zostanie opłacone, każda kupiona sztuka staje się natywnym kodem rabatowym PrestaShop o wartości ceny produktu. Karta cyfrowa trafia do kupującego e-mailem jako PDF gotowy do wydruku albo przesłania dalej; kartę fizyczną drukujesz ze strony zamówienia i wysyłasz w paczce. Posiadacz płaci kartą, wpisując jej kod w koszyku tak samo, jak każdy kod rabatowy, a częściowe wykorzystanie, datę ważności i waluty obsługuje sam PrestaShop.

Działa z PrestaShop 1.7.8, 8.x i 9.x (PHP 7.2.5 lub nowszy), z motywami Classic i Hummingbird oraz w trybie multistore.

2. Instalacja

1. Pobierz plik ap_giftcard_v1.0.0.zip 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 zip i poczekaj na potwierdzenie.
4. Kliknij Konfiguruj, sprawdź statusy zamówienia, ważność i tekst o korzystaniu z karty, a następnie zapisz.
5. W sekcji Produkty kart podarunkowych na tej samej stronie znajdź produkty, które sprzedajesz jako karty, i dodaj je.

Zaraz po instalacji moduł wystawia karty przy statusach Płatność zaakceptowana i Płatność przyjęta, ważne 365 dni, z kodami zaczynającymi się od GC. Dopóki nie dodasz pierwszego produktu karty podarunkowej, nic nie jest wystawiane.

3. Jak to działa

Produkt karty podarunkowej. Karta podarunkowa to zwykły produkt z Twojego katalogu, który został dodany do listy na stronie konfiguracji. Jego cena to wartość karty. Stan magazynowy, zdjęcia, kategorie, kombinacje i pola personalizacji pozostają zwykłymi ustawieniami produktu, więc karta w kilku kwotach albo wzorach to po prostu produkt z kombinacjami.

Cyfrowa czy fizyczna. Decyduje typ produktu. Produkt wirtualny to karta cyfrowa: zamówienie zawierające same produkty wirtualne nie wymaga dostawy, a kupujący dostaje kartę e-mailem. Każdy inny produkt to karta fizyczna: zamówienie przechodzi przez zwykłą dostawę, a Ty drukujesz kartę i wkładasz ją do paczki.

Wystawianie. Gdy zamówienie otrzyma jeden z wybranych statusów, każda kupiona sztuka produktu karty podarunkowej staje się jedną kartą: trzy sztuki karty za 100 zł to trzy karty z trzema kodami, więc każdą można podarować komuś innemu. Jedna sztuka nigdy nie dostaje drugiej karty, cokolwiek stanie się później z zamówieniem. Kod wygląda tak: GC-7KQM-X2RD-9HTP — Twój prefiks i dwanaście losowych znaków, z pominięciem znaków łatwych do pomylenia, takich jak 0 i O.

Wartość. Karta jest warta tyle, ile wynosi cena produktu albo kupionej kombinacji, z podatkiem, w walucie zamówienia. Rabaty przy zakupie jej nie obniżają: karta za 100 zł kupiona w promocji −20% albo z kodem rabatowym nadal jest warta 100 zł. Obniżają ją dwa ustawienia cen, ponieważ zastępują samą cenę: cena specjalna ze stałą ceną i rabat grupy klientów.

Jeden wyjątek chroni przed pomnażaniem promocji: gdy zamówienie jest opłacone, choćby w części, kartą podarunkową, każda kupiona w nim karta jest warta tyle, ile faktycznie za nią zapłacono — jej cena po obniżkach, pomniejszona o przypadającą na nią część pozostałych kodów rabatowych zamówienia — i nigdy więcej niż cena produktu. Karta za 100 zł przeceniona na 80 zł i opłacona inną kartą podarunkową jest warta 80 zł.

Karta jako kod rabatowy. Każda karta to reguła koszyka w Katalog → Rabaty o nazwie „Karta podarunkowa”: kwota z podatkiem, ważna do końca ostatniego dnia ważności, do jednorazowego użycia, z częściowym wykorzystaniem, dla dowolnej osoby znającej kod — zalogowanej albo gościa. W multistore działa wyłącznie tam, gdzie złożono zamówienie.

E-mail. Za karty cyfrowe kupujący dostaje jeden e-mail z osobnym plikiem PDF dla każdej karty, więc każdą można przesłać dalej oddzielnie. E-mail trafia na adres z zamówienia, także zamówienia gościa, w języku zamówienia (angielski, polski albo francuski; dla innych języków angielski). Karty fizyczne nie wysyłają e-maila.

Karta PDF. Jedna strona A4 z logo Twojego sklepu, zdjęciem produktu albo kupionej kombinacji, wartością, kodem, datą ważności, dedykacją i Twoim tekstem o korzystaniu z karty. Dedykacja to wszystko, co kupujący wpisał w tekstowych polach personalizacji produktu, na przykład „Dla”, „Od” i „Wiadomość”.

Płacenie kartą. Posiadacz wpisuje kod w polu kodu rabatowego w koszyku. Karta opłaca produkty; gdy produkty kosztują mniej niż karta, PrestaShop tworzy nowy kod na pozostałą kwotę i wysyła go e-mailem do klienta, który złożył zamówienie. Moduł zapisuje, które kody należą do której karty, i pokazuje Ci saldo.

Moduł nie łączy się z addonspresta.com ani z żadnym innym serwerem, nie zapisuje ciasteczek i nie przechowuje plików PDF: karty powstają w chwili, w której ktoś o nie prosi.

4. Funkcje i ustawienia

Otwórz Moduły → Menedżer modułów → Karty podarunkowe → Konfiguruj. Strona pokazuje ramkę Pomoc, ustawienia, produkty kart podarunkowych i krótkie przypomnienie zasad działania kodów rabatowych PrestaShop.

Ustawienia

Włącz karty podarunkowe. Po wyłączeniu żadna nowa karta nie jest wystawiana w żaden sposób, a informacja o karcie podarunkowej znika z witryny razem z pobieraniem PDF. Wystawione już karty pozostają ważne i nadal możesz nimi zarządzać.

Statusy zamówienia wystawiające karty podarunkowe. Karty z zamówienia są wystawiane, gdy po raz pierwszy otrzyma ono jeden z zaznaczonych statusów. Co najmniej jeden status musi pozostać zaznaczony. Trzymaj się statusów oznaczających, że pieniądze dotarły; dodaj własne statusy opłaconych zamówień, na przykład z modułu płatności, jeśli ich używasz.

Ważność (dni od daty wystawienia). Od 1 do 3650 dni, domyślnie 365. Zmiana dotyczy kart wystawionych od tej chwili; wcześniejsze karty zachowują swoją datę.

Prefiks kodu. Do 8 wielkich liter i cyfr na początku każdego kodu, domyślnie GC. Może być pusty.

Pokazuj informację o karcie podarunkowej na stronie produktu. Krótki blok na stronie produktu karty podarunkowej: jak karta jest dostarczana i jak długo jest ważna.

Wysyłaj kopię e-maili z kartami podarunkowymi na adres. Opcjonalny adres, który dostaje ukrytą kopię każdego e-maila z kartami podarunkowymi, razem z plikami PDF.

Jak korzystać z karty (PDF i e-mail). Zwykły tekst dla każdego języka, do 1000 znaków, drukowany na PDF i w e-mailu. {shop_name} i {shop_url} są zastępowane nazwą i adresem sklepu. Język pozostawiony pusty korzysta z tekstu domyślnego języka sklepu.

Produkty kart podarunkowych

Wpisz co najmniej trzy znaki nazwy albo indeksu produktu, albo ID produktu, wybierz produkt z wyników i kliknij Dodaj. Pracownik, który nie ma dostępu do Zamówienia → Karty podarunkowe, dodaje produkt, wpisując jego ID. Pakiety nie mogą być kartami podarunkowymi.

Lista pokazuje każdy produkt karty podarunkowej z jego typem — Cyfrowa — PDF e-mailem albo Fizyczna — wysyłana — oraz wartość karty: ceny z podatkiem produktu albo jego kombinacji. Usuń kończy sprzedaż produktu jako karty podarunkowej; wystawione już karty pozostają ważne.

Pod produktem mogą pojawić się dwie uwagi. Produkt z regułą podatkową: karta jest warta cenę z podatkiem. Karty podarunkowe sprzedaje się zwykle bez podatku, ponieważ podatek jest płacony w chwili wydania karty; zapytaj księgową i ustaw regułę podatkową produktu zgodnie z jej zaleceniem. Produkt wirtualny z plikiem do pobrania: klient dostaje także e-mail PrestaShop z linkiem do tego pliku, więc pozostaw plik pusty.

Gdy dodajesz pierwszy produkt wirtualny, a funkcja produktów wirtualnych sklepu jest wyłączona, moduł ją włącza; inaczej koszyk z samą kartą cyfrową nadal wymagałby dostawy.

Warto wiedzieć o kartach cyfrowych: produkt wirtualny także podlega zasadom magazynu. Nadaj mu dużą ilość albo zezwól na zamówienia przy braku towaru, inaczej zniknie ze sprzedaży, gdy stan spadnie do zera. Aby karta miała dedykację, dodaj produktowi tekstowe pola personalizacji w jego formularzu.

Przykładowe grafiki. Moduł zawiera trzy gotowe grafiki kart podarunkowych, 800 × 800 px, z napisami po angielsku: gift-card-digital-50.jpg, gift-card-digital-100.jpg i gift-card-envelope.jpg w katalogu views/img/samples/ modułu (w pobranej paczce zip oraz w modules/ap_giftcard/ w sklepie). Dodaj je jako zdjęcia produktu w jego formularzu albo potraktuj jako punkt wyjścia do własnego projektu. Sam moduł z nich nie korzysta: karta zawsze pokazuje zdjęcie produktu.

Strona zamówienia

Zamówienia z kartami podarunkowymi dostają na stronie zamówienia sekcję Karty podarunkowe: produkt, typ, kod, wartość, saldo, status i data e-maila każdej karty.

• PDF otwiera jedną kartę; Drukuj wszystkie karty (PDF) otwiera wszystkie karty zamówienia w jednym pliku, po jednej karcie na stronę. Tak przygotowujesz karty fizyczne: wydruk, paczka, wysyłka.
• Wystaw teraz pojawia się, gdy zamówienie ma sztuki, którym brakuje karty, na przykład po zwiększeniu ilości albo gdy chcesz wystawić karty zamówienia opłaconego inną drogą. Działa niezależnie od statusu zamówienia.
• Wyślij e-mail ponownie wysyła jeszcze raz e-mail z kartą cyfrową. „Nie wysłano” w kolumnie e-mail oznacza, że wiadomości nie udało się wysłać; sprawdź ustawienia poczty i wyślij ponownie.
• Gdy zamówienie zostaje anulowane albo zwrócone, a jego karty są nadal ważne, sekcja pokazuje ostrzeżenie. Moduł nigdy sam nie unieważnia karty: kliknij Dezaktywuj, jeśli karta nie ma być użyta.
• Gdy karta podarunkowa, którą opłacono zamówienie, została użyta także w innym zamówieniu, karty nie są wystawiane automatycznie, a sekcja wymienia te zamówienia. Zdarza się to, gdy dwa zamówienia z tym samym kodem zostają złożone w tej samej chwili. Sprawdź, które zamówienie karta rzeczywiście opłaciła, i kliknij Wystaw teraz, jeśli karty mają zostać wystawione.
• Gdy jeden koszyk został zamieniony na więcej niż jedno zamówienie, karty również nie są wystawiane automatycznie, a sekcja wymienia pozostałe zamówienia. Zdarza się to, gdy klient potwierdzi to samo zamówienie dwa razy w tej samej chwili albo gdy moduł płatności zgłosi jedną płatność dwukrotnie. Zostaw jedno zamówienie, pozostałe anuluj i kliknij Wystaw teraz w zamówieniu, które zostaje.

Zamówienia → Karty podarunkowe

Lista wszystkich wystawionych kart: kod, typ, wartość, saldo, zamówienie, klient, data wystawienia, data ważności, status i data e-maila. Listę można filtrować według kodu, typu, numeru zamówienia, e-maila klienta, daty wystawienia i statusu, a także wyeksportować do CSV. Filtr kodu znajduje kartę także po kodzie utworzonym po częściowym wykorzystaniu.

Statusy: Aktywna (nic nie wydano), Częściowo wykorzystana, Wykorzystana, Wygasła, Dezaktywowana (wyłączona przez Ciebie) i Kod rabatowy usunięty (jej regułę koszyka usunięto w Katalog → Rabaty).

Akcja podglądu w wierszu otwiera stronę karty: kod wydrukowany na karcie i aktualny kod, wartość i saldo, daty, zamówienie, klient, produkt i dedykacja, a dalej Kody tej karty — każde częściowe użycie zastępuje kod nowym — i Zamówienia opłacone tą kartą. Dezaktywuj blokuje aktualny kod do chwili, w której klikniesz Aktywuj ponownie; kwota nie przepada.

Reguła koszyka karty pozostaje zwykłą regułą koszyka: możesz przedłużyć jej datę albo ją zmienić w Katalog → Rabaty, a lista od razu pokaże nowy stan.

Co widzi klient

• Strona produktu: blok z informacją o karcie, o ile go nie wyłączysz.
• Potwierdzenie zamówienia: jedno zdanie o tym, że karta zostanie wysłana e-mailem po płatności, że została wysłana albo że zostanie wysłana razem z zamówieniem. Kod nigdy się tam nie pojawia.
• Szczegóły zamówienia na koncie klienta i na stronie śledzenia zamówienia gościa: blok Karty podarunkowe. Dla karty cyfrowej pokazuje wartość, kod, datę ważności, status i Pobierz PDF, dostępne tak długo, dopóki z karty nic nie wydano. Dla karty fizycznej pokazuje jedynie „Wysyłana z zamówieniem”: kod jedzie w paczce. Na stronie śledzenia zamówienia gościa kod i pobieranie są widoczne tylko dla zamówień złożonych bez konta; przy zamówieniu zarejestrowanego klienta strona prosi najpierw o zalogowanie.

Uprawnienia

Strona konfiguracji wymaga uprawnienia do konfiguracji modułu, a sekcja na stronie zamówienia — uprawnienia do jego wyświetlania. Lista Zamówienia → Karty podarunkowe korzysta z uprawnień tej pozycji menu w Zaawansowane → Zespół: wyświetlanie dla listy, strony karty i PDF, edycja dla wystawiania, ponownej wysyłki, dezaktywacji i ponownej aktywacji.

5. Multistore

Ustawienia i produkty kart podarunkowych zapisują się dla sklepu wybranego w nagłówku panelu: każdy sklep może sprzedawać inne karty, z własnymi statusami, ważnością, prefiksem i tekstami, albo mieć moduł wyłączony. W kontekście Wszystkie sklepy produkt jest dodawany w każdym sklepie, do którego należy. Karta należy do sklepu swojego zamówienia, a jej kod działa wyłącznie w tym sklepie. Lista i strona zamówienia pokazują wyłącznie karty sklepów, którymi zarządzasz. Jedna licencja obejmuje wszystkie sklepy instalacji.

6. Odinstalowanie

Menedżer modułów → Karty podarunkowe → Odinstaluj usuwa ustawienia, listę produktów kart podarunkowych i listę wystawionych kart razem z ich PDF. Kody rabatowe wystawionych kart zostają w Katalog → Rabaty i pozostają ważne: to pieniądze wpłacone przez Twoich klientów. Aby wstrzymać sprzedaż kart i niczego nie stracić, wyłącz Włącz karty podarunkowe albo użyj opcji Wyłącz.

7. Najczęstsze pytania i problemy

Zamówienie jest opłacone, a karta nie została wystawiona. Sprawdź, czy moduł jest włączony w tym sklepie, czy produkt jest na liście produktów kart podarunkowych tego sklepu i czy status zamówienia należy do zaznaczonych statusów. Następnie kliknij Wystaw teraz na stronie zamówienia.

Klient nie dostał e-maila. E-mail wysyłają wyłącznie karty cyfrowe. Spójrz na kolumnę e-mail: jeśli widzisz „Nie wysłano”, sprawdź ustawienia poczty i kliknij Wyślij e-mail ponownie. Klient znajdzie kartę także w szczegółach zamówienia.

Karta nie opłaciła dostawy. PrestaShop ogranicza kwotowy kod rabatowy do produktów w koszyku, więc dostawa jest płatna osobno i nie jest pobierana z karty.

Klient wydał część karty i kod przestał działać. Po częściowym wykorzystaniu PrestaShop zastępuje kod nowym na pozostałą kwotę, na przykład GC-7KQM-X2RD-9HTP-2, i wysyła go e-mailem do klienta, który złożył zamówienie. Nowy kod jest przypisany do konta tego klienta. Znajdziesz go na stronie karty jako aktualny kod.

Nie powstał kod na pozostałą kwotę. PrestaShop go nie tworzy, gdy jeden koszyk jest dzielony na kilka zamówień, na przykład z kilku magazynów. Utwórz kod rabatowy na różnicę w Katalog → Rabaty. Moduł traktuje każdy kod rabatowy, którego kod to kod karty podarunkowej z dopisanym łącznikiem i liczbą, jako środki tej karty — także kod utworzony ręcznie. Nie nadawaj takiego kodu zwykłemu rabatowi.

Zamówienie opłacone kartą zostało anulowane. Jak klient odzyska kwotę? PrestaShop sam jej nie przywraca. Otwórz kod w Katalog → Rabaty i włącz go ponownie albo zwiększ jego ilość. To samo dotyczy zamówienia, które powstaje od razu ze statusem Błąd płatności lub Anulowane: karta zostaje w nim wykorzystana jak w każdym innym zamówieniu.

Czy kodem rabatowym można kupić kartę podarunkową, a kartą — inną kartę? Tak, moduł niczego tu nie blokuje. Karta kupiona w zamówieniu opłaconym kartą podarunkową jest warta tyle, ile za nią zapłacono (patrz Wartość), więc promocji na karty nie da się zamienić w dodatkowe środki przez kupowanie kart kartami. Aby kod promocyjny nie obejmował kart podarunkowych, umieść karty w osobnej kategorii, w zakładce Warunki reguły koszyka wskaż kategorie, których promocja dotyczy, a w zakładce Działania zastosuj rabat do wybranych produktów.

Karta jest warta mniej niż cena katalogowa. Klient kupił ją z ceną specjalną o stałej cenie albo z rabatem grupy klientów. Oba ustawienia zastępują cenę produktu, a karta idzie za ceną.

Klient nie może pobrać PDF. Pobieranie jest dostępne dla karty cyfrowej, która nadal jest aktywna, dla jej kupującego: zalogowanego albo przez stronę śledzenia zamówienia gościa, gdy zamówienie złożono bez konta. PDF zawsze możesz otworzyć w panelu administracyjnym i wysłać samodzielnie.

Chcę innego wyglądu PDF albo e-maila. Karta korzysta ze zdjęcia produktu, więc zmień zdjęcie produktu. Szablony można nadpisać z poziomu motywu; ich listę zawiera plik README.md w katalogu modułu.

Tekst jest nadal w języku angielskim. Moduł jest przetłumaczony na angielski, polski i francuski. Dla innego języka otwórz Międzynarodowy → Tłumaczenia → Tłumaczenia zainstalowanych modułów i przetłumacz teksty modułu, jego e-mail przetłumacz w tłumaczeniach e-maili na tej samej stronie, a tekst o korzystaniu z karty wpisz na stronie konfiguracji. Dopóki e-mail nie jest przetłumaczony, zamówienia w tym języku dostają e-mail angielski.

8. Aktualizacje i wsparcie

Aktualizacje są bezpłatne dożywotnio: pobieraj nowe wersje z Moje konto → Historia zamówień w addonspresta.com i wgrywaj je jak nowy moduł. Ustawienia, produkty kart podarunkowych i wystawione karty zostają zachowane.

Wsparcie obejmuje 12 miesięcy od zamówienia: napisz na mail@addonspresta.com albo skorzystaj z formularza kontaktowego w 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 prowadzące do problemu.

Wróć do: Instrukcje modułów