Gestionnaire de champs de paiement – Types de champs

Le but du Gestionnaire de champs de paiement est de vous donner la flexibilité de choisir les données que vous souhaitez collecter auprès de vos clients. Dans cette optique, CFM propose 22 types de champs différents afin que vous puissiez collecter les données de la meilleure façon possible.

Éléments de champ courants

Bien qu'il existe très peu d'options de champ qui apparaissent sur chaque champ, il y en a certaines qui sont présentes sur la plupart des champs. Voici des exemples :

Afficher le champ dans la zone de paiement du front-end

Cette option vous permet d'afficher le champ uniquement dans l'administration ou dans l'administration et le front-end du site. Voici un exemple de champ dans le constructeur configuré pour n'apparaître qu'en back-end.

Voici ce même champ rendu sur la page d'enregistrement du paiement ( Téléchargements → Historique des paiements) :

Ce champ peut être utilisé par l'administrateur tandis que le client n'a jamais besoin de savoir qu'il existe.

Afficher dans les CSV exportés

Vous pouvez choisir d'inclure ou non ce champ dans les CSV exportés

Où ces métadonnées doivent-elles être stockées

Vous pouvez choisir de stocker ces métadonnées dans les Métadonnées de paiement (valeurs différentes pour toutes les commandes d'un utilisateur particulier) ou dans les Métadonnées utilisateur (même valeur pour toutes les commandes d'un utilisateur particulier).

Remarque : Si vous n'avez pas activé « Exiger la connexion » dans vos paramètres, l'option de stockage des données dans les métadonnées utilisateur n'apparaîtra pas car vos utilisateurs n'auront peut-être pas de comptes utilisateur dans lesquels stocker les données. Ce paramètre se trouve en naviguant vers Téléchargements → Paramètres → Divers → Paiement 

Clé de métadonnées

C'est le nom du champ de métadonnées dans lequel vous souhaitez stocker ces données. Si vous le laissez vide lors de la création du champ, un sera créé pour vous en fonction de l'étiquette du champ.

Remarque : Ne modifiez pas la clé de métadonnées après l'avoir créée. Si vous le faites, toutes les données créées avec l'ancienne clé de métadonnées seront perdues.

Remarque : Les clés de métadonnées ne peuvent pas contenir d'espaces. La convention est de remplacer les espaces par un trait de soulignement, mais un trait d'union fonctionnera également.

Nom de classe CSS

Cela vous permet de définir un nom de classe CSS personnalisé juste pour ce champ.

Taille

Tous les champs de type texte ont une option de taille (largeur). Les résultats peuvent varier en fonction du thème utilisé.

Stockage des données dans les métadonnées utilisateur

Comme mentionné ci-dessus, vous avez la possibilité de stocker votre champ soit dans les métadonnées de paiement, soit dans les métadonnées utilisateur.  Toutes les données stockées dans les métadonnées utilisateur seront attachées à l'utilisateur connecté qui effectue l'achat et seront disponibles pour cet utilisateur pour une utilisation future.

Un exemple serait le numéro de téléphone d'un client. Une fois stocké dans les métadonnées utilisateur lors d'une transaction, lorsque ce client revient et effectue une autre transaction tout en étant connecté, son numéro de téléphone serait déjà pré-rempli pour lui.

Le client aura également accès aux champs personnalisés attachés à son utilisateur dans son éditeur de profil, créés par le shortcode [edd_profile_editor].

Note : L'option de stockage des données dans les métadonnées utilisateur n'est disponible que si l'option « Exiger la connexion » est activée dans Téléchargements → Paramètres → Divers → Paiement.

Options de type de champ

Il y a 22 types de champs au choix :

Crochet d'action

Ceci est destiné aux développeurs pour ajouter des éléments dynamiques comme ils le souhaitent. Il offre la possibilité d'ajouter le type d'entrée que vous souhaitez ajouter à ce formulaire. L'image ci-dessous montre ce champ avec un exemple de code utilisant le nom du hook « hookname ».

Exemple de code : 

add_action('{hookname}', 'my_function_name}', 10, 4 ); 
// first param: Form Object 
// second param: Save ID of payment if in scope, else -2 
// third param: Save ID of user if in scope, else -2 
// fourth param: Field Object 
function my_function_name( $form, $payment_id, $user_id, $field ) { 	
// Do whatever you want here 
}

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.

Case à cocher

Crée un ensemble standard de cases à cocher génériques.

Pays

Ce champ vous permet de présenter une liste de pays à l'utilisateur. Les options de champ incluent tous les pays actuels, et vous avez la possibilité d'ajouter ou de supprimer pour créer une liste personnalisée si nécessaire.

Date

Ce champ permet à l'utilisateur final de saisir une date, et éventuellement une heure. Vous pouvez choisir si l'heure peut être saisie, et si la vue de départ doit être Jour, Mois ou Année. 

E-mail

Ce champ ressemble à un champ de texte normal, mais valide la saisie, exigeant une adresse e-mail valide.

Téléchargement de fichier

Ce champ crée un mécanisme de téléchargement de fichiers, et vous permet de définir une taille de fichier maximale, un nombre de fichiers maximal, et vous permet de limiter les types de fichiers à ceux-ci :

• Images (jpg, jpeg, gif, png, bmp)
• Audio (mp3, wav, ogg, wma, mka, m4a, ra, mid, midi)
• Vidéos (avi, divx, flv, mov, ogv, mkv, mp4, m4v, divx, mpg, mpeg, mpe)
• PDF (pdf)
• Documents Office (doc, ppt, pps, xls, mdb, docx, xlsx, pptx, odt, odp, ods, odg, odc, odb, odf, rtf, txt)
• Archives Zip (zip, gz, gzip, rar, 7z)
• Fichiers exécutables (exe)
• CSV (csv)

Prénom

Ce champ crée un champ de texte d'une taille par défaut de 40, et n'inclut pas d'options pour meta_key ou pour les fonctions d'import/export. Vous ne pouvez pas non plus créer plus d'un champ Prénom dans un formulaire.

Caché

Ce champ crée un champ de formulaire caché standard. Il a UNIQUEMENT des options pour meta_key, meta_value, et s'il doit être uniquement en front-end ou en front-end et back-end.

Pot de miel

Ce champ crée un champ vide que seuls les robots peuvent voir, et ils le rempliront.  S'il est rempli, la soumission du formulaire est rejetée. Plus d'informations sur les champs pot de miel.

HTML

Ce champ vous permet de fournir un titre et du HTML arbitraire.

Nom

Ce champ est un champ de texte simple destiné au Nom de famille.

Note : Les formulaires sont livrés avec un champ Nom de famille qui ne peut pas être supprimé, et vous ne pouvez pas en ajouter un second, ce qui signifie que vous n'utiliserez probablement jamais cette option. Parfois, les champs Nom de famille sont supprimés par accident ; cette option vous permet de les restaurer.

Sélection multiple

Ce champ crée une boîte de sélection standard à sélection multiple. Vous pouvez spécifier le texte de sélection par défaut et créer autant d'options que vous le souhaitez.

Radio

Ce champ crée un ensemble standard de boutons radio. Vous pouvez en créer autant que vous le souhaitez.

reCAPTCHA

Ce champ crée un outil reCAPTCHA v3. Pour que reCAPTCHA fonctionne, vous devez insérer votre clé de site et votre clé secrète dans le panneau des paramètres d'EDD. Veuillez naviguer vers la page Téléchargements > Paramètres > Extensions > Gestionnaire de champs de paiement et ajouter vos clés API là-bas.

Si vous n'avez pas de clés reCAPTCHA, vous pouvez les obtenir ici. Assurez-vous que, lorsque vous créez vos clés API, vous sélectionnez reCAPTCHA V3 dans la liste.

reCAPTCHA v3 fonctionne silencieusement, vous ne verrez donc pas ce champ dans votre formulaire de paiement. reCAPTCHA est automatiquement désactivé pour les paiements hors site tels que PayPal.

Répéter

Ce champ crée un champ de texte et offre au client la possibilité d'en créer autant d'autres qu'il le souhaite. Vous trouverez ci-dessous un exemple de la vue front-end.

Séparateur de section

Ce champ crée une séparation de section dans le formulaire. Il permet un titre et une description.

Sélectionner

Ce champ crée un champ de sélection déroulant standard. Il fonctionne exactement comme le champ de sélection multiple ci-dessus, sauf qu'une seule option peut être choisie par le client.

Termes & Cond.

Ce champ vous permet d'imprimer un bloc de HTML contenant les Conditions Générales, et fournit également une case à cocher avec une étiquette que le client doit cliquer pour accepter.

Texte

Ce champ crée un champ de saisie de texte HTML standard.

Zone de texte

Ce champ crée une zone de texte HTML standard. Vous pouvez définir un nombre de colonnes et de lignes, un texte d'espace réservé, une valeur par défaut, et choisir entre une zone de texte simple, une zone de texte enrichie ou une zone de texte Teeny Rich.

URL

Ce champ crée un champ de saisie de texte standard mais valide pour une URL.

E-mail de l'utilisateur

Ce champ crée un champ de saisie de texte standard mais valide pour une adresse e-mail. Il est destiné à recevoir l'adresse e-mail d'un utilisateur WordPress.

Remarque : Similaire au nom de famille, ce champ devrait déjà exister dans votre formulaire, et vous ne pouvez pas en ajouter un second. Cette option n'existe que pour que vous puissiez remplacer votre champ d'e-mail s'il est accidentellement supprimé.

Utilisation générale

Une fois qu'un type de champ est cliqué, il sera ajouté à la colonne principale au centre de l'écran et plusieurs options vous seront présentées pour ce champ. Les options exactes peuvent varier d'un type de champ à l'autre, mais tous les champs partagent quelques options communes :

• Obligatoire : Sélectionnez « Oui » si vous souhaitez que les clients soient obligés de remplir les champs, ou « Non » s'il doit être facultatif.
• Étiquette du champ : Ceci est le texte affiché comme étiquette principale du champ lors du paiement.
• Texte d'aide : Ceci est le texte ajouté sous le champ lors du paiement pour servir d'explication utile sur ce que le client doit saisir.

Une fois que vous avez ajouté tous les champs dont vous avez besoin, cliquez simplement sur le bouton « Enregistrer » situé en haut à droite de l'écran. Une fois enregistrés, vos champs seront maintenant affichés lors du paiement.

Notes importantes :

Il y a quelques champs de paiement qui ne peuvent pas être modifiés par cette extension :

1. Champs d'adresse de facturation. Ceux-ci sont requis par les passerelles de paiement par carte de crédit et par le système de taxes d'EDD, ils ne sont donc pas autorisés à être modifiés.

2. Le formulaire de carte de crédit utilisé par les passerelles de paiement qui traitent les cartes de crédit. Comme il est essentiel que ces champs apparaissent exactement comme prévu par EDD, ces champs ne sont pas autorisés à être modifiés.