Giftvane – Karty Podarunkowe i Kredyt Sklepowy dla WooCommerce

Opis

Giftvane sprzedaje kartę podarunkową lub bon podarunkowy jako zwykły produkt WooCommerce. Zaznacz pole „Karta podarunkowa” na dowolnym produkcie i ustaw jego cenę na wartość karty. Gdy zamówienie zostanie oznaczone jako zakończone, wtyczka generuje unikatowy kod kredytu sklepowego o tej wartości, rejestruje jego saldo we własnej tabeli i wysyła e-mail z kodem na adres e-mail zamówienia kupującego.

Aby wykorzystać kartę, klient wprowadza kod w polu podczas realizacji zamówienia. Saldo jest stosowane jako zniżka na to zamówienie. Jeśli zamówienie kosztuje mniej niż wartość karty, pozostała kwota pozostaje na kodzie do późniejszego zakupu, więc jedna karta może pokryć kilka zamówień, dopóki się nie wyczerpie.

Kupujący widzi również kod(y) wydane przez jego zamówienie na stronie potwierdzenia zamówienia oraz w e-mailach zamówienia WooCommerce, dzięki czemu ma kod pod ręką, bez przeszukiwania skrzynki odbiorczej.

Kod jest tworzony i śledzony na GitHubie. Kod źródłowy i zgłoszenia błędów: github.com/wppoland/plogins-giftcards

Dokumentacja i linki

Co robi

  • Zmienia dowolny produkt w kartę podarunkową za pomocą jednego pola wyboru na karcie Ogólne edytora produktu; cena to wartość karty.
  • Generuje unikatowy kod po zakończeniu zamówienia i wysyła go e-mailem na adres e-mail zamówienia kupującego.
  • Dodaje pole do wprowadzania kodu do realizacji zamówienia, które stosuje saldo karty jako zniżkę.
  • Zachowuje niewykorzystane saldo na kodzie po częściowym wykorzystaniu, dzięki czemu działa w wielu zamówieniach.
  • Pozwala ustawić prefiks kodu, etykietę zniżki przy realizacji zamówienia oraz temat i treść e-maila odbiorcy.
  • Opcjonalnie wyświetla wydane kody na stronie zamówienia kupującego oraz w jego e-mailach zamówienia.
  • Działa z WooCommerce HPOS (własne tabele zamówień).
  • Pozwala asystentowi AI w twoim panelu administracyjnym sprawdzić saldo kodu i wyświetlić kody wydane przez zamówienie, za pośrednictwem WordPress Abilities API w WordPress 6.9 i nowszych. Tylko do odczytu; nie może zmienić salda ani wydać kodu.

Usługi zewnętrzne

Ta wtyczka nie łączy się, nie wysyła danych ani nie polega na żadnej zewnętrznej usłudze, API ani CDN. Wszystko działa na twojej własnej witrynie. Kody kart podarunkowych i salda są przechowywane w jednej własnej tabeli bazy danych ({prefix}giftcards), flaga karty podarunkowej i adres odbiorcy są przechowywane w metadanych produktu WooCommerce i pozycji zamówienia (_giftcards_is_gift_card, _giftcards_recipient_email), a ustawienia znajdują się w opcjach giftcards_settings i giftcards_db_version. E-mail zawierający kod jest dostarczany za pośrednictwem własnej skrzynki pocztowej WooCommerce/WordPress twojej witryny na adres rozliczeniowy zamówienia; żadna wiadomość ani dane klienta nie opuszczają twojego serwera.

Tłumaczenia

Giftvane jest w pełni przetłumaczalny i zawiera szablon giftvane.pot. Tłumaczenia są dostarczane przez pakiety językowe WordPress.org z translate.wordpress.org, gdzie są współtworzone tłumaczenia na język polski, niemiecki i hiszpański; sam pakiet nie zawiera skompilowanych plików tłumaczeń.

Zrzuty ekranu

Instalacja

  1. Prześlij wtyczkę do /wp-content/plugins/giftvane lub zainstaluj ją z Wtyczki > Utwórz nową.
  2. Włącz ją. WooCommerce musi być aktywny.
  3. Edytuj produkt, zaznacz Karta podarunkowa na karcie Ogólne i ustaw jego cenę na wartość karty.
  4. Ustaw prefiks kodu i e-mail odbiorcy w WooCommerce > Karty podarunkowe.

Najczęściej zadawane pytania

Czy potrzebuje WooCommerce?

Tak. WooCommerce 8.0 lub nowszy musi być zainstalowany i aktywny.

Jak ustawić wartość karty podarunkowej?

Wartość to cena produktu karty podarunkowej. Zakup dwóch kart o wartości 50 $ generuje dwa kody o wartości 50 $.

Kto otrzymuje kod?

Kod jest wysyłany e-mailem na adres e-mail rozliczeniowy zamówienia, a kupujący może go również zobaczyć na stronie potwierdzenia zamówienia oraz w swoich e-mailach z zamówieniami. W tej wersji nie ma oddzielnego pola „wyślij do znajomego”.

Jak działa realizacja kodu?

Klient wpisuje kod w pole przy kasie. Saldo jest odejmowane od tego zamówienia jako rabat, a wszelkie pozostałe środki pozostają na kodzie na następny raz.

Czy karta podarunkowa może być użyta więcej niż raz?

Tak. Jeśli przy kasie wykorzystana zostanie tylko część salda, pozostały kredyt sklepowy pozostaje na tym samym kodzie do późniejszego zamówienia.

Czy każda ilość tworzy oddzielny kod?

Tak. Zakup dwóch sztuk produktu karty podarunkowej generuje dwa oddzielne kody rabatowe z ceną produktu jako wartością każdego z nich.

Czy mogę dostosować e-mail?

Tak. Ustaw temat i treść e-maila w WooCommerce > Karty Podarunkowe, z tokenami dla kodu i kwoty.

Czy działa z blokami kasy WooCommerce?

HPOS, tak. Realizacja karty podarunkowej jest obecnie funkcją klasycznej kasy; w kasie blokowej pole realizacji nie pojawia się.

Czy ta wtyczka działa na WordPress Multisite?

Tak. Ta wtyczka jest zgodna z WordPress Multisite. Włącz ją w sieci lub włącz ją na poszczególnych witrynach; każda witryna zachowuje własne ustawienia i dane.

Recenzje

Wtyczka nie ma jeszcze żadnej recenzji.

Kontrybutorzy i deweloperzy

„Giftvane – Karty Podarunkowe i Kredyt Sklepowy dla WooCommerce” jest oprogramowaniem open source. Poniższe osoby miały wkład w rozwój wtyczki.

Zaangażowani

Wtyczka „Giftvane – Karty Podarunkowe i Kredyt Sklepowy dla WooCommerce” została przetłumaczona na 1 język. Podziękuj tłumaczom za ich wkład.

Przetłumacz wtyczkę “Giftvane – Karty Podarunkowe i Kredyt Sklepowy dla WooCommerce” na swój język.

Interesuje cię rozwój wtyczki?

Przeglądaj kod, sprawdź repozytorium SVN lub czytaj dziennik rozwoju przez RSS.

Rejestr zmian

1.2.8

  • Funkcje tylko do odczytu są teraz oznaczane jako tylko do odczytu tam, gdzie szuka ich API Zdolności (meta.annotations), więc są wywoływane za pomocą GET, zgodnie z oczekiwaniami API; GET zwracało wcześniej 405 i działało tylko POST. get-settings akceptuje również wywołanie bez danych wejściowych.

1.2.7

  • Pole karty podarunkowej przy kasie posiada własny kod jednorazowy, a kod jest odczytywany tylko wtedy, gdy ten kod jednorazowy zostanie zweryfikowany.
  • E-mail odbiorcy pokazywał kwotę z symbolem waluty jako surową encję HTML („$50.00” w temacie i treści). Teraz wyświetla się „$50.00”.
  • E-maile klientów w formie zwykłego tekstu wymieniają wydane kody jako tekst; wcześniej otrzymywały tabelę HTML jako dosłowne tagi.
  • Usunięcie wtyczki w sieci multisite usuwa tabelę kart podarunkowych, opcje i oczekujące ponowne próby na każdej witrynie, nie tylko na głównej.
  • Każde zapytanie do bazy danych odwołuje się do tabeli wtyczki za pomocą przygotowanego symbolu zastępczego, w tym migracja schematu i deinstalacja.
  • Dołączone pliki biblioteczne odmawiają bezpośredniego dostępu, podobnie jak reszta wtyczki.

1.2.6

  • Zabezpieczenia (niski poziom): funkcja statusu karty podarunkowej produktu sprawdza teraz, czy wywołujący może edytować ten konkretny produkt, a nie produkty ogólnie, więc nie może ujawnić ceny produktu w wersji roboczej lub prywatnego.

1.2.5

  • Naprawiono: saldo karty podarunkowej było odejmowane dopiero po osiągnięciu statusu „Zrealizowane” przez zamówienie, często dni po płatności, więc do tego czasu ta sama karta mogła opłacić dowolną liczbę innych zamówień. Saldo jest teraz pobierane przy kasie w pojedynczym warunkowym zapisie, a drugie zamówienie, którego karta już nie pokrywa, jest odrzucane przed jego utworzeniem.
  • Naprawiono: ukończenie zamówienia usuwało z karty każdą ujemną opłatę, w tym rabat innej wtyczki. Liczy się tylko linia rabatu samej karty podarunkowej.
  • Naprawiono: kupujący, któremu pokazano rabat z karty podarunkowej, którego karta już nie pokrywała, został obciążony pełną ceną bez ostrzeżenia. Zamówienie jest teraz zatrzymywane z komunikatem, a sumy najpierw się odświeżają.
  • Anulowanie lub zwrot zamówienia zwraca wykorzystaną kwotę na kartę, raz.

1.2.4

  • Etykiety „Coming soon” i „Get notified” w powiadomieniu o aktualizacji są angielskimi ciągami źródłowymi dla każdego języka; polskie witryny otrzymywały wcześniej własny polski tekst źródłowy, który tłumacze w innych językach widzieli wtedy nieprzetłumaczony.

1.2.3

  • Pole wyboru karty podarunkowej w edytorze produktu posiada teraz własny token zabezpieczający i jest zapisywane tylko wtedy, gdy token jest prawidłowy i użytkownik może edytować produkt.

1.2.2

  • Zmieniono nazwę na Giftvane, prostą angielską nazwę zamiast esperanto. Domena tekstowa i katalog wtyczki są zgodne z nazwą; zapisane ustawienia, opcje i każdy hook pozostają niezmienione.
  • Migracja tabeli kart podarunkowych dokumentuje teraz każde bezpośrednie zapytanie, które wykonuje, dzięki czemu Plugin Check nie zgłasza żadnych ostrzeżeń.

1.2.1

  • Usunięto kod jednorazowy, który był tworzony, przekazywany do skryptu i nigdy nie wysłany ani nie zweryfikowany. Ścieżka, którą chronił, jest dostępna tylko poprzez własny punkt końcowy WooCommerce update_order_review, który najpierw sprawdza kod jednorazowy, i nie zapisuje niczego poza własną sesją odwiedzającego. Sprawdzenie, które się nie uruchamia, jest gorsze niż żadne, ponieważ sprawia wrażenie, że działa.
  • Promocja aktualizacji w panelu bocznym jest teraz odrzucana w ten sam sposób co baner. Odrzucenie banera pozostawiało wcześniej reklamę na całą wysokość na ekranie ustawień na stałe, co nie jest zgodne z wytycznymi WordPress.org dotyczącymi monitów o aktualizację, które powinny być używane z umiarem.

1.2.0

  • Zmieniono nazwę na Donkarto. Zespół recenzentów WordPress.org prosi, aby nazwa wtyczki zaczynała się od wyróżniającego, wymyślonego identyfikatora, a nie od ogólnego słowa opisowego. Donkarto to po esperanto „karta podarunkowa”. Domena tekstowa jest zgodna z nazwą; przechowywane dane, ustawienia i każdy hak pozostają bez zmian.

1.1.9

  • Naprawiono: ponowna próba nigdy nie odczytywała ponownie statusu zamówienia, więc zamówienie, które opuściło status Zakończone, gdy ponowna próba była w toku, nadal było przetwarzane. Ponowna próba odbywa się do pięciu razy w ciągu ponad godziny, a WooCommerce ogłasza zakończenie tylko na początku, więc zamówienie zwrócone lub anulowane nadal miało pozostałe karty podarunkowe zasilone i wysłane e-mailem, a saldo, które kupujący wykorzystał, nadal było odejmowane z jego karty. Zaplanowana próba sprawdza teraz, czy zamówienie nadal ma status Zakończone i zatrzymuje się, jeśli tak nie jest. Przywrócenie zamówienia do statusu Zakończone uruchamia pracę, którą nadal jest winne, tak jak poprzednio.
  • Naprawiono: notatka informująca, że wydawanie karty podarunkowej nigdy się nie zakończyło, była zapisywana przed ostatnią próbą, więc zamówienie, którego ostateczna próba ZAKOŃCZYŁA SIĘ SUKCESEM, i tak otrzymało alarm, a sprzedawca szukał brakującego kodu w zamówieniu, które było zakończone. Notatka jest teraz zapisywana przez próbę, która kończy się niepowodzeniem, i tylko przez nią, w tym, gdy ta próba zostaje całkowicie zabita, a nie przerwana.

1.1.8

  • Naprawiono: operacja zakończenia, która została zabita, a nie przerwana (błąd krytyczny lub zatrzymanie przez hosta z powodu czasu wykonania), pozostawiała transient chroniący operację na pięć minut, ponieważ wydanie uruchamiało się tylko wtedy, gdy operacja zakończyła się normalnie. Wszystko, co próbowało zakończyć zamówienie w tym oknie, było odrzucane przez blokadę, której operacja już nie działała. Wydanie następuje teraz również, gdy proces się wyłącza, co obejmuje błąd krytyczny, zatrzymanie z powodu czasu wykonania i całkowite wyjście.
  • Naprawiono: nic nigdy nie wracało do zamówienia, którego operacja karty podarunkowej została przerwana. Zdarzenie „zamówienie zakończone” uruchamia się tylko wtedy, gdy zamówienie zmienia status, więc zamówienie, które było już Zakończone, nigdy nie uruchamiało go ponownie: rekordy umożliwiające wznowienie operacji były tam, a nikt o nie nie prosił. Sprzedawca musiał sam zauważyć brakującą kartę i przenieść zamówienie ze statusu Zakończone z powrotem. Każda operacja rezerwuje teraz ponowną próbę przed rozpoczęciem i usuwa ją po zakończeniu, więc przerwane zamówienie jest podejmowane samodzielnie około piętnastu minut później, do pięciu razy.
  • Dodano: zamówienie, którego karty nie można było wydać w żadnej z tych prób, otrzymuje notatkę zamówienia informującą o tym, co należy sprawdzić i jak uruchomić to ponownie. Do tej pory karta, która nigdy nie została wydana, nie pozostawiała żadnego śladu, gdziekolwiek handlowiec szukał.
  • Zmieniono: wyłączanie lub usuwanie wtyczki usuwa teraz wszelkie ponowne próby oczekujące na zamówienie, aby żadne zaplanowane zdarzenie nie pozostało dla haka, na który nic nie odpowiada.

1.1.7

  • Naprawiono: gdy operacja realizacji zamówienia została przerwana w trakcie (błąd krytyczny lub zatrzymanie przez hosta z powodu maksymalnego czasu wykonania), zamówienie zostało już oznaczone jako zakończone, zanim pierwsza karta została utworzona. Nigdy nie ponawiano próby, więc każda pozostała karta w tym zamówieniu została opłacona i nigdy nie wydana. Każda karta jest teraz rejestrowana w momencie jej tworzenia, a zamówienie jest oznaczane jako zakończone tylko wtedy, gdy wszystkie karty istnieją i zostały wysłane e-mailem, więc późniejsze dokończenie tego samego zamówienia kończy pracę.
  • Zmieniono: po przerwaniu, jedyny odbiorca, którego e-mail był w trakcie wysyłki, może otrzymać ten e-mail ponownie. Zawiera ten sam kod i to samo saldo co pierwszy, nie jest to druga karta.
  • Naprawiono: saldo wydane przy kasie mogło pozostać w całości na karcie. Odliczenie następowało po wydaniu kart, a zamówienie było oznaczone jako zakończone, zanim cokolwiek się rozpoczęło, więc przerwana w pętli wydawania operacja nigdy nie dotarła do odliczenia i nic nie zostało z niej zwrócone: kupujący otrzymał zniżkę na to zamówienie i zachował saldo do ponownego wydania. Odliczenie jest teraz zgłaszane w zamówieniu, zanim zostanie ono wykonane, więc operacja, która kończy zamówienie, wykonuje je dokładnie raz.

1.1.6

  • Naprawiono: promocja aktualizacji PRO nadal sprzedawała osobom, które już kupiły płatną edycję. Tylko baner mógł zostać zamknięty, więc promocja w panelu bocznym i zablokowane karty funkcji podążały za płacącym klientem na stałe. Promocja sprawdza teraz, czy płatna edycja jest aktywna i usuwa się, gdy tak jest.
  • Naprawiono: glify strzałek w ścieżkach menu administratora oraz w ciągach znaków przekazywanych tłumaczom. Strzałka wewnątrz ciągu znaków przeznaczonego do tłumaczenia sprawia, że glif staje się problemem każdego tłumacza i zmienia układ w każdym ustawieniu regionalnym, które go pomija.

1.1.5

  • Naprawiono: usuwanie wtyczki pozostawiało w bazie danych flagę „zamknij” dla każdego użytkownika z powiadomienia PRO. Deinstalacja usuwa ją teraz dla każdego użytkownika, a nie tylko dla tego, który ją zamknął.

1.1.4

  • Szablon tłumaczenia został ponownie wygenerowany. Nadal odnosił się do starszej wersji wtyczki i wskazywał na linie źródłowe, które od tego czasu się przesunęły, co jest tym, co narzędzia tłumaczeniowe odczytują, aby pokazać ciąg znaków w kontekście.

1.1.3

  • Zmieniono nazwę na Plogins Gift Cards – Store Credit for WooCommerce, aby nazwa zaczynała się od marki, a nie od ogólnego słowa, o co prosi zespół recenzentów wtyczek WordPress.org. Uproszczona nazwa wtyczki pozostaje bez zmian.

1.1.2

  • Przetestowano z WordPress 7.1. Zweryfikowano poprzez włączanie tej kompilacji na czystej instalacji 7.1 z WooCommerce 11.1, a nie poprzez edycję nagłówka.

1.1.1

  • Naprawiono promocję PRO na ekranie ustawień, która podawała cenę w PLN. PRO jest wyceniane i pobierane w EUR, więc administratorowi na polskiej witrynie pokazywano kwotę w złotych, a następnie naliczano opłatę w euro, a kwota w złotych była stałą konwersją, która odbiegała od rzeczywistej opłaty wraz ze zmianą kursu. Promocja pokazuje teraz cenę w euro, która jest faktycznie pobierana.

1.1.0

  • Asystent AI pracujący w twoim wp-admin może teraz odczytywać twoje karty podarunkowe za ciebie, za pośrednictwem WordPress Abilities API (WordPress 6.9 i nowsze). Zapytaj go, ile pozostało na kodzie, jakie kody zostały wydane przez zamówienie, czy produkt jest skonfigurowany jako karta podarunkowa, lub jak karty podarunkowe są skonfigurowane w sklepie.
  • Tylko do odczytu. Żadna funkcja, którą może wywołać asystent, nie zmienia salda, nie wydaje ani nie unieważnia kodu, a adres odbiorcy nigdy nie jest zwracany. Tylko menedżerowie sklepu mogą z nich korzystać, a w WordPress 6.8 i wcześniejszych wersjach nic się nie zmienia.

1.0.4

  • Tłumaczenia: ukończono polskie, niemieckie i hiszpańskie dla panelu aktualizacji PRO.

1.0.3

  • Naprawiono nagłówki administratora o niskim kontraście przy preferencjach trybu ciemnego systemu operacyjnego.

1.0.2

  • Dodano dołączone tłumaczenia polskie, niemieckie i hiszpańskie dla interfejsu wtyczki.

1.0.1

  • Pierwsze stabilne wydanie.

0.2.1

  • Zmieniono nazwę na Plogins Gift Cards for WooCommerce dla bardziej wyróżniającej się nazwy wtyczki.

0.2.0

  • Temat i treść e-maila odbiorcy ustawione w WooCommerce > Karty Podarunkowe są teraz używane dla wysyłanego e-maila. Wcześniej te zapisane wartości były ignorowane i zawsze używano wbudowanej wartości domyślnej.
  • Dodano ustawienie dla etykiety rabatu przy kasie wyświetlanej po zastosowaniu kodu; akceptuje token {code}.
  • Dodano ustawienie, aby wyświetlać wydane kody na stronie potwierdzenia zamówienia kupującego oraz w e-mailach zamówienia. Jest ono domyślnie włączone.
  • Domyślny tekst e-maila i etykiety jest teraz możliwy do przetłumaczenia.
  • Przebudowano stronę ustawień: pomoc kontekstowa, tokeny e-mail do wstawiania kliknięciem i podgląd na żywo e-maila.
  • Przebudowano pole realizacji przy kasie i dodano przycisk kopiowania do listy wydanych kodów.
  • Style witryny teraz podążają za motywem i respektują tryb ciemny oraz ustawienia ograniczonego ruchu, bez przesunięcia układu przy kasie. Kod jest dostępny z klawiatury z etykietami ARIA i stylami fokusu, a wszystkie pliki CSS/JS są dostarczane jako oddzielne pliki.

0.1.0

  • Pierwsze wydanie.