Kodowanie form grawitacyjnych: wprowadzenie

Gravity Forms jest prawdopodobnie najbardziej znaną i najlepszą wtyczką do tworzenia formularzy dla WordPressa. Jest nie tylko łatwy w użyciu i zawiera wiele dodatków do wprowadzania płatności lub biuletynu do formularzy. Ale jest również bardzo przyjazny dla programistów i elastyczny. Osobiście używam i rozwijam z Gravity Forms od co najmniej 5 lat – i nigdy nie miałem funkcji, która nie byłaby możliwa lub naprawdę trudna do opracowania z Gravity Forms.

Pamiętaj, że Gravity Forms nie jest darmowe. Musisz kupić licencję. Oferują kilka różnych typów z różnymi cenami, aby je zdobyć i wykorzystać. Po zakupieniu licencji uzyskasz również dostęp do wybranych dodatków, w zależności od zakupionej licencji.

Formy grawitacyjne dla nas programistów

Gravity Forms oferuje wiele filtrów i haczyków, ale nie ma szablonów, które można nadpisać. Haki oferują programistom dużą elastyczność w rozszerzaniu i modyfikowaniu zachowania Gravity Forms. Zajrzyj na strony dokumentacji programistów Gravity Forms. Większość, jeśli nie wszystkie, dostosowania zostaną wykonane na niektórych obiektach Gravity Forms; bezpośrednio lub przez GFAPIklasę Gravity Forms API (). Możesz także wchodzić w interakcję z Gravity Forms za pomocą REST API (które jest rozszerzeniem REST API WordPressa ).

Przykładowe możliwości dla programistów to modyfikowanie danych wyjściowych pól, zmiana wartości pól przed ich zapisaniem jako lead oraz programowe dostosowywanie powiadomień e-mail. Inne przykłady obejmują dodawanie niestandardowych ustawień formularzy, tworzenie nowych typów pól oraz wstrzykiwanie niestandardowych pól lub wartości pól do istniejących formularzy.

Gravity Forms ma strukturę „Dodatków", która pozwoliła innym programistom na tworzenie własnych dodatków do Gravity Forms. I powstało ich całkiem sporo. Przykładami dodatków są rejestracja w MailChimp, bramki płatności ze Stripe, Hubspot integracja, ankiety, quiz, integracja z Zapier i Dropbox. Dostępne dodatki zależą od posiadanej licencji. Zapoznaj się z przeglądem tutaj.

Renderowanie formularza

Wyprowadzenie formularza odbywa się za pomocą skrótów, np.:

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

Nie martw się, Gravity Forms doda przyciski i okna dialogowe, aby ułatwić użytkownikowi osadzanie formularzy w Twoich postach. Ty ani redaktorzy treści nie będziecie musieli ręcznie wpisywać krótkich kodów.

Ale jeśli jako programista kiedykolwiek będziesz musiał programowo osadzić formularz w szablonie, wszystko, co musisz wiedzieć, to identyfikator formularza, a następnie po prostu powtórz krótki kod. Kiedy wypisujemy krótki kod w PHP, musimy go owinąć, do_shortcode()aby WordPress poprawnie skonwertował krótki kod. Gravity Forms zajmie się dodawaniem wszystkich niezbędnych skryptów i stylów za Ciebie, nawet jeśli renderujesz formularz za pomocą PHP.

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

Pobieranie informacji o formularzu

Dostępne są proste funkcje API do pobierania informacji, np. pobieranie wszystkich formularzy lub jednego konkretnego obiektu formularza. Obiekty są wypełniane wszystkimi ustawieniami, w tym wszystkimi polami w formularzu, a także można uzyskać wszystkie wpisy formularza (odpowiedzi formularza). Załóżmy, że chcesz wygenerować <select>formularz ze wszystkimi opublikowanymi formularzami, umożliwiając użytkownikowi wybór między opublikowanymi formularzami:

Aby postępować zgodnie z dobrymi standardami kodowania, zwłaszcza biorąc pod uwagę, że Gravity Forms to wtyczka, którą można dezaktywować lub po prostu nie istnieć, zawsze sprawdź, czy którakolwiek z klas Gravity Forms istnieje, zanim ich użyjesz! Przed powyższym kodem dodałbym:

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

Do pobrania konkretnego obiektu formularza wystarczy identyfikator formularza (1 w poniższym przypadku):

$form = GFAPI::get_form(1);

Możesz nawet manipulować formularzem poprzez obiekt, a następnie aktualizować go, na przykład zmieniając tytuł formularza:

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

Pobieranie leadów z formularza (odpowiedzi)

Pobranie wpisów formularza (odpowiedzi z formularza) dla identyfikatora formularza 1 jest tak proste, jak:

$entries = GFAPI::get_entries(1);

Można również pobrać określony wpis wraz z jego identyfikatorem iw ten sam sposób, jak w przypadku aktualizacji formularza, można manipulować obiektem wpisu i wywołać na nim funkcję aktualizacji, aby zapisać go wraz ze zmianami. Poniższy przykład zapisuje pusty ciąg w meta adresie IP wpisu, a także wartość pola 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);

Wszystko powyższe to modyfikacje na bardzo podstawowym poziomie. Bądź na bieżąco z kategorią Gravity Forms, aby uzyskać więcej samouczków i bardziej złożone funkcje kodu.