Codage pour les formes de gravité : une introduction

Gravity Forms est peut-être le plugin de création de formulaires le plus connu et le meilleur pour WordPress. Non seulement il est facile à utiliser et dispose de nombreux modules complémentaires pour implémenter le paiement ou la newsletter dans vos formulaires. Mais il est également très convivial et flexible pour les développeurs. Personnellement, j’utilise et développe avec Gravity Forms depuis au moins 5 ans – et je n’ai jamais eu une fonctionnalité qui n’était pas possible ou vraiment difficile à développer avec Gravity Forms.

Gardez à l’esprit que Gravity Forms n’est pas gratuit. Vous devez acheter une licence. Ils offrent plusieurs types différents avec des prix différents afin de l’obtenir et de l’utiliser. Une fois que vous avez acheté une licence, vous avez également accès à une sélection de leurs modules complémentaires, en fonction de la licence que vous achetez.

Gravity Forms pour nous développeurs

Gravity Forms propose de nombreux filtres et crochets, mais aucun modèle ne peut être remplacé. Les crochets offrent beaucoup de flexibilité aux développeurs pour étendre et modifier le comportement de Gravity Forms. Jetez un œil aux pages de documentation des développeurs de Gravity Forms. La plupart, sinon la totalité, des personnalisations seront effectuées sur certains objets de Gravity Forms ; soit directement, soit via GFAPIla classe Gravity Forms API (). Vous pouvez également interagir avec Gravity Forms à l’aide de l’API REST (qui étend l’API REST de WordPress ).

Des exemples de possibilités pour les développeurs sont la modification des sorties de champ, la modification des valeurs du champ avant qu’elles ne soient enregistrées en tant que piste et l’ajustement par programmation des notifications par e-mail. D’autres exemples incluent l’ajout de paramètres de formulaire personnalisés, la création de nouveaux types de champs et l’injection de champs personnalisés ou de valeurs de champs dans des formulaires existants.

Gravity Forms a un cadre "Add-Ons" qui a permis à d’autres développeurs de créer leurs propres add-ons pour Gravity Forms. Et un certain nombre ont été créés. Des exemples d’add-ons sont l’inscription MailChimp, les passerelles de paiement avec Stripe, Hubspot intégration, sondages, quiz, intégration Zapier et Dropbox. Les modules complémentaires disponibles dépendent de votre licence. Jetez un œil à un aperçu ici.

Rendu d’un formulaire

La sortie d’un formulaire se fait à l’aide de shortcodes, par exemple :

[gravityform id="2" name="Contact us" ajax="true"]

Ne vous inquiétez pas, Gravity Forms ajoutera des boutons et des boîtes de dialogue pour intégrer des formulaires conviviaux dans vos publications. Vous ou les éditeurs de contenu n’aurez pas à saisir manuellement les codes courts.

Mais si vous, en tant que développeur, avez besoin d’intégrer un formulaire par programme dans un modèle, tout ce que vous devez savoir est l’ID du formulaire, puis faites simplement écho au shortcode. Lorsque nous produisons un shortcode en PHP, nous devons l’envelopper à l’intérieur do_shortcode()pour que WordPress convertisse correctement le shortcode. Gravity Forms se chargera d’ajouter tous les scripts et styles nécessaires pour vous, même lorsque vous rendez un formulaire avec PHP.

echo do_shortcode('[gravityform id="2" name="Contact us" ajax="true"]');

Récupération des informations du formulaire

Il existe des fonctions API simples disponibles pour récupérer des informations, par exemple obtenir tous les formulaires ou un objet de formulaire spécifique. Les objets sont remplis avec tous les paramètres, y compris tous les champs du formulaire, et vous pouvez également obtenir toutes les entrées du formulaire (réponses au formulaire). Supposons que vous souhaitiez générer un <select>avec tous les formulaires publiés offrant à l’utilisateur de choisir entre les formulaires publiés :

Pour suivre de bonnes normes de codage, surtout si l’on considère que Gravity Forms est un plugin qui peut être désactivé ou tout simplement ne pas exister, vérifiez toujours si l’une des classes de Gravity Forms existe avant de les utiliser! Avant le code ci-dessus, j’ajouterais:

if (!class_exists('GFAPI')) {
    return;
}
// Do stuff with GFAPI class

Pour récupérer l’objet d’un formulaire spécifique, tout ce dont vous avez besoin est l’ID du formulaire (1 dans le cas ci-dessous) :

$form = GFAPI::get_form(1);

Vous pouvez même manipuler le formulaire via l’objet, puis le mettre à jour, par exemple en modifiant le titre du formulaire :

$form = GFAPI::get_form(1);
$form['title'] = __('New Form Title', 'txtdomain');
GFAPI::update_form($form);

Récupérer les pistes d’un formulaire (réponses)

Récupérer les entrées d’un formulaire (réponses au formulaire) pour l’ID de formulaire 1 est aussi simple que :

$entries = GFAPI::get_entries(1);

Vous pouvez également récupérer une entrée spécifique avec son ID, et de la même manière que la mise à jour du formulaire, vous pouvez manipuler l’objet d’entrée et appeler une fonction de mise à jour dessus pour l’enregistrer avec vos modifications. L’exemple ci-dessous enregistre une chaîne vide sur la méta adresse IP de l’entrée, ainsi que la valeur du champ ID 2 :

$entry_to_change = GFAPI::get_entry(42);
$entry_to_change['ip'] = '';
$entry_to_change['2'] = 'New value';
GFAPI::update_entry($entry_to_change);

Tout ce qui précède est des modifications au niveau très basique. Restez à l’écoute dans la catégorie Gravity Forms pour plus de tutoriels et des fonctionnalités de code plus complexes.