Codificação para formas gravitacionais: uma introdução

O Gravity Forms é talvez o plugin construtor de formulários mais conhecido e melhor para WordPress. Além de ser fácil de usar, possui muitos complementos para implementar pagamentos ou newsletters em seus formulários. Mas também é muito amigável ao desenvolvedor e flexível. Pessoalmente, uso e desenvolvo com Gravity Forms há pelo menos 5 anos – e nunca tive um recurso que não fosse possível ou muito difícil de desenvolver com Gravity Forms.

Tenha em mente que o Gravity Forms não é gratuito. Você tem que comprar uma licença. Eles oferecem vários tipos diferentes com preços diferentes para obtê-lo e usá-lo. Depois de comprar uma licença, você também terá acesso a uma seleção de complementos, dependendo da licença adquirida.

Gravity Forms para nós desenvolvedores

O Gravity Forms oferece muitos filtros e ganchos, mas não há modelos que você possa substituir. Os ganchos oferecem muita flexibilidade para os desenvolvedores estenderem e modificarem o comportamento do Gravity Forms. Dê uma olhada nas páginas de documentação dos desenvolvedores do Gravity Forms. A maioria, se não todas as personalizações serão feitas em alguns objetos do Gravity Forms; diretamente ou por meio GFAPIda classe Gravity Forms API (). Você também pode interagir com o Gravity Forms usando a API REST (que está estendendo a API REST do WordPress ).

As possibilidades de exemplo para desenvolvedores são modificar saídas de campo, alterar os valores de campo antes de serem salvos como um lead e ajustar de forma programática as notificações por e-mail. Outros exemplos incluem adicionar configurações de formulário personalizado, criar novos tipos de campo e injetar campos personalizados ou valores de campo em formulários existentes.

Gravity Forms tem uma estrutura de "Add-Ons" que permitiu que outros desenvolvedores criassem Add-Ons para Gravity Forms próprios. E alguns foram feitos. Exemplos de Add-Ons são inscrição no MailChimp, gateways de pagamento com Stripe, Hubspot integração, enquetes, questionário, integração com Zapier e Dropbox. Quais complementos estão disponíveis depende da sua licença. Dê uma olhada em uma visão geral aqui.

Renderizando um formulário

A saída de um formulário é feita usando códigos de acesso, por exemplo:

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

Não se preocupe, o Gravity Forms adicionará botões e caixas de diálogo para incorporar formulários fáceis de usar em suas postagens. Você ou os editores de conteúdo não precisarão digitar os códigos de acesso manualmente.

Mas se você, como desenvolvedor, precisar incorporar um formulário programaticamente dentro de um modelo, tudo o que você precisa saber é o ID do formulário e, em seguida, simplesmente ecoar o código de acesso. Quando produzimos um shortcode em PHP, precisamos envolvê-lo do_shortcode()para que o WordPress converta o shortcode corretamente. Gravity Forms irá lidar com a adição de todos os scripts e estilos necessários para você, mesmo quando você renderiza um formulário com PHP.

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

Buscando informações do formulário

Existem funções de API simples disponíveis para buscar informações, por exemplo, obter todos os formulários ou um objeto de formulário específico. Os objetos são preenchidos com todas as configurações, incluindo todos os campos do formulário, e você também pode obter todas as entradas do formulário (respostas do formulário). Digamos que você queira gerar um <select>com todos os formulários publicados, oferecendo ao usuário a escolha entre os formulários publicados:

Para seguir bons padrões de codificação, principalmente considerando que o Gravity Forms é um plugin que pode ser desativado ou simplesmente não existir, sempre verifique se alguma das classes do Gravity Forms existe antes de usá-las! Antes do código acima eu acrescentaria:

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

Para recuperar o objeto de um formulário específico, tudo o que você precisa é o ID do formulário (1 no caso abaixo):

$form = GFAPI::get_form(1);

Você pode até mesmo manipular o formulário através do objeto e depois atualizá-lo, por exemplo, alterando o título do formulário:

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

Recuperando os leads de um formulário (respostas)

Recuperar as entradas de um formulário (respostas de formulário) para o ID 1 do formulário é tão simples quanto:

$entries = GFAPI::get_entries(1);

Você também pode recuperar uma entrada específica com seu ID e, da mesma forma que atualiza o formulário, pode manipular o objeto de entrada e chamar uma função de atualização para salvá-lo com suas alterações. O exemplo abaixo salva uma string vazia na meta do endereço IP da entrada, bem como o valor do campo 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);

Todos os itens acima são modificações no nível muito básico. Fique ligado na categoria Gravity Forms para mais tutoriais e funcionalidades de código mais complexas.