Dokumentacja WP Simple Pay

Materiały dokumentacyjne, referencyjne i samouczki dla WP Simple Pay

Jak dodać pole przesyłania plików

Czas czytania: 5 minut | Poziom trudności: Początkujący

Przegląd

Pole Przesyłanie plików pozwala klientowi dołączyć plik podczas dokonywania płatności. Obejmuje ono wszystkie formularze, które wymagają dokumentu wraz z pieniędzmi: brief projektu dla niestandardowego zlecenia, zdjęcie do zamówienia wydruku, podpisany formularz lub dowód kwalifikacji do zniżkowej stawki.

Klienci mogą przeciągnąć plik na pole lub kliknąć, aby wybrać go z komputera. Widzą pasek postępu przesyłania, a następnie nazwę pliku z przyciskiem do jego usunięcia i wybrania innego pliku. Po dokonaniu płatności plik jest rejestrowany w odniesieniu do tej płatności i powiązany z jej widokiem szczegółów w WordPress.

Wymagania wstępne

  • WP Simple Pay Pro (dowolny poziom)
  • Formularz płatności, do którego należy dodać pole

Krok 1: Dodaj pole przesyłania plików

  1. Przejdź do WP Simple Pay > Formularze płatności i edytuj formularz, do którego chcesz dodać pole.
  2. Kliknij zakładkę Pola formularza.
  3. Otwórz menu rozwijane pól i wybierz Przesyłanie plików.
  4. Kliknij Dodaj pole.
Wybieranie Przesyłania Pliku z listy rozwijanej pól formularza

Nowe pole zostanie dodane na górze listy pól. Kliknij jego tytuł, aby rozwinąć jego ustawienia.

Krok 2: Skonfiguruj pole

Ustawienia pola Przesyłania Pliku w kreatorze formularzy

Każde pole przesyłania plików ma własne ustawienia, więc formularz z dwoma polami przesyłania może akceptować zupełnie inne pliki w każdym z nich.

Etykieta

Tekst wyświetlany nad polem w Twoim formularzu. Zmień go, aby zawierał to, co chcesz, na przykład „Prześlij swoje prace” zamiast „Plik”.

Dozwolone typy plików

Lista rozdzielonych przecinkami rozszerzeń plików, zapisanych z kropką lub bez. Domyślna lista to:

.pdf,.doc,.docx,.jpg,.jpeg,.png,.gif

Ogranicz ją do dokładnie tego, czego potrzebujesz. Drukarnia przyjmująca prace może użyć .pdf,.png,.tif, podczas gdy formularz zbierający podpisane umowy może zezwalać tylko na .pdf.

Twoja lista nie jest ostateczna. WP Simple Pay akceptuje plik tylko wtedy, gdy rozszerzenie znajduje się na Twojej liście ORAZ sam WordPress zezwala na przesyłanie tego typu pliku. Wszystko poza tym zakresem jest odrzucane, a pliki HTML i JavaScript są zawsze odrzucane, niezależnie od tego, co wpiszesz tutaj.

Maksymalny rozmiar pliku (MB)

Największy plik, jaki pole zaakceptuje, w megabajtach. Domyślnie jest to 10 MB, a możesz ustawić dowolną wartość od 1 MB do 100 MB.

Twój serwer internetowy ma własny limit przesyłania, a wygrywa mniejsza liczba. Jeśli Twój hosting ogranicza przesyłanie do 8 MB, ustawienie tego pola na 50 MB nie podniesie tego limitu. Skontaktuj się z hostingiem, aby podnieść limit serwera, jeśli potrzebujesz większych plików.

Wymagane

Zaznacz to pole, jeśli klient musi załączyć plik przed dokonaniem płatności. Pole wymagane bez pliku blokuje płatność i wyświetla błąd przy polu.

Etykieta metadanych Stripe

Krótka nazwa (do 40 znaków) używana do identyfikacji tego przesłanego pliku w rekordach płatności Stripe i w szczegółach transakcji w WordPress. Nie jest ona wyświetlana klientowi.

Wpisz tutaj etykietę, a poniżej pojawi się przycisk Kopiuj inteligentny tag wraz z pasującym tagiem:

Ustawienie Etykieta metadanych Stripe z przyciskiem Kopiuj inteligentny tag

Kliknij Kopiuj inteligentny tag, aby skopiować tag, taki jak {payment:metadata:artwork_file} do schowka, gotowy do wklejenia na stronie potwierdzenia lub w wiadomości e-mail. Zobacz Używanie inteligentnych tagów na stronach potwierdzeń i w wiadomościach e-mail, gdzie te tagi mogą być używane.

Zapisz formularz, gdy skończysz.

Krok 3: Co widzą Twoi Klienci

Na opublikowanym formularzu pole zaczyna się jako strefa upuszczania z tekstem „Przeciągnij i upuść plik lub kliknij, aby przeglądać”.

Pole Przesyłania Pliku na opublikowanym formularzu płatności

Klient przeciąga plik lub klika, aby otworzyć przeglądarkę plików. Plik jest natychmiast sprawdzany pod kątem dozwolonych typów i limitu rozmiaru, więc nieprawidłowy typ pliku jest odrzucany przed przesłaniem. Pasek postępu działa podczas przesyłania pliku, a następnie pole wyświetla nazwę pliku z przyciskiem usuwania, dzięki czemu klient może go zmienić.

Pole Przesyłania Pliku pokazujące dołączony plik

Dwie rzeczy chronią zgłoszenie:

  • Gdy przesyłanie pliku jest w toku, formularz nie może zostać przesłany. Klient nigdy nie płaci przed zakończeniem przesyłania pliku.
  • Jeśli wymagane pole Przesyłanie pliku jest puste, próba wysłania formularza wyświetli błąd przy polu i nie zostanie podjęta próba płatności.

Gdzie trafia przesłany plik

Po utworzeniu płatności adres URL przesłanego pliku jest zapisywany w metadanych Stripe tej płatności, pod nazwą ustawioną w Etykieta metadanych Stripe. Możesz zobaczyć go przy płatności w swoim panelu Stripe.

Wewnątrz WordPressa plik pojawia się w karcie Przesłane pliki w widoku szczegółów płatności, wymieniony według etykiety metadanych pola, z oryginalną nazwą pliku jako linkiem, który otwiera plik. Zobacz Jak korzystać ze strony Transakcje, aby dowiedzieć się, jak znaleźć płatność i otworzyć jej widok szczegółów.

Bezpieczeństwo i przechowywanie

Przesyłanie plików odbywa się na publicznym formularzu płatności, dlatego każde sprawdzenie jest stosowane zarówno na serwerze, jak i w przeglądarce:

  • Domyślnie odrzucaj. Akceptowane typy to przecięcie listy dozwolonych typów i typów plików, na które pozwala sam WordPress. Pliki HTML i JavaScript są zawsze wykluczane dla każdego odwiedzającego.
  • Rzeczywista zawartość pliku jest sprawdzana pod kątem jego rozszerzenia. Skrypt, który został przemianowany, aby wyglądać jak obraz, jest odrzucany, a nie przechowywany.
  • Rozmiar jest egzekwowany dwukrotnie, w stosunku do limitu pola i limitu przesyłania własnego serwera.
  • Ten sam limit na adres IP, który chroni zgłoszenia płatności, dotyczy przesyłania plików. Pojedynczy odwiedzający nie może zasypywać punktu końcowego plikami.

Pliki są przechowywane w dedykowanym, zabezpieczonym folderze wewnątrz katalogu przesyłania WordPress, oddzielnie od zwykłych multimediów, a każdy z nich otrzymuje losowo wygenerowaną nazwę pliku, dzięki czemu jego adres nie może zostać odgadnięty.

Te pliki nie są przeznaczone do ręcznego zarządzania. Zmiana nazwy, przeniesienie lub usunięcie jednego z nich przerywa powiązanie zapisane z płatnością, a automatyczne czyszczenie poniżej usuwa pliki, za które nikt nie zapłacił.

Automatyczne czyszczenie porzuconych przesłanych plików

Plik jest przesyłany w momencie, gdy klient go wybierze, czyli przed dokonaniem płatności. Zaplanowane zadanie uruchamia się regularnie i usuwa przesłane pliki, za które nigdy nie zapłacono:

  • Pliki, które w ogóle nie zostały dołączone do płatności, ponieważ odwiedzający wybrał plik, a następnie opuścił formularz. Są one usuwane po około dniu.
  • Pliki dołączone do płatności, której klient nigdy nie ukończył, na przykład z powodu odrzuconej karty lub zamkniętej karty na etapie płatności. Są one usuwane po około tygodniu.

Praktyczną konsekwencją jest to, że porzucone zakupy nie pozostawiają plików na serwerze na zawsze. Pliki należące do płatności, które faktycznie przeszły, nigdy nie są dotykane przez czyszczenie, w tym płatności, które zostały później zwrócone lub zakwestionowane.

Często zadawane pytania

Jakie typy plików są dozwolone domyślnie?

PDF, DOC, DOCX, JPG, JPEG, PNG i GIF. Możesz zastąpić tę listę własną w ustawieniu Dozwolone typy plików.

Dodałem rozszerzenie do dozwolonej listy, a plik nadal jest odrzucany. Dlaczego?

Twoja lista jest porównywana z typami plików, na które zezwala WordPress do przesyłania, a wszystko, na co WordPress nie zezwala, jest usuwane z listy pola. Pliki HTML i JavaScript są wykluczane bez względu na wszystko. Błąd wyświetlany w formularzu zawiera listę rozszerzeń, które pole faktycznie akceptuje, co jest najszybszym sposobem, aby zobaczyć, co przetrwało porównanie.

Plik może zostać odrzucony również wtedy, gdy jego rozszerzenie nie odpowiada jego rzeczywistej zawartości, na przykład plik .zip zmieniony na .pdf.

Jaki jest największy rozmiar pliku, jaki mogę zezwolić?

Ustawienie pola akceptuje od 1 MB do 100 MB, domyślnie 10 MB. Limit przesyłania PHP Twojego serwera ma zastosowanie dodatkowo, a mniejsza z tych dwóch wartości jest egzekwowana. Jeśli Twój hosting pozwala na przesyłanie 8 MB, 8 MB to rzeczywisty limit, niezależnie od tego, co mówi pole. Zwiększenie wartości pola powyżej limitu serwera nic nie daje, więc poproś swojego hosta o podniesienie limitu serwera najpierw.

Czy przesłane pliki trafiają do mojej Biblioteki Mediów?

Nie, nie są przechowywane razem z Twoimi zwykłymi mediami. Trafiają do dedykowanego folderu WP Simple Pay w Twoim katalogu przesyłania, pod losowymi nazwami plików i są automatycznie czyszczone, gdy płatność, do której należą, nigdy nie została ukończona. Traktuj je jako rekordy płatności, a nie jako media do zarządzania.

Jak mogę uwzględnić przesłany plik na stronie potwierdzenia lub w wiadomości e-mail?

Ustaw Etykietę metadanych Stripe dla pola, kliknij Kopiuj inteligentny tag i wklej wynikowy tag {payment:metadata:...} w treści strony potwierdzenia lub treści wiadomości e-mail. Tag wypisuje adres URL pliku. Zobacz Używanie inteligentnych tagów dla stron potwierdzenia i wiadomości e-mail oraz Jak tworzyć niestandardowe inteligentne tagi pól formularza.

Co dzieje się z plikiem, jeśli klient porzuci płatność?

Jest automatycznie usuwane. Plik, który nigdy nie został dołączony do płatności, jest usuwany po około dniu, a plik dołączony do płatności, która nigdy nie została zakończona, jest usuwany po około tygodniu. Nic nie pozostaje na stałe.

Czy klient może dołączyć więcej niż jeden plik?

Każde pole Przesyłania Pliku akceptuje jeden plik. Aby zebrać kilka plików, dodaj pole Przesyłania Pliku dla każdego z nich, ponieważ pole można dodać do formularza tyle razy, ile potrzebujesz. Nadanie każdemu polu własnej etykiety, dozwolonych typów, limitu rozmiaru i etykiety metadanych sprawia również, że rekord płatności jest znacznie łatwiejszy do odczytania niż pojedyncza sterta plików.

Czy to działa z formularzami, które przekierowują do Stripe Checkout?

Tak. Pole jest wyświetlane, a plik jest przesyłany na Twojej stronie, zanim klient zostanie wysłany do Stripe, a adres URL pliku jest zapisywany w wynikowej płatności w ten sam sposób.

Co dalej?

Nadal masz pytania? Jesteśmy tutaj, aby pomóc!

Ostatnio zmodyfikowano:

Zacznij akceptować płatności już dziś

Zacznij akceptować jednorazowe i cykliczne płatności lub darowizny na swojej stronie WordPress.