Ce message suppose que vous souhaitez ajouter des fonctionnalit\u00e9s \u00e0 Gravity Forms pour envoyer une demande de publication \u00e0 distance apr\u00e8s chaque soumission de formulaire. Dans la publication distante, vous enverrez des valeurs \u00e0 partir du formulaire, qui sont personnalisables par des param\u00e8tres suppl\u00e9mentaires dans l’\u00e9diteur de formulaire. Des exemples courants de cas o\u00f9 cela serait utile sont la soumission, par exemple, d’un nom et d’un e-mail \u00e0 une liste de newsletter Mailchimp, ou \u00e0 toute autre int\u00e9gration tierce.<\/p>\n
La fa\u00e7on de r\u00e9soudre ce probl\u00e8me en pratique consiste d’abord \u00e0 ajouter des param\u00e8tres personnalis\u00e9s \u00e0 chaque champ, o\u00f9 l’\u00e9diteur peut saisir des noms de cl\u00e9. La cl\u00e9 et leurs valeurs soumises seront envoy\u00e9es \u00e0 une URL tierce apr\u00e8s chaque soumission de formulaire. Nous ajouterons \u00e9galement un param\u00e8tre afin que vous puissiez choisir pour chaque formulaire d’activer ce type de soumission de tiers.<\/p>\n
Tout le code ci-dessous peut \u00eatre plac\u00e9 dans le code de votre th\u00e8me La premi\u00e8re \u00e9tape consiste \u00e0 ajouter l’entr\u00e9e aux champs dans l’\u00e9diteur de champs o\u00f9 vous pouvez saisir le nom de la cl\u00e9 pour cette valeur. Nous inclurons et soumettrons uniquement les valeurs o\u00f9 cette entr\u00e9e a \u00e9t\u00e9 remplie.<\/p>\n Gravity Forms propose des crochets que nous pouvons utiliser pour ajouter des \u00e9l\u00e9ments personnalis\u00e9s dans l’\u00e9diteur de champs. Le nom du hook d\u00e9pend de l’onglet dans lequel vous souhaitez que votre champ apparaisse.<\/p>\n Dans chaque crochet, vous aurez deux param\u00e8tres\u00a0; ID de position et de formulaire. Chaque param\u00e8tre Gravity Forms int\u00e9gr\u00e9 a un num\u00e9ro de position fixe. Vous pouvez comparer ce nombre pour d\u00e9cider pr\u00e9cis\u00e9ment o\u00f9 vous voulez que votre HTML personnalis\u00e9 ou votre entr\u00e9e soit. Lister tous les param\u00e8tres et leur position serait beaucoup trop long dans ce post. Mais Gravity Forms ajoute ses param\u00e8tres par incr\u00e9ments de 5. Par exemple, dans l’onglet G\u00e9n\u00e9ral, le "Libell\u00e9 du champ" est \u00e0 la position 0 et la "Description" est \u00e0 la position 10. Mettre votre code HTML \u00e0 la position 10 le fera appara\u00eetre apr\u00e8s Description. Ne comparez pas la position \u00e0 un nombre qui n’est pas un multiplicateur de 5.<\/p>\n J’ajoute mon champ personnalis\u00e9 dans l’onglet Avanc\u00e9, \u00e0 la position 50, qui se trouve juste apr\u00e8s l’entr\u00e9e "Admin Field Label".<\/p>\n La plupart du code ci-dessus est explicite. J’ajoute du HTML dans le m\u00eame format que celui auquel Gravity Forms s’attendrait \u00e0 ce qu’un param\u00e8tre soit pr\u00e9sent. Cependant, sur l’entr\u00e9e elle-m\u00eame, vous devez fournir une Vous pouvez faire une autre chose facultative avec votre entr\u00e9e ; ajouter une info-bulle. Si vous le souhaitez, ajoutez cet appel de fonction dans le code que vous venez d’ajouter et fournissez une cl\u00e9 (unique) en tant que cha\u00eene\u00a0:<\/p>\n Et puis ajoutez une autre fonction qui s’accroche au filter L’ajout d’une info-bulle est compl\u00e8tement facultatif, mais c’est une bonne fa\u00e7on d’expliquer aux propri\u00e9taires de sites ce que fait cette entr\u00e9e. Modifiez le contenu en fonction de votre fonctionnalit\u00e9.<\/p>\n Vous remarquerez peut-\u00eatre que votre champ n’appara\u00eet dans aucun onglet Avanc\u00e9. En effet, nous devons indiquer \u00e0 Gravity Forms dans quels types de champs nous voulons que cette entr\u00e9e apparaisse. Par d\u00e9faut, elle n’appara\u00eetra dans aucun.<\/p>\n La fa\u00e7on dont nous le faisons est en fait avec Javascript. GravityForms a Javascript qui masque automatiquement tous les param\u00e8tres, puis choisit d’afficher ceux sp\u00e9cifiques en fonction du type de champ. Notre champ est donc l\u00e0, mais Gravity Forms l’a simplement cach\u00e9.<\/p>\n Nous nous accrochons J’ajoute l’entr\u00e9e aux types de champs functions.php<\/code>ou plugin.<\/p>\nAjouter une entr\u00e9e personnalis\u00e9e aux champs<\/h2>\n
Choisir o\u00f9 placer votre entr\u00e9e<\/h3>\n
\n
gform_field_standard_settings<\/code><\/li>\ngform_field_appearance_settings<\/code><\/li>\ngform_field_advanced_settings<\/code><\/li>\n<\/ul>\nadd_action('gform_field_advanced_settings', function($position, $form_id) {\n if ($position == 50) { \/\/ right after Admin Field Label\n ?>\n <li class=\"thirdparty_input_setting field_setting\">\n <label for=\"field_admin_label\">\n <?php _e('Third party input field', 'txtdomain'); ?>\n <\/label>\n <input type=\"text\" id=\"field_thirdparty_input\" onchange=\"SetFieldProperty('thirdPartyInput', this.value);\" class=\"fieldwidth-3\" \/>\n <\/li>\n <?php\n } \n}, 10, 2);<\/code><\/pre>\nonchange<\/code>fonction Javascript. Nous lui disons simplement d’ex\u00e9cuter la fonction de GravityForms pour enregistrer toutes les modifications apport\u00e9es \u00e0 notre entr\u00e9e. La propri\u00e9t\u00e9 que nous fournissons dans SetFieldProperty<\/code>, thirdPartyInput<\/code>, est importante \u00e0 retenir, \u00e0 l’int\u00e9rieur de cette cl\u00e9 est l’endroit o\u00f9 notre entr\u00e9e personnalis\u00e9e sera enregistr\u00e9e dans le tableau de champs de Gravity Forms lors de la soumission.<\/p>\nAjout d’une info-bulle (facultatif)<\/h3>\n
...\n <label for=\"field_admin_label\">\n <?php _e('Third party input field', 'txtdomain'); ?>\n <?php gform_tooltip('form_field_thirdparty_input'); ?>\n <\/label>\n ...<\/code><\/pre>\ngform_tooltips<\/code>, et ajoutez le contenu de votre info-bulle \u00e0 la cl\u00e9 correspondante, comme ceci :<\/p>\nadd_filter('gform_tooltips', function($tooltips) {\n $tooltips['form_field_thirdparty_input'] = __('<h6>Third party input<\/h6>If you want to submit this field to third party, type in key name here. Remember to activate form submission to third party in form settings.', 'txtdomain');\n return $tooltips;\n});<\/code><\/pre>\nD\u00e9finir les types de champ pour ajouter votre entr\u00e9e personnalis\u00e9e<\/h3>\n
gform_editor_js<\/code>et nous devons faire deux choses. Premi\u00e8rement, nous d\u00e9cidons dans quels types de champs l’entr\u00e9e doit appara\u00eetre. Et deuxi\u00e8mement, nous nous assurons que l’entr\u00e9e est remplie avec sa valeur au chargement.<\/p>\ntext<\/code>, textarea<\/code>, email<\/code>, phone<\/code>et number<\/code>. N’oubliez pas de consid\u00e9rer comment vous allez g\u00e9rer les valeurs des champs soumis. Si vous choisissez d’autoriser ce champ, par exemple sur le type de champ de case \u00e0 cocher, vous devez \u00eatre en mesure d’analyser et de g\u00e9rer correctement les valeurs soumises.<\/p>\nadd_action('gform_editor_js', function() {\n ?>\n <script type=\"text\/javascript\">\n \/\/ Add our setting to these field types\n fieldSettings.text += ', .thirdparty_input_setting';\n fieldSettings.textarea += ', .thirdparty_input_setting';\n fieldSettings.email += ', .thirdparty_input_setting';\n fieldSettings.phone += ', .thirdparty_input_setting';\n fieldSettings.number += ', .thirdparty_input_setting';\n\u00a0\n \/\/ Make sure our field gets populated with its saved value\n jQuery(document).on(\"gform_load_field_settings\", function(event, field, form) {\n jQuery(\"#field_thirdparty_input\").val(field[\"thirdPartyInput\"]);\n });\n <\/script>\n <?php\n});<\/code><\/pre>\n
![\"Gravity](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-151326-61e4ca26275b1.png\")
<\/a><\/p>\n