MadeIT Vouchers

Instalacja i pierwszy voucher

Wymagania: WordPress 6.6+, PHP 8.0+ z rozszerzeniem GD (FreeType), aktywny WooCommerce i działająca poczta wychodząca (PDF idzie e-mailem).

1. Zainstaluj i aktywuj WooCommerce oraz MadeIT Vouchers.
2. Edytuj zwykły produkt prosty (albo dodaj nowy). W zakładce Ogólne w Dane produktu zaznacz Voucher. Produkt staje się wirtualny i sprzedawany pojedynczo.
3. Ustaw cenę jako wartość vouchera. Na każdą kwotę (np. 50, 100, 200 zł) zrób osobny produkt.
4. W MadeIT Vouchers → Ustawienia wybierz kolor i okres ważności.

Voucher nie jest tworzony ręcznie w panelu. Kod powstaje automatycznie po opłaceniu zamówienia na produkt oznaczony jako voucher.

Sprzedaż vouchera Darmowe

Na stronie produktu voucher pojawia się wybór odbiorcy, a pod nim podgląd vouchera.

• Dla mnie: voucher trafia na adres e-mail kupującego.
• W prezencie: kupujący podaje e-mail odbiorcy i opcjonalną wiadomość, która trafia do e-maila z voucherem. Adres jest sprawdzany przed dodaniem do koszyka.
• Informacja o terminie ważności („Ważny przez X miesięcy od opłacenia zamówienia”) i o tym, że saldo można wydać w kilku zakupach.

Wybór odbiorcy i wiadomość są zapisywane przy pozycji w koszyku i w zamówieniu, więc widać je w e-mailach i w panelu zamówienia.

Wydawanie kodów i PDF Darmowe

Kod powstaje, gdy zamówienie zostanie opłacone (status „W realizacji” albo „Zrealizowane”, lub zaksięgowana płatność). Każda sztuka produktu to osobny voucher.

• Kody są unikalne i przechowywane w bazie w postaci zaszyfrowanej. Do wyszukiwania służy tylko ich skrót.
• E-mail z voucherem ma załączony PDF w kolorze sklepu: kod, wartość, termin ważności i wiadomość od kupującego. Wysyła się raz na pozycję zamówienia.
• Termin ważności liczy się od dnia opłacenia. Zmiana domyślnego okresu w ustawieniach nie dotyczy już wydanych voucherów.

Realizacja kodu w koszyku Darmowe

Pole „Masz kod vouchera?” pojawia się nad koszykiem i nad płatnością, w wersji klasycznej i blokowej WooCommerce. Pole możesz też wstawić gdziekolwiek shortcode <code>[madeit_voucher_redeem]</code>.

• Klient wpisuje kod i klika „Zastosuj voucher”. Saldo pomniejsza kwotę do zapłaty, a w podsumowaniu zamówienia widać pozycję „Voucher”.
• Voucher można wydać w kilku zamówieniach, aż saldo spadnie do zera.
• Voucher płaci za zwykłe produkty, ale nie za inny voucher. Gdy w koszyku są tylko vouchery, klient dostaje stosowny komunikat.
• Kod nieprawidłowy, wygasły albo bez salda daje komunikat o błędzie. Kod można usunąć z koszyka.

Rezerwacja salda

Gdy klient złoży zamówienie, kwota jest <strong>rezerwowana</strong> na voucherze. Po opłaceniu zostaje rozliczona („Settled”). Gdy zamówienie zostanie anulowane lub nie powiedzie się płatność, rezerwacja jest zwalniana i saldo wraca. Przy pełnym zwrocie zamówienia niewykorzystana część płatności wraca na voucher automatycznie.

Ekran vouchery i historia Darmowe

MadeIT Vouchers → Vouchery pokazuje listę z trzema licznikami: wszystkie vouchery, aktywne z saldem i domyślna ważność.

• Wyszukiwanie po numerze vouchera, numerze zamówienia lub e-mailu odbiorcy.
• Filtry statusu: Aktywne, Wygasłe, Brak salda, Unieważnione.
• W szczegółach vouchera: odbiorca, status, wartość, dostępne saldo, termin ważności, zamówienie i lista operacji.

Historia operacji

Ustawienia: wygląd i ważność Darmowe

Obok formularza widać podgląd PDF i podgląd kolorów formularza.

Projekty PDF i kolory PRO

• Trzy projekty PDF: Klasyczny, Nowoczesny i Botaniczny, z podglądem na żywo.
• Gotowe kolory: Granat, Las, Jagoda i Miedź oprócz własnego koloru sklepu. Wybrany kolor stosuje się do PDF i formularzy.

Edycja tekstów PRO

Zakładka Teksty grupuje wszystkie teksty widoczne dla klienta: strona produktu, tytuł i etykiety PDF, komunikaty w koszyku i na płatności oraz temat i treść e-maila.

Dostępne znaczniki: <code>{months}</code>, <code>{code}</code>, <code>{amount}</code>, <code>{expires}</code>, <code>{message_section}</code> i <code>{message}</code>. Zapisane teksty zastępują domyślne, a pola, których nie zmienisz, dalej korzystają z tłumaczeń wtyczki.

Częściowy zwrot i przedłużenie ważności PRO

Zwrot częściowy

1. Utwórz częściowy zwrot w WooCommerce jak zwykle.
2. Otwórz MadeIT Vouchers → Ustawienia → Zwroty i wpisz numer zamówienia, numer zwrotu WooCommerce i kwotę w groszach do przywrócenia.
3. Saldo wraca na voucher, a w jego historii pojawia się wpis. Resztę rozliczysz pierwotną metodą płatności.

Pełne zwroty wtyczka darmowa przywraca automatycznie.

Przedłużenie ważności

Otwórz voucher w MadeIT Vouchers → Vouchery, wybierz nową datę w polu „Przedłuż ważność do” i kliknij „Przedłuż voucher”. Datę można tylko przesunąć do przodu, a zmiana zapisuje się w historii.

Licencja i aktualizacje Pro PRO

1. Pobierz dodatek z konta klienta i wgraj go w Wtyczki → Dodaj nową → Wyślij wtyczkę.
2. Aktywuj go. Wymaga aktywnych MadeIT Vouchers i WooCommerce.
3. W MadeIT Vouchers → Licencja wklej 32-znakowy klucz i kliknij „Zapisz i aktywuj”.

Aktualizacje przez 12 miesięcy w Kokpit → Aktualizacje. Po wygaśnięciu licencji dodatek działa dalej bez nowych wersji. Klucz obejmuje jedną stronę.

Rozwiązywanie problemów

• PDF się nie generuje: serwer musi mieć rozszerzenie PHP GD z obsługą FreeType.
• Klient nie dostał e-maila: sprawdź pocztę WordPressa (wp_mail), skonfiguruj SMTP i spam.
• Kod „nieprawidłowy”: sprawdź status w MadeIT Vouchers (wygasły, brak salda, unieważniony).
• Pola vouchera nie widać na stronie produktu: sprawdź, czy zaznaczono „Voucher” i czy to produkt prosty.
• Zakładki Pro się nie pojawiają: darmowa wtyczka musi być aktywna, a dodatek aktywowany.

Najczęstsze pytania

Czy potrzebuję też darmowej wtyczki?

Tak. MadeIT Vouchers Pro to dodatek i wymaga zainstalowanej oraz aktywnej darmowej wtyczki MadeIT Vouchers z WordPress.org.

Czy coś w darmowej wtyczce jest zablokowane do czasu zakupu PRO?

Nie. Darmowa wtyczka jest kompletna: vouchery z saldem, PDF e-mailem, wykorzystanie w koszyku i na płatności, ważność i pełna historia. PRO dodaje wzory, edycję tekstów, zwroty częściowe i przedłużanie ważności.

Co się stanie z voucherami po dezaktywacji PRO?

Nic nie przepada. Vouchery, salda i historia należą do darmowej wtyczki. Wzory i teksty z PRO wracają do ustawień domyślnych, dopóki nie włączysz dodatku ponownie.

Co się stanie, gdy licencja wygaśnie?

Zainstalowana wersja działa dalej bez ograniczeń. Wstrzymany zostaje tylko dostęp do nowych wersji i wsparcia do czasu odnowienia.

Na ilu stronach mogę używać jednej licencji?

Jedna licencja obejmuje jedną stronę. Stronę możesz odłączyć w koncie klienta i aktywować licencję gdzie indziej.

Czy działa z blokowym checkoutem WooCommerce?

Tak. Darmowa wtyczka obsługuje klasyczny i blokowy koszyk oraz płatność, a PRO się na niej opiera.

Czy dodatek wysyła dane klientów do MadeIT Labs?

Nie. Wysyła tylko klucz licencyjny i adres strony, żeby sprawdzić licencję i pobrać aktualizację.

Historia zmian

MadeIT Vouchers

MadeIT Vouchers Pro

Wsparcie

Wtyczka darmowa ma wsparcie na forum WordPress.org. Z aktywną licencją Pro możesz zgłosić sprawę z konta klienta.