Gestionnaire de champs de paiement – Obtention des métadonnées

L'extension Checkout Fields Manager vous permet de créer des champs personnalisés pour votre formulaire de paiement. Cela facilite la collecte de données auprès de vos clients. Vous pouvez les voir facilement sur la page Historique des paiements, mais que faire si vous souhaitez qu'ils soient imprimés sur le reçu pour que le client les voie ? Ce document vous aidera à y parvenir.

Exemple de boutons radio

Dans cet exemple, nous allons utiliser un champ personnalisé de boutons radio, intitulé « Êtes-vous satisfait de ce processus d'achat ? ». La clé méta pour ce champ a été générée automatiquement sous le nom are_you_happy_with_this_purchase_process, et nous avons simplement proposé une réponse Oui/Non. Voir ci-dessous.

Puisque nous allons afficher ces informations sur le reçu du client, examinons ce modèle. Le modèle que nous voulons s'appelle shortcode-receipt.php. Lisez notre documentation sur la façon de déplacer ce modèle dans votre thème.

Près du début de ce fichier, vous trouverez ce code :

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

ce qui crée un objet pour ce paiement. Dans le reste de ce fichier, nous pouvons maintenant trouver l'ID de ce paiement sous $payment->ID.

Dans l'exemple ci-dessus, la clé méta est are_you_happy_with_this_purchase_process. Maintenant que nous avons à la fois l'ID et la clé méta, nous pouvons obtenir la valeur avec ce code :

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

Note : le « true » dans l'exemple ci-dessus indique que nous attendons une seule valeur de get_post_meta(). Checkout Fields Manager renvoie une seule valeur pour tous les types de champs qu'il propose.

Impression sur le reçu

Dans l'exemple ci-dessus, nous avons obtenu la valeur souhaitée, mais maintenant nous voulons l'afficher joliment sur les reçus. Dans shortcode-receipt.php, vous trouverez un tableau HTML avec un ID CSS de edd_purchase_receipt. Vous pouvez copier ce tableau et modifier les valeurs. Voici un exemple d'en-tête de tableau :

	 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 ) ) ); ?>
    

    

        

        

    
    

Which will look like this:

Points clés

• Pour afficher les réponses des champs personnalisés sur vos reçus, copiez le fichier shortcode-receipt.php dans votre thème et placez votre code à l'intérieur.
• L'obtention des données se fait simplement en appelant get_post_meta() sur la clé méta fournie dans la zone d'administration.
• Toutes les clés de Custom Fields Manager sont stockées comme des valeurs uniques dans la table post_meta.

Note : Easy Digital Downloads ne fournit pas de support pour le codage/développement personnalisé. Si nécessaire, nous vous recommandons d'engager un développeur via Codeable pour effectuer les modifications personnalisées dont vous avez besoin.