![\"Tutoriel\u00a0:](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153179-61e509df36138.png\")
<\/a><\/p>\nD\u00e9finition des choix par d\u00e9faut personnalis\u00e9s<\/h2>\n
Si vous avez l’habitude d’utiliser, par exemple, des boutons radio ou des cases \u00e0 cocher dans Gravity Forms, vous avez probablement remarqu\u00e9 qu’ils sont accompagn\u00e9s de choix tels que "First Choice", "Second Choice", "Third Choice". Il s’agit du comportement par d\u00e9faut de Gravity Forms si aucun choix n’a \u00e9t\u00e9 enregistr\u00e9 (avant) et cela ne se d\u00e9clenche que sur ces types de champs sp\u00e9cifiques. Mais pour notre type de champ personnalis\u00e9, aucun choix ne sera rempli. Cela le rend un peu lourd, car vous n’obtiendrez pas le bouton "+" pour ajouter un autre choix. Vous devez utiliser le bouton "Ajouter en bloc\/choix pr\u00e9d\u00e9finis", y ajouter des choix, et apr\u00e8s cela, vous avez acc\u00e8s aux boutons "+" pour ajouter des choix. Mais il est facile de d\u00e9finir des choix personnalis\u00e9s – tout ce dont vous avez besoin est de d\u00e9finir une variable de tableau de classepublic $choices<\/code>et Gravity Forms g\u00e9n\u00e9rera automatiquement des choix pr\u00e9d\u00e9finis dans votre champ lorsque vous l’ajouterez \u00e0 vos formulaires.<\/p>\nRemarque: Il s’agit d’une variable de classe, que vous pouvez ajouter en haut de la classe, juste en dessous de public $type<\/code>. Chaque choix doit \u00eatre un tableau, avec le choix comme valeur de la cl\u00e9 ‘ text<\/code>‘.<\/p>\npublic $choices = [\n [ 'text' => 'Food Choice 1' ],\n [ 'text' => 'Food Choice 2' ],\n [ 'text' => 'Food Choice 3' ],\n];<\/code><\/pre>\nGardez \u00e0 l’esprit que si vous avez d\u00e9j\u00e0 ajout\u00e9 le champ au formulaire, il ne remplira pas r\u00e9troactivement les choix. Cela n’entre en vigueur que lorsque vous ajoutez un nouveau champ au formulaire.<\/p>\n
Note<\/strong>: Dans Gravity Forms, il semble possible d’ajouter \u00e9galement les touches ‘ value<\/code>‘ \u00e0 chaque choix. Mais je n’ai pas r\u00e9ussi \u00e0 faire fonctionner cela – les valeurs deviendront automatiquement les m\u00eames que le texte de choix.<\/p>\nD\u00e9finition de la valeur du champ en tant que tableau<\/h2>\n
La prochaine \u00e9tape est assez simple, mais n\u00e9cessaire. Les valeurs par d\u00e9faut des champs dans Gravity Forms sont des cha\u00eenes. Nous avons besoin que la valeur soit un tableau car nous travaillons avec plusieurs entr\u00e9es. Pour ce faire, nous d\u00e9finissons la fonction is_value_submission_array()<\/code>et renvoyons true<\/code>.<\/p>\npublic function is_value_submission_array() {\n return true;\n}<\/code><\/pre>\nCela garantit que nous pouvons travailler correctement avec la valeur saisie de nos multiples entr\u00e9es.<\/p>\n
Rendu de la sortie de champ<\/h2>\n
Lorsqu’il s’agit de rendre la sortie du champ, il y a quelques points \u00e0 prendre en compte.<\/p>\n
Tout d’abord, vous devez choisir entre deux fonctions\u00a0; get_field_input()<\/code>ou get_field_content()<\/code>. Dans la premi\u00e8re m\u00e9thode, Gravity Forms affiche automatiquement l’\u00e9l\u00e9ment de la liste d’emballage, l’\u00e9tiquette, la description et le conteneur du message d’erreur de validation dans votre champ et vous ne contr\u00f4lez que la sortie du champ interne. Avec la deuxi\u00e8me m\u00e9thode, rien de tout cela ne se produit et vous contr\u00f4lez davantage la sortie du champ. Cependant, vous devez afficher manuellement l’\u00e9tiquette, la description et les messages d’erreur. La premi\u00e8re m\u00e9thode, get_field_input()<\/code>, convient parfaitement dans la plupart des cas.<\/p>\nLa deuxi\u00e8me chose \u00e0 savoir est que la fonction de rendu du champ affecte trois emplacements diff\u00e9rents. Les trois sont le rendu de la sortie du champ dans l’interface, l’aper\u00e7u du champ dans l’\u00e9diteur de formulaire et enfin le champ lors de la modification d’une entr\u00e9e. Heureusement, Gravity Forms propose des fonctions pour d\u00e9terminer facilement \u00e0 quelle vue nous en sommes. Habituellement, vous rendrez le champ de la m\u00eame mani\u00e8re dans les trois cas. Mais parce que le rendu d’une grande table avec beaucoup d’entr\u00e9es devient inutilement maladroit dans l’\u00e9diteur de formulaire, j’ai choisi de rendre le champ diff\u00e9remment dans l’\u00e9diteur de formulaire.<\/p>\n
Et enfin, nous devons nous assurer que toutes les entr\u00e9es re\u00e7oivent un name<\/code>attribut appropri\u00e9 afin que Gravity Forms puisse collecter sa valeur lors de la soumission du formulaire. Toutes les entr\u00e9es dans Gravity Forms ont besoin d’ name<\/code>attributs qui suivent cette r\u00e8gle\u00a0: name=\"input_{FIELD_ID}\"<\/code>(les champs \u00e0 s\u00e9lection multiple utilisent un ID suppl\u00e9mentaire, mais nous n’avons pas besoin de nous en pr\u00e9occuper pour notre cas). Nous avons acc\u00e8s au champ ID car il s’agit d’une variable de classe (de GF_Field<\/code>). Mais dans notre cas, nous avons dit \u00e0 Gravity Forms que la valeur est un tableau et non une valeur singuli\u00e8re (\u00e9tape pr\u00e9c\u00e9dente), nous ajoutons donc des crochets apr\u00e8s l’attribut name ; name=\"input_{FIELD_ID}[]\"<\/code>. Ainsi, si le champ a l’ID 4 dans un formulaire, l’attribut name doit \u00eatre " input_4[]<\/code>".<\/p>\nJ’opte pour l’utilisation get_field_input()<\/code>qui vient avec trois param\u00e8tres. Le premier param\u00e8tre est l’objet formulaire, dont nous n’avons pas vraiment besoin pour notre exemple. Le deuxi\u00e8me param\u00e8tre est la valeur actuelle. Il peut s’agir de la valeur du champ \u00e0 partir de $_POST<\/code>laquelle le formulaire a \u00e9t\u00e9 soumis, mais sans succ\u00e8s. Nous pouvons conserver les valeurs soumises pr\u00e9c\u00e9demment. Ou si la fonction est en cours d’ex\u00e9cution lors de la modification d’une entr\u00e9e, la valeur sera la valeur stock\u00e9e \u00e0 partir de la soumission. Nous traiterons la valeur de plus pr\u00e8s plus tard. Et le troisi\u00e8me param\u00e8tre est l’objet d’entr\u00e9e, dont nous n’aurons pas non plus besoin pour notre exemple.<\/p>\nCommen\u00e7ons par impl\u00e9menter get_field_input()<\/code>ce qui attend le rendu final sous forme de cha\u00eene. D\u00e8s le d\u00e9part, je d\u00e9cide de renvoyer une cha\u00eene vide si nous sommes \u00e0 l’int\u00e9rieur de l’\u00e9diteur de formulaire, car je ne veux pas afficher le tableau complet dans cette vue. Nous pouvons utiliser la m\u00e9thode $this->is_form_editor()<\/code>pour v\u00e9rifier si nous sommes ou non dans l’\u00e9dition du formulaire. Vous pouvez choisir d’ignorer cela ou de rendre autre chose si vous souhaitez un aper\u00e7u du champ dans l’\u00e9diteur de formulaire.<\/p>\npublic function get_field_input($form, $value = '', $entry = null) {\n if ($this->is_form_editor()) {\n return '';\n }\n \/\/ .. Rest of code for frontend and edit entry here...\n}<\/code><\/pre>\nL’\u00e9tape suivante consiste \u00e0 cr\u00e9er le code HTML d’un tableau qui boucle sur un tableau de jours pour g\u00e9n\u00e9rer les colonnes et les lignes pour chaque \u00e9l\u00e9ment de cours. Mais parce que nous avons besoin d’acc\u00e9der au tableau de jours (colonnes de table) \u00e0 plusieurs endroits, nous devons le d\u00e9finir comme une variable de classe, le rendant accessible \u00e0 partir de toutes les fonctions qu’il contient. Je d\u00e9finis une variable de classe $delivery_days<\/code>avec un tableau des jours pour lesquels je souhaite proposer la livraison.<\/p>\nclass FoodDelivery extends GF_Field {\n public $type = 'food_delivery';\n\u00a0\n private $delivery_days = ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday'];\n\u00a0\n public function get_form_editor_field_title() {\n ...\n}<\/code><\/pre>\nC’est juste un exemple! Vous voudrez peut-\u00eatre r\u00e9cup\u00e9rer le tableau pour les colonnes d’un autre endroit qui n’est pas cod\u00e9 en dur.<\/p>\n
Revenons get_field_input()<\/code>et construisons notre table avec des entr\u00e9es. D’abord, je boucle sur la variable de classe et g\u00e9n\u00e8re les en-t\u00eates de tableau. Ensuite, je boucle sur les choix entr\u00e9s dans le champ de r\u00e9glage pour les choix. Ceci est accessible \u00e0 partir de la variable de classe (de GF_Field<\/code>) $this->choices<\/code>. Pour chaque choix, je rends une entr\u00e9e avec les attributs de nom propre. Nous avons acc\u00e8s \u00e0 l’ID du champ \u00e0 partir GF_Field<\/code>de la variable de classe de $this->id<\/code>.<\/p>\npublic function get_field_input($form, $value = '', $entry = null) {\n if ($this->is_form_editor()) {\n return '';\n }\n\u00a0\n $id = (int) $this->id;\n $table = '<table class=\"delivery-table\"><tbody><tr>';\n $table .= '<th>'. __('Course', 'txtdomain'). '<\/th>';\n foreach ($this->delivery_days as $day) {\n $table .= '<th>'. $day. '<\/th>';\n }\n $table .= '<\/tr>';\n\u00a0\n foreach ($this->choices as $course) {\n $table .= '<tr>';\n $table .= '<td>'. $course['text']. '<\/td>';\n foreach ($this->delivery_days as $day) {\n $table .= '<td><input type=\"number\" size=\"1\" name=\"input_'. $id. '[]\" \/><\/td>';\n }\n $table .= '<\/tr>';\n }\n $table .= '<\/tbody><\/table>';\n\u00a0\n return $table;\n}<\/code><\/pre>\nAvec ce code en place, nous devrions obtenir une belle table rendue pour notre type de champ en frontend\u00a0! \u00c9videmment, le HTML d\u00e9pend enti\u00e8rement de vous, ce n’est qu’un exemple de base.<\/p>\n
Nous laissons cette fonction pour l’instant, mais nous y reviendrons plus tard pour g\u00e9rer la valeur soumise !<\/strong><\/p>\nStocker correctement la valeur<\/h2>\n
\u00c0 partir de maintenant, Gravity Forms enregistrera notre champ sous la forme d’un tableau unidimensionnel rempli avec les valeurs saisies et les cha\u00eenes vides o\u00f9 l’entr\u00e9e \u00e9tait vide. Il n’y a aucune information sur le jour ou le choix auquel la valeur appartient, autre que l’index. Nous devons transformer ce tableau unidimensionnel en un tableau associatif multidimensionnel o\u00f9 nous stockons le jour et l’\u00e9tiquette de choix. Nous pouvons alors facilement acc\u00e9der \u00e0 la valeur num\u00e9rique stock\u00e9e, par exemple $value['Ham sandwich']['Monday']<\/code>. Apr\u00e8s cette transformation de tableau, nous devons \u00e9galement s\u00e9rialiser le tableau afin que Gravity Forms puisse stocker correctement la valeur dans la base de donn\u00e9es.<\/p>\nNous devrons transformer ce tableau de valeurs \u00e0 plusieurs endroits, je d\u00e9finirai donc une fonction distincte pour cela. La fonction accepte le tableau unidimensionnel et le transforme en un tableau multidimensionnel avec les valeurs stock\u00e9es pour les jours et les choix\u00a0:<\/p>\n
private function translateValueArray($value) {\n if (empty($value)) {\n return [];\n }\n $table_value = [];\n $counter = 0;\n foreach ($this->choices as $course) {\n foreach ($this->delivery_days as $day) {\n $table_value[$course['text']][$day] = $value[$counter++];\n }\n }\n return $table_value;\n}<\/code><\/pre>\nCela stockera les noms de jour et les choix directement dans la valeur du champ. Proc\u00e9der ainsi permet de modifier les choix ult\u00e9rieurement sans casser les anciennes entr\u00e9es.<\/p>\n
Passons maintenant au remplacement de la fonction qui g\u00e8re le stockage de la valeur soumise\u00a0; get_value_save_entry()<\/code>. Il est livr\u00e9 avec cinq param\u00e8tres mais nous n’avons besoin que du premier qui est la valeur soumise. \u00c0 l’int\u00e9rieur de la fonction, nous transmettons la valeur \u00e0 notre fonction personnalis\u00e9e ci-dessus, s\u00e9rialisons son retour et renvoyons enfin la nouvelle valeur.<\/p>\npublic function get_value_save_entry($value, $form, $input_name, $lead_id, $lead) {\n if (empty($value)) {\n $value = '';\n } else {\n $table_value = $this->translateValueArray($value);\n $value = serialize($table_value);\n }\n return $value;\n}<\/code><\/pre>\n\u00c0 ce stade, Gravity Forms stockera avec succ\u00e8s nos valeurs exactement comme nous les voulons! Cependant, la valeur stock\u00e9e est maintenant un tableau s\u00e9rialis\u00e9 que Gravity Forms se fera un plaisir d’\u00e9cho directement. Nous devons impl\u00e9menter des fonctions pour le transformer d’un vilain tableau s\u00e9rialis\u00e9 en une jolie sortie partout o\u00f9 nous en avons besoin.<\/p>\n
Affichage de la valeur soumise<\/h2>\n
Il y a trois endroits o\u00f9 nous devons changer la sortie de la valeur de notre champ\u00a0; la liste des entr\u00e9es, en regardant une seule entr\u00e9e, et dans les balises de fusion de Gravity Forms. Les balises de fusion sont le plus souvent utilis\u00e9es dans les notifications par e-mail. Par exemple {all_fields}<\/code>, une balise de fusion affiche les valeurs compl\u00e8tes du formulaire soumis dans les e-mails.<\/p>\n\u00c9tant donn\u00e9 que nous rendons la m\u00eame sortie dans trois cas diff\u00e9rents, il est logique de cr\u00e9er une fonction distincte pour celle-ci. J’ai d\u00e9fini une fonction personnalis\u00e9e qui accepte la valeur\u00a0; le tableau multidimensionnel non s\u00e9rialis\u00e9, en param\u00e8tre. La fonction construit ensuite du code HTML qui affiche le tableau de mani\u00e8re jolie et renvoie la cha\u00eene. J’ai opt\u00e9 pour une <ul><\/code>liste imbriqu\u00e9e, mais vous pouvez modifier la sortie comme vous le souhaitez.<\/p>\nprivate function prettyListOutput($value) {\n $str = '<ul>';\n foreach ($value as $course => $days) {\n $week = '';\n foreach ($days as $day => $delivery_number) {\n if (!empty($delivery_number)) {\n $week .= '<li>'. $day. ': '. $delivery_number. '<\/li>';\n }\n }\n \/\/ Only add week if there were any requests at all\n if (!empty($week)) {\n $str .= '<li><h3>'. $course. '<\/h3><ul class=\"days\">'. $week. '<\/ul><\/li>';\n }\n }\n $str .= '<\/ul>';\n return $str;\n}<\/code><\/pre>\nSuper, commen\u00e7ons par le premier: la liste des entr\u00e9es: get_value_entry_list()<\/code>. Vous pouvez choisir de sortir la sortie compl\u00e8te ici, mais cela peut devenir assez maladroit et long pour la vue de liste, j’ai donc opt\u00e9 pour simplement renvoyer une cha\u00eene fixe qui explique que l’utilisateur doit entrer dans les d\u00e9tails de l’entr\u00e9e pour voir la vue d’ensemble compl\u00e8te.<\/p>\npublic function get_value_entry_list($value, $entry, $field_id, $columns, $form) {\n return __('Enter details to see delivery details', 'txtdomain');\n}<\/code><\/pre>\nCela d\u00e9pend bien s\u00fbr enti\u00e8rement de vous, vous pouvez opter pour n’afficher que le premier x nombre de caract\u00e8res par exemple.<\/p>\n
La deuxi\u00e8me fonction est celle affectant la vue d’une seule entr\u00e9eget_value_entry_detail()<\/code>\u00a0:<\/p>\npublic function get_value_entry_detail($value, $currency = '', $use_text = false, $format = 'html', $media = 'screen') {\n $value = maybe_unserialize($value); \n if (empty($value)) {\n return '';\n }\n $str = $this->prettyListOutput($value);\n return $str;\n}<\/code><\/pre>\nNous d\u00e9s\u00e9rialisons simplement le tableau avec la fonction de WordPress [maybe_unserialize](https:\/\/developer.wordpress.org\/reference\/functions\/maybe_unserialize\/)()<\/code>et renvoyons la sortie de cha\u00eene de notre fonction personnalis\u00e9e.<\/p>\nLa derni\u00e8re fonction affecte les balises de fusion et s’assure que la valeur de notre champ s’affiche \u00e9galement bien dans les e-mails\u00a0: get_value_merge_tag()<\/code>.<\/p>\npublic function get_value_merge_tag($value, $input_id, $entry, $form, $modifier, $raw_value, $url_encode, $esc_html, $format, $nl2br) {\n return $this->prettyListOutput($value);\n}<\/code><\/pre>\nNotez que nous n’aurons pas besoin de d\u00e9s\u00e9rialiser la valeur \u00e0 l’int\u00e9rieur de cette fonction.<\/p>\n
Avec ces trois fonctions en place, toutes les valeurs soumises devraient \u00eatre jolies partout\u00a0! Par exemple, lors de l’affichage d’une entr\u00e9e soumise\u00a0:<\/p>\n
![\"Tutoriel\u00a0:](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153179-61e509dbe8f8c.png\")
<\/a><\/p>\nCependant, il manque une chose importante! \u00c0 ce stade, nos entr\u00e9es ne conservent pas les valeurs pr\u00e9c\u00e9demment soumises et c’est plut\u00f4t mauvais.<\/p>\n
Faire en sorte que nos entr\u00e9es conservent la valeur pr\u00e9c\u00e9demment soumise<\/h2>\n
Il existe principalement deux cas o\u00f9 nous devons nous assurer que les entr\u00e9es conservent les valeurs pr\u00e9c\u00e9demment soumises. Le premier cas est lorsqu’une soumission de formulaire a \u00e9chou\u00e9 (par exemple, l’utilisateur a oubli\u00e9 un champ obligatoire). \u00c0 l’heure actuelle, toutes nos entr\u00e9es perdent toutes les valeurs pr\u00e9c\u00e9demment saisies et l’utilisateur doit saisir \u00e0 nouveau toutes les valeurs. Deuxi\u00e8mement, lorsque le propri\u00e9taire du site modifie une entr\u00e9e, les entr\u00e9es ne sont pas renseign\u00e9es avec les valeurs soumises \u00e0 partir de la soumission, ce qui rend quasiment impossible la modification correcte des valeurs.<\/p>\n
Pour r\u00e9soudre ce probl\u00e8me, nous retournons \u00e0 la fonction get_field_input()<\/code>. Le deuxi\u00e8me param\u00e8tre de cette fonction est la valeur. Mais rappelez-vous que cette fonction affecte \u00e0 la fois le rendu frontal et l’\u00e9dition d’entr\u00e9e. Ceci est important car la valeur stock\u00e9e est diff\u00e9rente dans ces deux cas. Si nous sommes \u00e0 l’interface et que nous traitons la soumission du formulaire, la valeur est au format du tableau unidimensionnel mentionn\u00e9 pr\u00e9c\u00e9demment. Et si nous modifions une entr\u00e9e, la valeur est au format d’un tableau multidimensionnel s\u00e9rialis\u00e9. Nous devons donc traduire correctement la valeur fournie dans get_field_input()<\/code>pour acc\u00e9der facilement aux valeurs r\u00e9elles.<\/p>\npublic function get_field_input($form, $value = '', $entry = null) {\n if ($this->is_form_editor()) {\n return '';\n }\n\u00a0\n $id = (int) $this->id;\n if ($this->is_entry_detail()) {\n $table_value = maybe_unserialize($value);\n } else {\n $table_value = $this->translateValueArray($value);\n }\n\u00a0\n $table = '<table class=\"delivery-table\"><tbody><tr>';\n ...\n}<\/code><\/pre>\nDans le code ci-dessus, avant de commencer \u00e0 cr\u00e9er le HTML pour la sortie du champ, nous cr\u00e9ons une variable $table_value<\/code>qui contient la valeur correctement traduite. Nous utilisons GF_Field<\/code>la fonction is_entry_detail()<\/code>de pour v\u00e9rifier si nous modifions ou non une entr\u00e9e. Et puis pour nos entr\u00e9es, il est facile d’acc\u00e9der aux valeurs appropri\u00e9es et de les d\u00e9finir comme value<\/code>attributs des entr\u00e9es\u00a0:<\/p>\n...\nforeach ($this->delivery_days as $day) {\n $table .= '<td><input type=\"number\" size=\"1\" name=\"input_'. $id. '[]\" value=\"'. $table_value[$course['text']][$day]. '\" \/><\/td>';\n}\n...<\/code><\/pre>\nAvec la mise \u00e0 jour ci-dessus get_field_input()<\/code>, toutes nos entr\u00e9es personnalis\u00e9es doivent toujours \u00eatre renseign\u00e9es avec la valeur pr\u00e9c\u00e9dente\u00a0; qu’il s’agisse de modifier une entr\u00e9e ou de r\u00e9essayer de soumettre un formulaire.<\/p>\n\u00c0 ce stade, tout ce qui concerne le rendu et le stockage de nos valeurs est termin\u00e9 et fonctionne pleinement. Mais il y a encore une chose que nous devons absolument corriger.<\/p>\n
Faire passer notre champ de validation "obligatoire"<\/h2>\n
Gravity Forms a des contr\u00f4les pour voir si la valeur d’un champ est vide ou non. Cela est souvent n\u00e9cessaire lorsque le champ est d\u00e9fini comme requis. Lorsqu’un champ est obligatoire, vous ne pouvez pas soumettre le formulaire s’il est vide, n’est-ce pas\u00a0? Le probl\u00e8me pour nous est que nous avons plusieurs entr\u00e9es et nous voulons permettre \u00e0 certaines d’entre elles d’\u00eatre vides. Cela devient un probl\u00e8me si notre champ est d\u00e9fini sur requis. Malheureusement, Gravity Forms interpr\u00e8te mal "est-ce vide" et exige que toutes les entr\u00e9es soient remplies. Nous devons donc ajouter une r\u00e8gle qui dit que si au moins une de nos nombreuses entr\u00e9es est remplie, la valeur totale du champ n’est pas vide.<\/p>\n
La derni\u00e8re fonction que nous devons remplacer dans notre classe est is_value_submission_empty()<\/code>. Nous obtenons uniquement l’ID de formulaire en tant que param\u00e8tre de cette fonction, nous devons donc extraire la valeur du champ en utilisant la fonction Gravity Forms pour l’extraire du $_POST<\/code>tableau\u00a0: rgpost('input_<FIELD ID>')<\/code>. Le retour devrait \u00eatre le tableau unidimensionnel que nous avons vu auparavant. Tout ce que nous avons \u00e0 faire est de parcourir le tableau et de revenir false<\/code>si nous trouvons une valeur quelque part. Sinon on revient true<\/code>car la valeur du champ est en effet compl\u00e8tement vide.<\/p>\npublic function is_value_submission_empty($form_id) {\n $value = rgpost('input_'. $this->id);\n foreach ($value as $input) {\n if (strlen(trim($input)) > 0) {\n return false;\n }\n }\n return true;\n}<\/code><\/pre>\nAvec la fonction ci-dessus en place, notre champ n’\u00e9chouera pas la soumission s’il est d\u00e9fini sur requis et qu’au moins une entr\u00e9e est remplie.<\/p>\n
Conclusion et code final<\/h2>\n
Ce didacticiel vous a montr\u00e9 en d\u00e9tail comment cr\u00e9er votre propre type de champ avanc\u00e9 personnalis\u00e9 pour Gravity Forms. M\u00eame si votre projet est diff\u00e9rent de mon exemple, j’esp\u00e8re que vous avez des conseils et des a-ha en cours de route. Je trouve que la documentation de Gravity Forms fait d\u00e9faut dans certains cas, et c’est le r\u00e9sultat de beaucoup d’essais et d’erreurs\u00a0! En tout cas, j’esp\u00e8re que cela vous a \u00e9t\u00e9 utile !<\/p>\n
Pour r\u00e9f\u00e9rence, voici le code complet dans son int\u00e9gralit\u00e9\u00a0:<\/p>\n
if (class_exists('GF_Field')) {\n class FoodDelivery extends GF_Field {\n public $type = 'food_delivery';\n\u00a0\n public $choices = [\n [ 'text' => 'Food Choice 1' ],\n [ 'text' => 'Food Choice 2' ],\n [ 'text' => 'Food Choice 3' ],\n ];\n\u00a0\n private $delivery_days = ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday'];\n\u00a0\n public function get_form_editor_field_title() {\n return esc_attr__('Food Delivery', 'txtdomain');\n }\n\u00a0\n public function get_form_editor_button() {\n return [\n 'group' => 'advanced_fields',\n 'text' => $this->get_form_editor_field_title(),\n ];\n }\n\u00a0\n public function get_form_editor_field_settings() {\n return [\n 'label_setting',\n 'choices_setting',\n 'description_setting',\n 'rules_setting',\n 'error_message_setting',\n 'css_class_setting',\n 'conditional_logic_field_setting',\n ];\n }\n\u00a0\n public function is_value_submission_array() {\n return true;\n }\n\u00a0\n public function get_field_input($form, $value = '', $entry = null) {\n if ($this->is_form_editor()) {\n return '';\n }\n\u00a0\n $id = (int) $this->id;\n if ($this->is_entry_detail()) {\n $table_value = maybe_unserialize($value);\n } else {\n $table_value = $this->translateValueArray($value);\n }\n\u00a0\n $table = '<table class=\"delivery-table\"><tbody><tr>';\n $table .= '<th>'. __('Course', 'txtdomain'). '<\/th>';\n foreach ($this->delivery_days as $day) {\n $table .= '<th>'. $day. '<\/th>';\n }\n $table .= '<\/tr>';\n\u00a0\n foreach ($this->choices as $course) {\n $table .= '<tr>';\n $table .= '<td>'. $course['text']. '<\/td>';\n foreach ($this->delivery_days as $day) {\n $table .= '<td><input type=\"number\" size=\"1\" name=\"input_'. $id. '[]\" value=\"'. $table_value[$course['text']][$day]. '\" \/><\/td>';\n }\n $table .= '<\/tr>';\n }\n\u00a0\n $table .= '<\/tbody><\/table>';\n\u00a0\n return $table;\n }\n\u00a0\n private function translateValueArray($value) {\n if (empty($value)) {\n return [];\n }\n $table_value = [];\n $counter = 0;\n foreach ($this->choices as $course) {\n foreach ($this->delivery_days as $day) {\n $table_value[$course['text']][$day] = $value[$counter++];\n }\n }\n return $table_value;\n }\n\u00a0\n public function get_value_save_entry($value, $form, $input_name, $lead_id, $lead) {\n if (empty($value)) {\n $value = '';\n } else {\n $table_value = $this->translateValueArray($value);\n $value = serialize($table_value);\n }\n return $value;\n }\n\u00a0\n private function prettyListOutput($value) {\n $str = '<ul>';\n foreach ($value as $course => $days) {\n $week = '';\n foreach ($days as $day => $delivery_number) {\n if (!empty($delivery_number)) {\n $week .= '<li>'. $day. ': '. $delivery_number. '<\/li>';\n }\n }\n \/\/ Only add week if there were any requests at all\n if (!empty($week)) {\n $str .= '<li><h3>'. $course. '<\/h3><ul class=\"days\">'. $week. '<\/ul><\/li>';\n }\n }\n $str .= '<\/ul>';\n return $str;\n }\n\u00a0\n public function get_value_entry_list($value, $entry, $field_id, $columns, $form) {\n return __('Enter details to see delivery details', 'txtdomain');\n }\n\u00a0\n public function get_value_entry_detail($value, $currency = '', $use_text = false, $format = 'html', $media = 'screen') {\n $value = maybe_unserialize($value); \n if (empty($value)) {\n return $value;\n }\n $str = $this->prettyListOutput($value);\n return $str;\n }\n\u00a0\n public function get_value_merge_tag($value, $input_id, $entry, $form, $modifier, $raw_value, $url_encode, $esc_html, $format, $nl2br) {\n return $this->prettyListOutput($value);\n }\n\u00a0\n public function is_value_submission_empty($form_id) {\n $value = rgpost('input_'. $this->id);\n foreach ($value as $input) {\n if (strlen(trim($input)) > 0) {\n return false;\n }\n }\n return true;\n }\n }\n GF_Fields::register(new FoodDelivery());\n}<\/code><\/pre>\nSource d’enregistrement:
awhitepixel.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"Un didacticiel montrant comment cr\u00e9er un type de champ Gravity Forms personnalis\u00e9 avanc\u00e9 avec plusieurs entr\u00e9es avec une gestion sp\u00e9ciale pour stocker et afficher les valeurs.<\/p>\n","protected":false},"author":1,"featured_media":153180,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[893,893,1110,801,801,811,811,841,841,862,862],"tags":[1167],"class_list":["post-234219","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-code-2","category-n-a","category-php-3","category-plugins-2","category-tutoriels","category-wordpress-3","tag-affiai-fr"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/234219","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/comments?post=234219"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/234219\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media\/153180"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media?parent=234219"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/categories?post=234219"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/tags?post=234219"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
![\"Tutoriel\u00a0:](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153179-61e509da5343d.png\")
<\/a><\/p>\n