Coding for Gravity Forms: An Introduction

Gravity Forms är kanske den mest välkända och bästa formbyggarplugin för WordPress. Det är inte bara lätt att använda och har massor av tillägg för att implementera betalning eller nyhetsbrev i dina formulär. Men det är också väldigt utvecklarvänligt och flexibelt. Personligen har jag använt och utvecklat med Gravity Forms i minst 5 år – och jag har aldrig haft en funktion som inte varit möjlig eller riktigt svår att utveckla med Gravity Forms.

Tänk på att Gravity Forms inte är gratis. Du måste köpa en licens. De erbjuder flera olika typer med olika priser för att få och använda den. När du har köpt en licens får du också tillgång till ett urval av deras tillägg, beroende på vilken licens du köper.

Gravity Forms för oss utvecklare

Gravity Forms erbjuder många filter och krokar, men det finns inga mallar som du kan åsidosätta. Krokarna erbjuder mycket flexibilitet för utvecklare att utöka och modifiera Gravity Forms beteende. Ta en titt på Gravity Forms dokumentationssidor för utvecklare. De flesta, om inte alla, anpassningar kommer att göras på några av Gravity Forms objekt; antingen direkt eller genom GFAPIklassen Gravity Forms API (). Du kan också interagera med Gravity Forms med REST API (som utökar WordPress REST API ).

Exempel på möjligheter för utvecklare är att modifiera fältutdata, ändra fältvärden innan de sparas som en potentiell kund, och programmässigt justera e-postmeddelanden. Andra exempel inkluderar att lägga till anpassade formulärinställningar, skapa nya fälttyper och injicera anpassade fält eller fältvärden i befintliga formulär.

Gravity Forms har ett "Add-Ons"-ramverk som har gjort det möjligt för andra utvecklare att skapa egna tillägg till Gravity Forms. Och en hel del har gjorts. Exempel på tillägg är MailChimp-registrering, betalningsgateways med Stripe, Hubspot integration, omröstningar, frågesport, Zapier-integration och Dropbox. Vilka tillägg som är tillgängliga beror på din licens. Ta en titt på en översikt här.

Återge ett formulär

Att skriva ut ett formulär görs med kortkoder, t.ex.

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

Oroa dig inte, Gravity Forms kommer att lägga till knappar och dialogrutor för användarvänliga inbäddningsformulär i dina inlägg. Du eller innehållsredigerarna behöver inte skriva kortkoder manuellt.

Men om du som utvecklare någonsin behöver bädda in ett formulär programmässigt i en mall, är allt du behöver veta formulärets ID och sedan helt enkelt eka kortkoden. När vi matar ut en kortkod i PHP måste vi linda in den do_shortcode()så att WordPress konverterar kortkoden ordentligt. Gravity Forms kommer att hantera att lägga till alla nödvändiga skript och stilar åt dig även när du renderar ett formulär med PHP.

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

Hämtar formulärinformation

Det finns enkla API-funktioner tillgängliga för att hämta information, t.ex. att hämta alla formulär eller ett specifikt formulärobjekt. Objekten är ifyllda med alla inställningar inklusive alla fält i formuläret, och du kan även få alla formulärets poster (formulärsvar). Säg att du vill skapa ett <select>med alla publicerade formulär som erbjuder användaren att välja mellan publicerade formulär:

För att följa bra kodningsstandarder, speciellt med tanke på att Gravity Forms är ett plugin som kan avaktiveras eller helt enkelt inte existerar, kontrollera alltid om någon av Gravity Forms klasser finns innan du använder dem! Innan ovanstående kod vill jag lägga till:

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

Allt du behöver för att hämta ett specifikt formulärs objekt är formulär-ID (1 i fallet nedan):

$form = GFAPI::get_form(1);

Du kan till och med manipulera formuläret genom objektet och sedan uppdatera det, till exempel genom att ändra formulärets titel:

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

Hämta ett formulärs potentiella kunder (svar)

Att hämta ett formulärs poster (formulärsvar) för formuläret ID 1 är så enkelt som:

$entries = GFAPI::get_entries(1);

Du kan också hämta en specifik post med dess ID, och på samma sätt som du uppdaterar formuläret kan du manipulera postobjektet och anropa en uppdateringsfunktion på det för att spara det med dina ändringar. Exemplet nedan sparar en tom sträng på postens IP-adress meta, såväl som värdet på fältet 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);

Allt ovan är modifieringar på den mycket grundläggande nivån. Håll ögonen öppna i kategorin Gravity Forms för fler handledningar och mer komplex kodfunktionalitet.