Checkout Fields Manager – Ottenere Metadati

L'estensione Checkout Fields Manager ti permette di creare campi personalizzati per il tuo modulo di checkout. Questo rende facile raccogliere dati dai tuoi clienti. Puoi vederli facilmente nella pagina Cronologia pagamenti, ma cosa succede se vuoi che vengano stampati sulla ricevuta affinché il cliente possa vederli? Questo documento ti aiuterà in questo.

Esempio Pulsanti Radio

In questo esempio utilizzeremo un campo personalizzato di pulsanti radio, intitolato “Sei soddisfatto di questo processo di acquisto?”. La chiave meta per questo campo è stata generata automaticamente come are_you_happy_with_this_purchase_process, e abbiamo semplicemente creato un'opzione di risposta Sì/No. Vedi sotto.

Poiché renderizzeremo queste informazioni sulla ricevuta del cliente, diamo un'occhiata a quel template. Il template che vogliamo si chiama shortcode-receipt.php. Leggi la nostra documentazione su come spostare questo template nel tuo tema.

Vicino all'inizio di quel file troverai questo codice:

$payment = get_post( $edd_receipt_args['id'] );

che crea un oggetto per questo pagamento. Nel resto di questo file possiamo ora trovare l'ID per questo pagamento sotto $payment->ID.

Nell'esempio sopra la Chiave Meta è are_you_happy_with_this_purchase_process. Ora che abbiamo sia l'ID che la Chiave Meta possiamo ottenere il valore con questo codice:

get_post_meta( $payment->ID, 'are_you_happy_with_this_purchase_process', true )

Nota: il 'true' nell'esempio sopra indica che ci aspettiamo un singolo valore da get_post_meta(). Checkout Fields Manager restituisce un singolo valore per tutti i tipi di campo che offre.

Stampa sulla Ricevuta

Nell'esempio sopra abbiamo ottenuto il valore che volevamo, ma ora vogliamo renderizzarlo in modo gradevole nelle ricevute. In shortcode-receipt.php troverai una tabella HTML con un ID CSS di edd_purchase_receipt. Puoi copiare questa tabella e cambiare i valori. Ecco un esempio di intestazione di tabella:

	 Then we can print a table row for the above question, like this:
Multi-answer Example

	 Some field types allow for multiple answers from a customer. Check boxes allow the customer to select multiple things for example. This is still stored as a single item in meta data; it’s a single array with multiple key/value pairs.  How it gets rendered is slightly different from above, however.

	 Here’s a custom field asking the customer what their favorite animal is:

	 

	 Rendering it in our HTML table would look like this:
ID, 'favorite_animal', true ) as $animal ) {
            $animals .= '
' . $animal . '
' . "n"; 
        }

	// print out the table row, wrapping the results in unordered list tags, and escaping with wp_kses_post()
    ?>
    

	 As you can see it’s only slightly more complicated than the first example.
Wrapping Up

	 Putting together the two code samples from above, we end up with something like this:

    

        

            

        
    
    




    

    
ID ), 'are_you_happy_with_this_purchase_process', true ) ) ); ?>








    

    






ID, 'favorite_animal', true ) as $animal ) {
                $animals .= '
' . $animal . '
' . "n"; 
            }

        // print out the table row, wrapping the results in unordered list tags, and escaping with wp_kses_post()
        ?>
        

    

        

            

        
    
    


    

        

        
ID ), 'are_you_happy_with_this_purchase_process', true ) ) ); ?>
    

    

        

        

    
    

Che apparirà così:

Punti chiave

• Per visualizzare le risposte dei Campi Personalizzati sulle tue ricevute, copia il file shortcode-receipt.php nel tuo tema e inserisci il tuo codice lì
• Ottenere i dati è semplicemente fare una chiamata a get_post_meta() sulla Chiave Meta fornita nell'area admin
• Tutte le chiavi di Custom Fields Manager sono memorizzate come singole nella tabella post_meta.

Nota: Easy Digital Downloads non fornisce supporto per codice/sviluppo personalizzato. Se necessario, raccomandiamo di assumere uno sviluppatore tramite Codeable per apportare le modifiche personalizzate di cui hai bisogno.