Codifica per forme di gravità: un’introduzione

Gravity Forms è forse il plugin per la creazione di moduli più noto e migliore per WordPress. Non solo è facile da usare e ha molti componenti aggiuntivi per implementare pagamenti o newsletter nei tuoi moduli. Ma è anche molto flessibile e intuitivo per gli sviluppatori. Personalmente uso e sviluppo con Gravity Forms da almeno 5 anni e non ho mai avuto una funzionalità che non fosse possibile o davvero difficile da sviluppare con Gravity Forms.

Tieni presente che Gravity Forms non è gratuito. Devi acquistare una licenza. Offrono diversi tipi con prezzi diversi per ottenerlo e usarlo. Dopo aver acquistato una licenza, hai anche accesso a una selezione dei loro componenti aggiuntivi, a seconda della licenza acquistata.

Gravity Forms per noi sviluppatori

Gravity Forms offre molti filtri e hook, ma non ci sono modelli che puoi sovrascrivere. Gli hook offrono molta flessibilità agli sviluppatori per estendere e modificare il comportamento di Gravity Forms. Dai un’occhiata alle pagine di documentazione degli sviluppatori di Gravity Forms. La maggior parte, se non tutte, le personalizzazioni verranno eseguite su alcuni oggetti di Gravity Forms; direttamente o tramite la GFAPIclasse Gravity Forms API (). Puoi anche interagire con Gravity Forms utilizzando l’API REST (che estende l’API REST di WordPress ).

Esempi di possibilità per gli sviluppatori sono la modifica degli output dei campi, la modifica dei valori dei campi prima che vengano salvati come lead e la regolazione programmatica delle notifiche e-mail. Altri esempi includono l’aggiunta di impostazioni di moduli personalizzati, la creazione di nuovi tipi di campo e l’inserimento di campi o valori di campo personalizzati in moduli esistenti.

Gravity Forms ha un framework "Componenti aggiuntivi" che ha consentito ad altri sviluppatori di creare componenti aggiuntivi per Gravity Forms propri. E ne sono stati realizzati parecchi. Esempi di componenti aggiuntivi sono l’iscrizione a MailChimp, i gateway di pagamento con Stripe, Hubspot integrazione, sondaggi, quiz, integrazione con Zapier e Dropbox. Quali componenti aggiuntivi sono disponibili dipendono dalla tua licenza. Dai un’occhiata a una panoramica qui.

Rendering di un modulo

L’output di un modulo viene eseguito utilizzando codici brevi, ad esempio:

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

Non preoccuparti, Gravity Forms aggiungerà pulsanti e finestre di dialogo per incorporare moduli di facile utilizzo nei tuoi post. A te o agli editor di contenuti non sarà richiesto di digitare manualmente gli shortcode.

Ma se tu come sviluppatore hai mai bisogno di incorporare un modulo in modo programmatico all’interno di un modello, tutto ciò che devi sapere è l’ID del modulo e quindi semplicemente fare eco allo shortcode. Quando emettiamo uno shortcode in PHP, dobbiamo racchiuderlo all’interno in do_shortcode()modo che WordPress converta correttamente lo shortcode. Gravity Forms gestirà l’aggiunta di tutti gli script e gli stili necessari per te anche quando esegui il rendering di un modulo con PHP.

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

Recupero delle informazioni del modulo

Sono disponibili semplici funzioni API per recuperare informazioni, ad esempio ottenere tutti i moduli o un oggetto modulo specifico. Gli oggetti vengono popolati con tutte le impostazioni inclusi tutti i campi del modulo e puoi anche ottenere tutte le voci del modulo (risposte del modulo). Supponiamo di voler generare un <select>modulo con tutti i moduli pubblicati offrendo all’utente di selezionare tra i moduli pubblicati:

Per seguire buoni standard di codifica, soprattutto considerando che Gravity Forms è un plugin che può essere disattivato o semplicemente non esiste, controlla sempre se esiste una delle classi di Gravity Forms prima di usarle! Prima del codice sopra vorrei aggiungere:

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

Per recuperare l’oggetto di un modulo specifico, tutto ciò che serve è l’ID modulo (1 nel caso seguente):

$form = GFAPI::get_form(1);

Puoi persino manipolare il modulo tramite l’oggetto e quindi aggiornarlo, ad esempio cambiando il titolo del modulo:

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

Recupero dei lead di un modulo (risposte)

Il recupero delle voci di un modulo (risposte del modulo) per l’ID modulo 1 è semplice come:

$entries = GFAPI::get_entries(1);

Puoi anche recuperare una voce specifica con il suo ID e, allo stesso modo dell’aggiornamento del modulo, puoi manipolare l’oggetto voce e chiamare una funzione di aggiornamento su di esso per salvarlo con le tue modifiche. L’esempio seguente salva una stringa vuota sul meta indirizzo IP della voce, nonché il valore del 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);

Tutto quanto sopra è modifiche al livello molto semplice. Resta sintonizzato nella categoria Gravity Forms per ulteriori tutorial e funzionalità di codice più complesse.