Кодування для форм Gravity: Вступ

Gravity Forms, мабуть, найвідоміший і найкращий плагін для розробки форм для WordPress. Він не тільки простий у використанні та має багато доповнень для впровадження платежів або розсилки новин у ваші форми. Але він також дуже зручний для розробників і гнучкий. Особисто я використовую та розробляю за допомогою Gravity Forms принаймні 5 років – і у мене ніколи не було функції, яку було б неможливо або дуже важко розробити за допомогою Gravity Forms.

Майте на увазі, що Gravity Forms не є безкоштовним. Ви повинні придбати ліцензію. Вони пропонують кілька різних типів з різними цінами, щоб отримати та використовувати його. Після придбання ліцензії ви також отримуєте доступ до вибору їхніх доповнень, залежно від того, яку ліцензію ви купуєте.

Gravity Forms для нас, розробників

Gravity Forms пропонує багато фільтрів і хуків, але немає шаблонів, які можна змінити. Хуки пропонують розробникам велику гнучкість для розширення та зміни поведінки Gravity Forms. Перегляньте сторінки документації для розробників Gravity Forms. Більшість, якщо не всі, налаштування буде виконано на деяких об’єктах Gravity Forms; безпосередньо або через GFAPIклас Gravity Forms API (). Ви також можете взаємодіяти з Gravity Forms за допомогою REST API (який розширює REST API WordPress ).

Прикладом можливостей для розробників є зміна вихідних даних полів, зміна значень полів до того, як їх буде збережено як потенційний клієнт, і програмне налаштування сповіщень електронною поштою. Інші приклади включають додавання настроюваних налаштувань форми, створення нових типів полів і введення настроюваних полів або значень полів у існуючі форми.

Gravity Forms має структуру «додатків», яка дозволяє іншим розробникам створювати власні додатки до Gravity Forms. І їх було створено досить багато. Прикладами доповнень є реєстрація в MailChimp, платіжні шлюзи зі Stripe, Hubspot інтеграція, опитування, вікторина, інтеграція Zapier і Dropbox. Доступність додаткових компонентів залежить від вашої ліцензії. Перегляньте огляд тут.

Візуалізація форми

Виведення форми здійснюється за допомогою коротких кодів, наприклад:

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

Не хвилюйтеся, Gravity Forms додасть кнопки та діалогові вікна для зручного вбудовування форм у ваші публікації. Вам або редакторам вмісту не потрібно буде вручну вводити короткі коди.

Але якщо вам, як розробнику, коли-небудь знадобиться програмно вставити форму в шаблон, все, що вам потрібно знати, це ідентифікатор форми, а потім просто повторити короткий код. Коли ми виводимо шорткод у PHP, нам потрібно загорнути його всередину do_shortcode(), щоб WordPress правильно конвертував шорткод. Gravity Forms додасть усі необхідні сценарії та стилі за вас, навіть якщо ви візуалізуєте форму за допомогою PHP.

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

Отримання інформації форми

Існують прості функції API для отримання інформації, наприклад отримання всіх форм або одного конкретного об’єкта форми. Об’єкти заповнюються всіма налаштуваннями, включаючи всі поля у формі, і ви також можете отримати всі записи форми (відповіді форми). Скажімо, ви хочете створити <select>з усіма опублікованими формами, запропонувавши користувачеві вибрати одну з опублікованих форм:

Щоб дотримуватися хороших стандартів кодування, особливо враховуючи, що Gravity Forms є плагіном, який можна дезактивувати або просто не існує, завжди перевіряйте, чи існують будь-які класи Gravity Forms, перш ніж використовувати їх! Перед кодом вище я б додав:

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

Для отримання певного об’єкта форми все, що вам потрібно, це ідентифікатор форми (1 у наведеному нижче випадку):

$form = GFAPI::get_form(1);

Ви навіть можете маніпулювати формою через об’єкт, а потім оновлювати її, наприклад, змінюючи заголовок форми:

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

Отримання потенційних клієнтів (відповідей) форми

Отримати записи форми (відповіді форми) для форми ID 1 так просто:

$entries = GFAPI::get_entries(1);

Ви також можете отримати певний запис із його ідентифікатором, і так само, як оновлюючи форму, ви можете маніпулювати об’єктом запису та викликати для нього функцію оновлення, щоб зберегти його з вашими змінами. У наведеному нижче прикладі зберігається порожній рядок у мета IP-адреси запису, а також значення поля 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);

Все вищесказане є модифікаціями на самому базовому рівні. Слідкуйте за новинами в категорії Gravity Forms, щоб отримати більше посібників і більш складних функцій коду.