Kodierung für Gravitationsformen: Eine Einführung

Gravity Forms ist vielleicht das bekannteste und beste Formularerstellungs-Plugin für WordPress. Es ist nicht nur einfach zu bedienen und verfügt über zahlreiche Add-Ons zum Implementieren von Zahlungen oder Newslettern in Ihre Formulare. Aber es ist auch sehr entwicklerfreundlich und flexibel. Persönlich verwende und entwickle ich seit mindestens 5 Jahren mit Gravity Forms – und ich hatte noch nie eine Funktion, die mit Gravity Forms nicht möglich oder wirklich schwierig zu entwickeln war.

Denken Sie daran, dass Gravity Forms nicht kostenlos ist. Sie müssen eine Lizenz erwerben. Sie bieten verschiedene Typen mit unterschiedlichen Preisen an, um es zu bekommen und zu verwenden. Sobald Sie eine Lizenz erworben haben, erhalten Sie auch Zugriff auf eine Auswahl ihrer Add-Ons, je nachdem, welche Lizenz Sie erwerben.

Gravity Forms für uns Entwickler

Gravity Forms bietet viele Filter und Hooks, aber es gibt keine Vorlagen, die Sie überschreiben können. Die Hooks bieten Entwicklern viel Flexibilität, um das Verhalten von Gravity Forms zu erweitern und zu modifizieren. Werfen Sie einen Blick auf die Dokumentationsseiten für Entwickler von Gravity Forms. Die meisten, wenn nicht alle Anpassungen werden an einigen Objekten von Gravity Forms vorgenommen; entweder direkt oder über die GFAPIKlasse Gravity Forms API (). Sie können auch mit Gravity Forms über die REST-API (die die REST-API von WordPress erweitert) interagieren.

Beispielmöglichkeiten für Entwickler sind das Ändern von Feldausgaben, das Ändern von Feldwerten, bevor sie als Lead gespeichert werden, und das programmgesteuerte Anpassen von E-Mail-Benachrichtigungen. Weitere Beispiele sind das Hinzufügen benutzerdefinierter Formulareinstellungen, das Erstellen neuer Feldtypen und das Einfügen benutzerdefinierter Felder oder Feldwerte in vorhandene Formulare.

Gravity Forms verfügt über ein „Add-Ons”-Framework, das es anderen Entwicklern ermöglicht hat, eigene Add-Ons für Gravity Forms zu erstellen. Und es wurden einige erstellt. Beispiele für Add-Ons sind MailChimp-Anmeldung, Zahlungs-Gateways mit Stripe, Hubspot Integration, Umfragen, Quiz, Zapier-Integration und Dropbox. Welche Add-Ons verfügbar sind, hängt von Ihrer Lizenz ab. Sehen Sie sich hier eine Übersicht an.

Rendern eines Formulars

Die Ausgabe eines Formulars erfolgt über Shortcodes, z. B.:

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

Keine Sorge, Gravity Forms fügt Schaltflächen und Dialoge zum benutzerfreundlichen Einbetten von Formularen in Ihre Beiträge hinzu. Sie oder die Inhaltsredakteure müssen Shortcodes nicht manuell eingeben.

Aber wenn Sie als Entwickler jemals ein Formular programmatisch in eine Vorlage einbetten müssen, müssen Sie nur die Formular-ID kennen und dann einfach den Shortcode wiederholen. Wenn wir einen Shortcode in PHP ausgeben, müssen wir ihn einschließen do_shortcode(), damit WordPress den Shortcode richtig konvertiert. Gravity Forms übernimmt das Hinzufügen aller erforderlichen Skripte und Stile für Sie, selbst wenn Sie ein Formular mit PHP rendern.

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

Abrufen von Formularinformationen

Es stehen einfache API-Funktionen zum Abrufen von Informationen zur Verfügung, z. B. zum Abrufen aller Formulare oder eines bestimmten Formularobjekts. Die Objekte werden mit allen Einstellungen gefüllt, einschließlich aller Felder im Formular, und Sie können auch alle Einträge des Formulars (Formularantworten) erhalten. Angenommen, Sie möchten eine <select>mit allen veröffentlichten Formularen generieren, die dem Benutzer die Auswahl zwischen veröffentlichten Formularen bietet:

Um guten Codierungsstandards zu folgen, insbesondere wenn man bedenkt, dass Gravity Forms ein Plugin ist, das deaktiviert werden kann oder einfach nicht existiert, prüfen Sie immer, ob eine der Klassen von Gravity Forms existiert, bevor Sie sie verwenden! Vor dem obigen Code würde ich hinzufügen:

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

Um das Objekt eines bestimmten Formulars abzurufen, benötigen Sie lediglich die Formular-ID (1 im folgenden Fall):

$form = GFAPI::get_form(1);

Sie können das Formular sogar über das Objekt manipulieren und es dann aktualisieren, indem Sie beispielsweise den Titel des Formulars ändern:

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

Abrufen der Leads (Antworten) eines Formulars

Das Abrufen der Formulareinträge (Formularantworten) für die Formular-ID 1 ist so einfach wie:

$entries = GFAPI::get_entries(1);

Sie können auch einen bestimmten Eintrag mit seiner ID abrufen, und auf die gleiche Weise wie beim Aktualisieren des Formulars können Sie das Eintragsobjekt manipulieren und eine Aktualisierungsfunktion darauf aufrufen, um es mit Ihren Änderungen zu speichern. Das folgende Beispiel speichert eine leere Zeichenfolge im IP-Adressen-Meta des Eintrags sowie den Wert des Felds 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);

All dies sind Modifikationen auf der sehr grundlegenden Ebene. Bleiben Sie dran in der Kategorie Gravity Forms für weitere Tutorials und komplexere Codefunktionen.