Documentație WP Simple Pay

Documentație, materiale de referință și tutoriale pentru WP Simple Pay

Cum se adaugă un câmp de încărcare fișiere

Timp de citire: 5 minute | Dificultate: Începător

Prezentare generală

Câmpul Încărcare fișier permite unui client să atașeze un fișier atunci când plătește. Acesta acoperă fiecare formular care necesită un document alături de bani: un brief de design pentru o lucrare personalizată, o fotografie pentru o comandă de imprimare, un formular semnat sau o dovadă de eligibilitate pentru o rată redusă.

Clienții pot trage un fișier pe câmp sau pot face clic pentru a alege unul de pe computerul lor. Aceștia văd o bară de progres pentru încărcare, apoi numele fișierului cu un buton pentru a-l elimina și a alege un alt fișier. Odată ce plata este efectuată, fișierul este înregistrat în raport cu acea plată și legat din vizualizarea detaliilor sale în WordPress.

Cerințe preliminare

  • WP Simple Pay Pro (orice nivel)
  • Un formular de plată la care să adăugați câmpul

Pasul 1: Adăugați câmpul de încărcare fișiere

  1. Navigați la WP Simple Pay > Formulare de plată și editați formularul la care doriți să adăugați câmpul.
  2. Faceți clic pe fila Câmpuri formular.
  3. Deschideți meniul derulant pentru câmpuri și alegeți Încărcare fișier.
  4. Faceți clic pe Adăugare câmp.
Alegerea Încărcare fișier din meniul derulant al câmpului formularului

Noul câmp este adăugat în partea de sus a listei de câmpuri. Faceți clic pe titlul său pentru a extinde setările.

Pasul 2: Configurați câmpul

Setările câmpului Încărcare fișier în constructorul de formulare

Fiecare câmp de încărcare fișiere are propriile setări, astfel încât un formular cu două încărcări poate accepta fișiere complet diferite în fiecare.

Etichetă

Textul afișat deasupra câmpului pe formularul dvs. Faceți-l să spună ce doriți, de exemplu „Încărcați grafica dvs.” în loc de doar „Fișier”.

Tipuri de fișiere permise

O listă separată prin virgulă de extensii de fișiere, scrise cu sau fără punctul de început. Lista implicită este:

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

Restrângeți-o la exact ceea ce aveți nevoie. Un magazin de imprimare care preia grafică ar putea folosi .pdf,.png,.tif, în timp ce un formular care colectează un acord semnat ar putea permite doar .pdf.

Lista dvs. nu este cuvântul final. WP Simple Pay acceptă un fișier numai dacă extensia este pe lista dvs. și WordPress însuși permite acel tip de fișier pentru încărcare. Orice în afara acestei suprapuneri este respins, iar fișierele HTML și JavaScript sunt întotdeauna respinse, indiferent de ceea ce tastați aici.

Dimensiune maximă fișier (MB)

Cel mai mare fișier pe care îl va accepta câmpul, în megabytes. Implicit este 10 MB, iar dvs. puteți seta orice valoare de la 1 MB la 100 MB.

Serverul dvs. web are propriul său limită de încărcare, iar numărul mai mic dintre cele două câștigă. Dacă gazda dvs. limitează încărcările la 8 MB, setarea acestui câmp la 50 MB nu ridică acel prag. Cereți gazdei dvs. să ridice limita serverului dacă aveți nevoie de fișiere mai mari.

Obligatoriu

Bifați această opțiune dacă clientul trebuie să atașeze un fișier înainte de a putea plăti. Un câmp obligatoriu fără fișier blochează plata și afișează o eroare pe câmp.

Etichetă metadate Stripe

Un nume scurt (până la 40 de caractere) folosit pentru a identifica acest upload în înregistrările de plată Stripe și în vizualizarea detaliilor tranzacției în WordPress. Nu este afișat clientului.

Introduceți o etichetă aici și un buton Copiere etichetă inteligentă apare sub ea, împreună cu eticheta inteligentă corespunzătoare:

Setarea Etichetă metadate Stripe cu butonul Copiere etichetă inteligentă

Faceți clic pe Copiere etichetă inteligentă pentru a copia o etichetă precum {payment:metadata:artwork_file} în clipboard, gata de lipit într-o pagină de confirmare sau un e-mail. Consultați Utilizarea etichetelor inteligente pentru paginile de confirmare și e-mailuri pentru a vedea unde pot fi utilizate aceste etichete.

Salvați formularul când ați terminat.

Pasul 3: Ce văd clienții dvs.

Pe formularul publicat, câmpul începe ca o zonă de plasare pe care scrie „Trageți și plasați un fișier sau faceți clic pentru a răsfoi”.

Câmpul Încărcare fișier pe un formular de plată publicat

Clientul trage un fișier sau face clic pentru a deschide browserul de fișiere. Fișierul este verificat imediat în raport cu tipurile permise și limita de dimensiune, astfel încât un fișier greșit este refuzat înainte de a se încărca ceva. O bară de progres rulează în timp ce fișierul se transferă, iar apoi câmpul afișează numele fișierului cu un buton de eliminare, astfel încât clientul să poată schimba fișierul.

Câmpul Încărcare fișier afișând un fișier atașat

Două lucruri protejează trimiterea:

  • În timp ce un upload este încă în curs, formularul nu poate fi trimis. Clientul nu plătește niciodată înainte ca fișierul să se fi transferat complet.
  • Dacă un câmp obligatoriu de încărcare fișier este gol, trimiterea afișează o eroare pe câmp și plata nu este încercată.

Unde ajunge fișierul încărcat

Când este creată plata, URL-ul fișierului încărcat este salvat în metadatele Stripe ale acelei plăți, sub numele pe care l-ați setat în Etichetă metadate Stripe. Îl puteți vedea pe plată în panoul dvs. Stripe.

În interiorul WordPress, fișierul apare într-un card Fișiere încărcate în vizualizarea detaliilor plății, listat după eticheta de metadate a câmpului, cu numele original al fișierului ca un link care deschide fișierul. Consultați Cum să utilizați pagina de tranzacții pentru a găsi o plată și a deschide vizualizarea detaliilor acesteia.

Securitate și stocare

Încărcările au loc pe un formular de plată public, deci fiecare verificare este aplicată atât pe server, cât și în browser:

  • Refuz implicit. Tipurile acceptate sunt intersecția dintre lista dvs. permisă și tipurile de fișiere pe care WordPress le permite în sine. HTML și JavaScript sunt întotdeauna excluse, pentru fiecare vizitator.
  • Conținutul real al fișierului este verificat în raport cu extensia sa. Un script redenumit pentru a arăta ca o imagine este respins, nu stocat.
  • Dimensiunea este aplicată de două ori, în raport cu limita câmpului dvs. și cu limita de upload a serverului dvs.
  • Aceeași limită de rate per IP care protejează trimiterile de plăți se aplică și încărcărilor. Un singur vizitator nu poate bombarda punctul final cu fișiere.

Fișierele sunt păstrate într-un folder dedicat, securizat, în directorul de upload-uri WordPress, separat de media obișnuită, iar fiecăruia i se atribuie un nume de fișier generat aleatoriu, astfel încât adresa sa să nu poată fi ghicită.

Aceste fișiere nu sunt menite să fie gestionate manual. Redenumirea, mutarea sau ștergerea unuia rupe legătura înregistrată împotriva plății, iar curățarea automată de mai jos elimină deja fișierele pentru care nimeni nu a plătit.

Curățare automată a încărcărilor abandonate

Un fișier este încărcat în momentul în care clientul îl alege, ceea ce este înainte de a plăti. Un job programat rulează periodic și elimină încărcările care nu au fost plătite niciodată:

  • Fișiere care nu au fost atașate deloc unei plăți, deoarece vizitatorul a ales un fișier și apoi a părăsit formularul. Acestea sunt eliminate după aproximativ o zi.
  • Fișiere atașate unei plăți pe care clientul nu a finalizat-o niciodată, cum ar fi un card respins sau o filă închisă la pasul de plată. Acestea sunt eliminate după aproximativ o săptămână.

Consecința practică este că un checkout abandonat nu lasă fișiere pe serverul dvs. pentru totdeauna. Fișierele aparținând plăților care au fost efectuate efectiv nu sunt atinse niciodată de curățare, inclusiv plățile care au fost ulterior rambursate sau contestate.

Întrebări Frecvente

Ce tipuri de fișiere sunt permise în mod implicit?

PDF, DOC, DOCX, JPG, JPEG, PNG și GIF. Puteți înlocui acea listă cu propria dvs. în setarea Tipuri de fișiere permise.

Am adăugat o extensie la lista permisă și fișierul este încă respins. De ce?

Lista dvs. este intersectată cu tipurile de fișiere pe care WordPress le permite pentru încărcare, iar orice lucru pe care WordPress nu îl permite este eliminat din lista câmpului. Fișierele HTML și JavaScript sunt excluse indiferent de situație. Eroarea afișată pe formular listează extensiile pe care câmpul le acceptă efectiv, ceea ce este cea mai rapidă modalitate de a vedea ce a supraviețuit intersecției.

Un fișier poate fi, de asemenea, respins atunci când extensia sa nu corespunde conținutului său real, de exemplu, un .zip redenumit în .pdf.

Care este cea mai mare dimensiune de fișier pe care o pot permite?

Setarea câmpului acceptă de la 1 MB la 100 MB, cu o valoare implicită de 10 MB. Limita proprie de încărcare PHP a serverului dvs. se aplică suplimentar, iar cea mai mică dintre cele două este cea care este impusă. Dacă gazda dvs. permite încărcări de 8 MB, 8 MB este limita reală, indiferent de ceea ce spune câmpul. Creșterea valorii câmpului peste limita serverului dvs. nu face nimic, așa că cereți gazdei dvs. să crească mai întâi limita serverului.

Fișierele încărcate intră în Biblioteca dvs. media?

Nu, acestea nu sunt stocate alături de media dvs. obișnuită. Ele intră într-un folder dedicat WP Simple Pay în directorul dvs. de încărcări, sub nume de fișiere aleatorii și sunt curățate automat atunci când plata la care aparțin nu a fost finalizată. Tratați-le ca înregistrări de plată, mai degrabă decât ca media de gestionat.

Cum includ fișierul într-o pagină de confirmare sau într-un e-mail?

Setați o Etichetă metadate Stripe pe câmp, faceți clic pe Copiere etichetă inteligentă și lipiți eticheta rezultată {payment:metadata:...} în conținutul paginii de confirmare sau în corpul e-mailului. Eticheta afișează URL-ul fișierului. Vezi Utilizarea etichetelor inteligente pentru paginile de confirmare și e-mailuri și Cum să creați etichete inteligente personalizate pentru câmpurile formularului.

Ce se întâmplă cu fișierul dacă clientul abandonează plata?

Este ștearsă automat. Un fișier care nu a fost niciodată atașat unei plăți este eliminat după aproximativ o zi, iar un fișier atașat unei plăți care nu a fost niciodată finalizată este eliminat după aproximativ o săptămână. Nimic nu rămâne pe termen nedefinit.

Poate un client să atașeze mai mult de un fișier?

Fiecare câmp de încărcare fișier acceptă un singur fișier. Pentru a colecta mai multe fișiere, adăugați un câmp de încărcare fișier pentru fiecare, deoarece câmpul poate fi adăugat la un formular de câte ori aveți nevoie. Atribuirea fiecărui câmp a propriei etichete, tipuri permise, limită de dimensiune și etichetă de metadate face, de asemenea, ca înregistrarea plății să fie mult mai ușor de citit decât ar fi o singură grămadă de fișiere.

Funcționează cu formularele care redirecționează către Stripe Checkout?

Da. Câmpul este afișat și fișierul este încărcat pe site-ul dvs. înainte ca clientul să fie trimis la Stripe, iar URL-ul fișierului este salvat în plata rezultată în același mod.

Ce urmează?

Încă aveți întrebări? Suntem aici pentru a vă ajuta!

Ultima modificare:

Începeți să acceptați plăți astăzi

Începeți să acceptați plăți unice și recurente sau donații pe site-ul dvs. WordPress.