Tipuri de Câmpuri pentru Managerul Câmpurilor de Finalizare a Achiziției

Doriți să știți ce tipuri de câmpuri ale managerului de câmpuri de finalizare a comenzii colectează datele de care aveți nevoie? CFM oferă 22 de tipuri de câmpuri, iar acest ghid acoperă ce face fiecare, împreună cu opțiunile pe care le partajează fiecare câmp.

Înainte de a începe, asigurați-vă că Easy Digital Downloads și funcționalitatea Managerului Câmpurilor de Finalizare a Comenzii sunt instalate și activate pe site-ul dvs. WordPress.

⚠️ Cerințe: Managerul de câmpuri de finalizare a comenzii este o funcție Easy Digital Downloads Pro și necesită o licență Professional Pass sau superioară.

Pentru a construi formularul în sine, consultați documentația de configurare a managerului de câmpuri de finalizare a comenzii.

---

Opțiuni Partajate de Fiecare Câmp

Pentru a începe, vom analiza opțiunile care apar pe aproape fiecare tip de câmp, indiferent de cel pe care îl alegeți.

Patru dintre ele se află în partea principală a panoului de câmpuri.  Obligatoriu decide dacă un client poate finaliza comanda fără a răspunde.  Etichetă câmp este textul pe care îl văd.  Text de ajutor apare sub câmp.  Dimensiune setează lățimea de intrare, iar rezultatele variază în funcție de tema dvs.

Găsirea Setărilor Avansate

Restul opțiunilor partajate se află în spatele unei dezvăluiri în interiorul fiecărui câmp. Pentru a le accesa, derulați la Setări avansate în interiorul câmpului și faceți clic pe el pentru a-l extinde.

Extinderea acestuia dezvăluie cinci opțiuni într-un singur loc.

Primul,  Afișare câmp pe frontend la finalizarea comenzii, decide cine vede câmpul. Implicit, acesta este afișat clienților și dvs. Alternativa îl afișează doar în administratorul dvs., care este modul în care stocați datele comenzii pe care un client nu are nevoie să le vadă niciodată.

Cele patru rămase primesc fiecare propria secțiune mai jos.

Alegerea Locului unde sunt Stocate Datele

Unde ar trebui stocate aceste metadate decide cât timp durează un răspuns și cui îi aparține.

Metadate plată atașează răspunsul la o singură comandă. Acesta este implicit și se potrivește oricărui lucru care poate diferi între achiziții.

Metadate utilizator atașează răspunsul la contul clientului, astfel încât aceeași valoare să se aplice fiecărei comenzi pe care o plasează. Este pre-completat la următoarea achiziție, iar clienții îl pot actualiza singuri prin scurtcodul editorului de profil.

⚠️ Cerințe: Evitați să modificați această setare odată ce clienții au început să răspundă la câmp. Răspunsurile salvate anterior sub alegerea anterioară nu vor fi găsite.

Activarea Opțiunii Meta Utilizator

Dacă Metadate utilizator nu apare ca o opțiune, este pentru că clienții de pe magazinul dvs. pot finaliza comanda fără cont. Fără cont, nu există nimic la care să se atașeze răspunsul.

Pentru a schimba asta, accesați Descărcări » Setări » Plăți » Finalizare comandă. Schimbați Înregistrarea clienților în Clienții trebuie să se autentifice sau să creeze un cont pentru a cumpăra.

⚠️ Cerințe: Doar Clienții trebuie să se autentifice sau să creeze un cont pentru a cumpăra deblochează stocarea datelor utilizatorului (User Meta). Înregistrați automat conturi noi de utilizator creează conturi, dar nu face opțiunea disponibilă.

Excluderea unui Câmp din Exporturile Dvs.

Afișare în CSV-uri exportate decide dacă răspunsurile câmpului apar atunci când exportați comenzile. Este activat implicit.

Dezactivarea sa este utilă pentru câmpurile ale căror răspunsuri sunt zgomot într-un spreadsheet, cum ar fi un honeypot sau o notă internă. Răspunsul este stocat în continuare pe comandă oricum.

Setarea Cheii Meta

Cheia Meta este numele sub care răspunsul este stocat în baza dvs. de date. Este, de asemenea, eticheta șablon pe care o utilizați pentru a introduce răspunsul într-un e-mail, astfel încât o cheie meta de company_name devine {company_name} .

Lăsați-l gol și Managerul Câmpurilor de Finalizare va genera unul din eticheta câmpului dvs. Cheile meta nu pot conține spații, așa că folosiți o linie de subliniere sau o cratimă în schimb.

⚠️ Cerințe: Evitați să schimbați o cheie meta după ce clienții au început să răspundă la câmp. Răspunsurile salvate sub vechea cheie nu vor mai fi găsite.

Setarea Opțiunilor de Confidențialitate

Fiecare câmp poartă, de asemenea, propriile Setări de Confidențialitate. Acestea controlează cum este gestionat răspunsul atunci când un client își exercită drepturile de confidențialitate prin instrumentele încorporate ale WordPress.

Afișare câmp în Exportul de Confidențialitate decide dacă răspunsul este inclus atunci când un client solicită o copie a datelor sale. Este activat implicit.

Acțiune Ștergere Date Private decide ce se întâmplă atunci când un client solicită ștergerea. Anonimizare este implicită și amestecă valoarea, ceea ce păstrează rapoartele dvs. intacte. Ștergere o elimină complet, iar Nicio Acțiune o lasă neatinsă.

Unele câmpuri conțin informații personale, cum ar fi Numele de familie sau Adresa de e-mail. Pe acestea, controalele sunt predefinite și apar ca o scurtă explicație, mai degrabă decât o setare editabilă.

ℹ️ Notă: Setările de confidențialitate se aplică câmpurilor stocate ca Date de plată (Payment Meta). Câmpurile stocate ca Date utilizator (User Meta) sunt acoperite de gestionarea proprie a datelor utilizatorilor de către WordPress.

---

Cele 22 de Tipuri de Câmpuri de Finalizare a Achiziției

Fiecare tip de mai jos colectează date într-o formă diferită. Acolo unde un tip are opțiuni dincolo de cele comune, acestea sunt notate alături.

Câmpuri Text și Număr

• Text: un câmp de introducere text standard, pe o singură linie. Cea mai comună alegere pentru un răspuns scurt, liber.
• Textarea: o casetă pe mai multe linii. Puteți seta rândurile, coloanele, textul de substituent și o valoare implicită. Oferă, de asemenea, trei moduri: o casetă simplă, un editor bogat complet sau un editor bogat mai mic.
• Email: arată ca un câmp de text, dar acceptă doar o adresă de e-mail validă.
• URL: arată ca un câmp de text, dar acceptă doar o adresă web validă.
• Dată: un selector de date, cu opțiunea de a colecta și o oră. Puteți seta dacă selectorul se deschide la zi, lună sau an.
• Repetare: un câmp de text pe care clientul îl poate duplica de câte ori este necesar, pentru colectarea unei liste de răspunsuri.

Câmpuri de Alegere

• Selectare: un meniu derulant din care clientul alege o opțiune. Setați opțiunile și textul de substituent.
• Multiselectare: același control, dar clientul poate alege mai multe.
• Radio: un set de butoane radio, o singură alegere. Mai bun decât un meniu derulant atunci când doriți ca fiecare opțiune să fie vizibilă.
• Checkbox: un set de casete de selectare, oricare dintre ele poate fi bifată.
• Țară: un meniu derulant cu toate țările. Puteți adăuga sau elimina din listă pentru a construi una personalizată.

Câmpuri Nume și Email Client

Aceste trei există pentru a putea restaura un câmp care a fost șters accidental. Fiecare formular are deja unul și nu puteți adăuga un al doilea.

• Prenume: un câmp de text pentru un prenume, lățime implicită de 40 de caractere. Nu are opțiune de cheie meta.
• Nume de familie: un câmp de text pentru un nume de familie.
• Email utilizator: un câmp text validat ca adresă de email, destinat adresei unui utilizator WordPress. Acesta este un lucru diferit de tipul independent Email de mai sus, pe care îl puteți adăuga de câte ori doriți.

Încărcare fișier

Încărcare fișier permite unui client să atașeze fișiere la comanda sa. Pe lângă opțiunile partajate, puteți seta o dimensiune maximă a fișierului și un număr maxim de fișiere. De asemenea, alegeți ce tipuri de fișiere sunt permise, din aceste grupuri:

• Imagini: jpg, jpeg, gif, png, bmp
• Audio: mp3, wav, ogg, wma, mka, m4a, ra, mid, midi
• Video: avi, divx, flv, mov, ogv, mkv, mp4, m4v, mpg, mpeg, mpe
• PDF: pdf
• Documente Office: doc, ppt, pps, xls, mdb, docx, xlsx, pptx, odt, odp, ods, odg, odc, odb, odf, rtf, txt
• Arhive Zip: zip, gz, gzip, rar, 7z
• Fișiere executabile: exe
• CSV: csv

ℹ️ Notă: Cu funcționalitatea Amazon S3 activă, fișierele încărcate merg într-un folder numit cfm în bucket-ul dvs. S3 în loc.

Câmpuri de Aspect și Conținut

Acestea adaugă structură sau text formularului, mai degrabă decât să colecteze un răspuns, deci niciunul dintre ele nu apare pe confirmarea de plată.

• Secțiune: un separator cu un titlu și o descriere, pentru gruparea unui formular lung în secțiuni lizibile.
• HTML: un titlu plus orice HTML doriți să plasați în formular.
• Termeni și Condiții: un bloc de text plus o căsuță de bifat pe care clientul o bifează pentru a fi de acord.

Câmpuri Anti-Spam

Niciunul dintre acestea nu apare pe confirmarea de plată.

• Honeypot: un câmp invizibil pe care clienții reali nu îl văd niciodată și nu îl completează niciodată. Boții îl completează, iar o trimitere care îl include este respinsă.
• reCAPTCHA: adaugă Google reCAPTCHA v3 la checkout-ul dvs. Necesită o pereche de chei înainte de a funcționa, acoperită în secțiunea următoare.

Câmpuri pentru Dezvoltatori

Niciunul dintre acestea nu apare pe confirmarea de plată.

• Ascuns: un câmp de introducere standard ascuns. Singurele sale opțiuni sunt o cheie meta, o valoare și dacă se aplică pe front-end, în administrator sau în ambele.
• Hook de acțiune: declanșează o acțiune WordPress într-un punct ales al formularului, astfel încât un dezvoltator să poată reda orice dorește acolo. Îi dai un nume de hook și apoi te conectezi la el.

Acțiunea transmite patru argumente: obiectul formularului, ID-ul comenzii, ID-ul utilizatorului și obiectul câmpului. Ambele ID-uri ajung ca -2 când nu se aplică.

add_action( 'hookname', 'my_function_name', 10, 4 );

function my_function_name( $form, $payment_id, $user_id, $field ) {
    // Your code here.
}

ℹ️ Notă: Easy Digital Downloads nu oferă suport pentru dezvoltare personalizată. Dacă aveți nevoie de ajutor, vă recomandăm să angajați un dezvoltator prin Codeable.

---

Configurarea reCAPTCHA

Câmpul reCAPTCHA necesită o pereche de chei înainte de a face orice. Pentru a o adăuga, accesați Downloads » Settings » Extensions » Checkout Fields Manager. Pe acel ecran, completați reCAPTCHA v3 Site Key și reCAPTCHA v3 Secret Key, apoi salvați.

Checkout Fields Manager folosește reCAPTCHA v3, așa că selectați v3 când creați cheile cu Google.

Versiunea 3 evaluează traficul silențios în fundal, ceea ce înseamnă că câmpul reCAPTCHA nu apare niciodată la finalizarea comenzii pentru clienții reali. Este, de asemenea, omis pentru gateway-urile care preiau plata pe propriul site, cum ar fi PayPal.

ℹ️ Notă: Dacă magazinul dvs. are încă o pereche de chei v2 mai veche salvată, acele câmpuri rămân vizibile până când adăugați ambele chei v3. Odată ce salvați o pereche v3, cheile mai vechi sunt eliminate pentru dvs.

---

Câmpuri de Finalizare a comenzii pe care nu le puteți modifica

Două părți ale procesului de finalizare a comenzii sunt în afara razei de acțiune a Checkout Fields Manager și ambele sunt deliberate.

Câmpurile pentru adresa de facturare sunt necesare de gateway-urile de carduri și de sistemul de taxe Easy Digital Downloads, așa că rămân așa cum sunt. Formularul de card de credit în sine este, de asemenea, fix, deoarece gateway-urile depind de apariția acestor câmpuri exact așa cum se așteaptă.

Obținerea valorilor câmpurilor în cod

Majoritatea magazinelor nu au nevoie niciodată de această secțiune. Dacă scopul dvs. este să afișați unui client propriile răspunsuri, activați Afișați informațiile trimise pe Confirmarea Achiziției? în setările Managerului de Câmpuri de Finalizare a Achiziției și ați terminat.

Această secțiune este pentru dezvoltatorii care plasează o valoare undeva unde setarea nu ajunge, cum ar fi o factură, un șablon personalizat sau o integrare terță.

Citirea unei valori

Răspunsurile câmpurilor de finalizare a achiziției sunt stocate ca meta-date ale comenzii, indexate pe Cheia Meta a câmpului. Pentru a citi una, transmiteți ID-ul comenzii, cheia meta și true :

$channel = edd_get_order_meta( $order_id, 'how_did_you_hear', true );

⚠️ Cerințe: Al treilea argument are valoarea implicită false , care returnează un tablou cu fiecare valoare stocată. Setați-l la true pentru valoarea unică pe care o deține un câmp de finalizare a achiziției.

Câmpurile care acceptă mai mult de un răspuns, cum ar fi Casetă de selectare și Multi-selecție, stochează un tablou. Managerul de Câmpuri de Finalizare a Achiziției poate aplatiza unul pentru dvs. și, de asemenea, rezolvă câmpurile încorporate de nume și e-mail la valorile de pe comandă:

$field = EDD_CFM()->fields->get_field( 'how_did_you_hear' );
$value = $field->export_data( $order_id, get_current_user_id() );

Aceasta este aceeași apelare pe care o folosește intern confirmarea achiziției, deci o valoare citită în acest mod corespunde cu ceea ce vede un client.

ℹ️ Notă: Easy Digital Downloads a mutat comenzile în propriile tabele de baze de date începând cu versiunea 3.0, deci get_post_meta() nu mai citește datele comenzii. Orice fragment mai vechi construit pe acesta returnează o valoare goală.

Plasarea unei valori pe chitanță

Pentru a adăuga dvs. o valoare la confirmarea achiziției, utilizați unul dintre acțiunile de chitanță în loc să copiați un șablon în tema dvs. Fiecare dintre ele transmite obiectul comenzii, deci ID-ul comenzii este disponibil ca $order->id :

add_action( 'edd_order_receipt_after_table', 'my_channel_row', 10, 2 );

function my_channel_row( $order, $receipt_args ) {
    $channel = edd_get_order_meta( $order->id, 'how_did_you_hear', true );

    if ( empty( $channel ) ) {
        return;
    }

    echo '<p>' . esc_html__( 'Referral channel:', 'my-plugin' ) . ' ';
    echo esc_html( $channel ) . '</p>';
}

Acțiunile curente sunt edd_order_receipt_before , edd_order_receipt_before_table , edd_order_receipt_order_details , și edd_order_receipt_after_table . Echivalentele mai vechi edd_payment_receipt_* sunt depășite, deci codul nou ar trebui să folosească acțiunile comenzii de mai sus.

ℹ️ Notă: Easy Digital Downloads nu oferă suport pentru dezvoltare personalizată. Dacă aveți nevoie de ajutor, vă recomandăm să angajați un dezvoltator prin Codeable.

Acestea sunt! Acum puteți alege tipul corect de câmp pentru datele de care aveți nevoie și puteți configura opțiunile pe care le partajează fiecare câmp. De asemenea, puteți afișa sau ascunde un câmp pe baza coșului de cumpărături sau a clientului. Pentru aceasta, consultați documentul Checkout Fields Manager conditional logic următor.

Întrebări frecvente despre tipurile de câmpuri ale managerului de câmpuri de finalizare a comenzii