Codificación de formas de gravedad: una introducción

Gravity Forms es quizás el complemento de creación de formularios más conocido y mejor para WordPress. No solo es fácil de usar y tiene muchos complementos para implementar pagos o boletines informativos en sus formularios. Pero también es muy amigable para los desarrolladores y flexible. Personalmente, he estado usando y desarrollando Gravity Forms durante al menos 5 años, y nunca tuve una función que no fuera posible o realmente difícil de desarrollar con Gravity Forms.

Tenga en cuenta que Gravity Forms no es gratis. Tienes que comprar una licencia. Ofrecen varios tipos diferentes con diferentes precios para obtenerlo y usarlo. Una vez que haya comprado una licencia, también obtendrá acceso a una selección de sus complementos, según la licencia que compre.

Gravity Forms para nosotros los desarrolladores

Gravity Forms ofrece muchos filtros y ganchos, pero no hay plantillas que pueda anular. Los ganchos ofrecen mucha flexibilidad para que los desarrolladores amplíen y modifiquen el comportamiento de Gravity Forms. Eche un vistazo a las páginas de documentación para desarrolladores de Gravity Forms. La mayoría, si no todas, las personalizaciones se realizarán en algunos de los objetos de Gravity Forms; ya sea directamente o a través GFAPIde la clase Gravity Forms API (). También puede interactuar con Gravity Forms usando la API REST (que está extendiendo la API REST de WordPress ).

Las posibilidades de ejemplo para los desarrolladores son modificar los resultados de los campos, cambiar los valores de los campos antes de que se guarden como prospectos y ajustar las notificaciones por correo electrónico mediante programación. Otros ejemplos incluyen agregar configuraciones de formulario personalizadas, crear nuevos tipos de campo e inyectar campos personalizados o valores de campo en formularios existentes.

Gravity Forms tiene un marco de "complementos" que ha permitido a otros desarrolladores crear complementos para Gravity Forms propios. Y se han creado bastantes. Ejemplos de complementos son el registro de MailChimp, las pasarelas de pago con Stripe, Hubspot Integración, encuestas, cuestionario, integración de Zapier y Dropbox. Los complementos disponibles dependen de su licencia. Eche un vistazo a una descripción general aquí.

Renderizar un formulario

La salida de un formulario se realiza mediante códigos abreviados, por ejemplo:

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

No se preocupe, Gravity Forms agregará botones y cuadros de diálogo para incrustar formularios fáciles de usar en sus publicaciones. Ni usted ni los editores de contenido tendrán que escribir códigos abreviados manualmente.

Pero si usted, como desarrollador, alguna vez necesita incrustar un formulario programáticamente dentro de una plantilla, todo lo que necesita saber es la ID del formulario y luego simplemente hacer eco del código abreviado. Cuando generamos un código abreviado en PHP, debemos envolverlo dentro do_shortcode()para que WordPress convierta el código abreviado correctamente. Gravity Forms se encargará de agregar todos los scripts y estilos necesarios incluso cuando renderice un formulario con PHP.

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

Obteniendo información del formulario

Hay funciones API simples disponibles para obtener información, por ejemplo, obtener todos los formularios o un objeto de formulario específico. Los objetos se completan con todas las configuraciones, incluidos todos los campos del formulario, y también puede obtener todas las entradas del formulario (respuestas del formulario). Supongamos que desea generar un correo electrónico <select>con todos los formularios publicados que ofrezca al usuario seleccionar entre los formularios publicados:

Para seguir buenos estándares de codificación, especialmente considerando que Gravity Forms es un complemento que puede desactivarse o simplemente no existir, ¡siempre verifique si alguna de las clases de Gravity Forms existe antes de usarla! Antes del código anterior, agregaría:

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

Para recuperar el objeto de un formulario específico, todo lo que necesita es el ID del formulario (1 en el caso siguiente):

$form = GFAPI::get_form(1);

Incluso puede manipular el formulario a través del objeto y luego actualizarlo, por ejemplo, cambiando el título del formulario:

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

Recuperar los prospectos de un formulario (respuestas)

Recuperar las entradas de un formulario (respuestas de formulario) para el formulario ID 1 es tan simple como:

$entries = GFAPI::get_entries(1);

También puede recuperar una entrada específica con su ID y, de la misma manera que actualiza el formulario, puede manipular el objeto de entrada y llamar a una función de actualización para guardarlo con sus cambios. El siguiente ejemplo guarda una cadena vacía en la meta de la dirección IP de la entrada, así como el valor del ID de campo 2:

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

Todo lo anterior son modificaciones en un nivel muy básico. Estén atentos en la categoría Gravity Forms para obtener más tutoriales y una funcionalidad de código más compleja.