Gravity Forms Easy Passthrough - Плагин WordPress

Руководство по настройке Gravity Forms Easy Passthrough для связанных форм WordPress

Gravity Forms Easy Passthrough нужен не для украшения формы и не для очередного общего "улучшения UX". Его задача гораздо практичнее: взять данные из уже отправленной формы Gravity Forms и подставить их в другую форму так, чтобы пользователь не вводил одно и то же второй раз, а администратор не собирал цепочку из хрупких параметров вручную.

В этом руководстве разберём, как спланировать такую связку, что проверить до установки, где настраивается передача данных, когда использовать обычную передачу в текущей сессии, а когда нужен ep_token, почему варианты в выпадающих списках могут не переноситься, как влияет кеширование и как проверить результат без риска для реальных заявок.

Материал написан для владельца сайта, вебмастера или разработчика, который уже работает с Gravity Forms и хочет построить цепочку из нескольких форм: лид-магнит и подробная анкета, заявка и уточняющая форма, регистрация на мероприятие и последующий опрос, черновой запрос и финальная проверка данных. Это руководство не объясняет покупку, лицензию или активацию продукта. Здесь только практическая работа с уже доступным плагином.

Когда передача данных между формами действительно нужна

Самая частая ошибка при внедрении таких решений - начинать с настройки плагина, не описав сценарий. Easy Passthrough полезен, когда первая форма уже создаёт запись, а следующая форма должна использовать часть этой записи как стартовые значения. Если пользователь просто двигается по шагам одной анкеты, иногда достаточно многостраничной формы Gravity Forms. Если нужно сохранить черновик и вернуться позже, ближе по смыслу может быть Save and Continue. Если нужно заполнять варианты из записей, пользователей или базы данных прямо во время ввода, лучше смотреть на динамическое заполнение или GF Populate Anything.

Gravity Forms Easy Passthrough раскрывается там, где есть две или больше отдельные формы, и между ними нужно аккуратно передать уже собранные значения. Отдельные формы удобны, когда у них разные страницы, разные цели, разные уведомления, разные интеграции или разные ответственные команды. Например, короткая форма собирает имя и email, а подробная анкета открывается только тем, кто подтвердил интерес. Или первичная заявка создаёт запись, а письмо через несколько дней ведёт пользователя на форму уточнения, где имя и контакт уже заполнены.

Сценарии, в которых плагин экономит время

Для сайта услуг это может быть связка "быстрый запрос - подробный бриф". Первая форма не пугает пользователя количеством полей, но собирает минимум для связи. Вторая форма получает имя, email, телефон, выбранную услугу и позволяет уточнить бюджет, сроки, вложения и дополнительные комментарии. Пользователь видит, что сайт помнит уже введённые данные, и меньше раздражается от повторного ввода.

Для мероприятий полезна цепочка "регистрация - опрос после события". На этапе регистрации пользователь указывает имя, email, компанию и тип билета. Позже он получает ссылку на форму обратной связи, где эти поля уже заполнены через токен. Администратор получает более чистые ответы, потому что участнику не нужно вспоминать, какой email он использовал при регистрации.

Для внутренних процессов Easy Passthrough помогает строить простые маршруты без полноценной системы согласования. Первая форма может собирать заявку от сотрудника, вторая - уточнение от менеджера, третья - финальную проверку. Такой подход не заменяет большой рабочий процесс с ролями и этапами, но подходит для сайтов, где нужна понятная последовательность форм и минимум пользовательского трения.

Где продукт может быть лишним

Если все данные нужно получить в одной анкете, сначала проверьте многостраничную форму Gravity Forms. Если значения должны меняться вживую, зависеть от выбора пользователя или подтягиваться из записей WordPress, Easy Passthrough не является прямой заменой динамическому заполнению. Если нужно редактировать уже отправленную запись в личном кабинете, лучше сравнить задачу с Entry Blocks, GravityView или другим инструментом фронтенд-редактирования.

Практическое правило: Easy Passthrough выбирают, когда первая форма уже отправлена, запись создана, а следующая отдельная форма должна стартовать с частью этих данных. Если записи ещё нет, это обычно не passthrough-задача.

Как устроена цепочка исходной формы, целевой формы и ep_token

Внутри настройки важно различать две роли. Исходная форма собирает запись, из которой будут браться значения. Целевая форма отображается позже и получает эти значения в свои поля. Настройка создаётся на стороне целевой формы, потому что именно она должна знать, откуда взять данные и в какие поля их положить.

В документации Gravity Wiz описан базовый путь: открыть настройки целевой формы, перейти на вкладку Easy Passthrough, добавить новую конфигурацию, выбрать исходную форму и сопоставить поля. Если названия полей совпадают, часть соответствий может быть выбрана автоматически, но это не повод пропускать проверку. В реальных формах похожие названия часто скрывают разные типы полей, разные варианты выбора или разные правила видимости.

Сессия браузера и токен - не одно и то же

По умолчанию плагин может передавать записи, найденные в текущей пользовательской сессии. Это удобно для короткого сценария: отправили форму A, сразу попали на страницу с формой B, увидели уже заполненные поля. Такой вариант зависит от браузера, вкладки, cookies и кеширования страницы. Для мгновенного перехода после отправки он часто выглядит естественно.

Токен ep_token решает другую задачу. Он привязан к конкретной записи и может использоваться в ссылке, которую пользователь откроет позже, например из письма. В подтверждении или уведомлении можно добавить параметр ep_token={Easy Passthrough Token}. Когда пользователь переходит по ссылке с таким параметром, целевая форма может получить запись, связанную с токеном, и заполнить сопоставленные поля.

Это не значит, что токен можно бездумно рассылать куда угодно. Ссылка с токеном открывает доступ к значениям, которые вы решили передать в целевую форму. Поэтому в таких сценариях особенно важны минимизация передаваемых данных, понятный срок жизни процесса, аккуратные уведомления и проверка, что в форму не попадают лишние персональные или платёжные поля.

Почему field map важнее названий полей

В поле Name может храниться несколько частей имени, у чекбоксов есть значения вариантов, у адреса и телефона есть свои форматы, а у файловых полей отдельная логика. Поэтому сопоставление "поле с таким же названием" нужно считать подсказкой, а не гарантией. Особенно внимательно проверяйте варианты: значения в списках должны совпадать точно, включая регистр. Если в исходной форме вариант называется Premium, а в целевой premium, визуально это почти одно и то же, но для передачи значения это разные варианты.

Сложные поля лучше тестировать отдельно. Начните с имени, email и одного обычного текстового поля. Когда базовая цепочка сработала, добавляйте выпадающий список, чекбоксы, радиокнопки, файлы и скрытые поля. Такой порядок быстрее выявляет, где проблема: в самой цепочке, в токене, в конкретном типе поля или в настройке целевой формы.

Что проверить перед установкой и первым запуском

Подготовка к установке здесь важна не меньше самой установки. Easy Passthrough работает поверх Gravity Forms, поэтому качество результата зависит от структуры форм, их подтверждений, уведомлений, кеша, ролей пользователей и того, какие данные вы вообще разрешаете переносить. Перед включением на рабочем сайте лучше подготовить короткий список проверок и выполнить его на тестовой копии или на закрытой странице.

Минимальный набор условий

• На сайте уже установлен и работает Gravity Forms, а исходная и целевая формы корректно отправляются без Easy Passthrough.
• У администратора есть доступ к настройкам форм и к вкладке плагина в настройках целевой формы.
• Исходная форма создаёт запись, потому что именно запись становится источником значений.
• Целевая форма содержит поля, которые можно безопасно предзаполнить и показать пользователю.
• Страница с целевой формой не обслуживается агрессивным кешем без исключений для форм и cookies.
• Для сценариев через email заранее понятно, куда добавлять ссылку с ep_token и какие данные эта ссылка откроет.

На этом этапе стоит договориться, какие поля не переносятся. Платёжные данные, скрытые служебные значения без необходимости, внутренние комментарии менеджера и поля, которые пользователь не должен видеть, лучше не включать в карту. В документации продукта отдельно указано, что данные из Stripe credit card field не передаются из-за шифрования. Это ограничение не нужно обходить. Если форма связана с оплатой, передавайте только безопасные контекстные данные: имя, email, номер заявки, выбранный пакет, публичный статус.

Подготовьте тестовый сценарий

Не тестируйте первую цепочку на реальном клиенте. Создайте две простые формы. В форме A добавьте Name, Email, одно текстовое поле и один выбор с двумя вариантами. В форме B добавьте такие же поля. На отдельной странице разместите форму B, а в подтверждении формы A настройте переход на эту страницу. После этого уже можно включать Easy Passthrough и проверять, заполняются ли значения.

Если вы планируете последующее письмо, создайте тестовое уведомление только для администратора или тестового адреса. Проверьте ссылку с ep_token в приватном окне браузера. Так вы поймёте, зависит ли результат от текущей сессии, и не спутаете поведение cookies с токеном.

Безопасная проверка: сначала подтвердите передачу 2-3 простых полей, затем добавляйте сложные поля и условную логику. Если начать сразу с длинной анкеты, будет трудно понять, какая часть сломалась.

Установка и первичная проверка в админ-панели WordPress

После установки плагина через обычный механизм WordPress проверьте, что он активен и доступен в среде Gravity Forms. В этом руководстве мы не разбираем покупку, ключи и получение файлов. Для уже имеющегося продукта важнее убедиться, что плагин не просто включён, а реально добавил вкладку настройки к форме.

Откройте Forms, выберите целевую форму и перейдите в её настройки. В списке вкладок должна появиться вкладка Easy Passthrough. Если её нет, не спешите переустанавливать плагин. Сначала проверьте права текущего пользователя, активность Gravity Forms, конфликты role-management или membership-плагинов, а также то, что вы открыли именно настройки формы, а не редактор поля.

Первичная проверка без сложной логики

1. Откройте целевую форму и перейдите в Settings.
2. Выберите вкладку Easy Passthrough.
3. Нажмите Add New и выберите исходную форму.
4. В блоке Map Fields сопоставьте одно поле имени и одно поле email.
5. Сохраните настройки через Save Settings.
6. Отправьте исходную форму как тестовый пользователь.
7. Откройте страницу целевой формы и проверьте, появились ли значения.

Если на этом шаге всё работает, вы получили базовое подтверждение, что плагин активен, цепочка видит запись, а целевая форма может принять значения. Только после этого имеет смысл добавлять больше полей, правила условной передачи и ссылки с токенами.

Что делать, если вкладка не видна

В документации Gravity Wiz указаны отдельные capabilities для доступа к настройкам Easy Passthrough. Поэтому на сайтах с кастомными ролями проблема может быть не в плагине, а в правах. Проверьте под учётной записью администратора, отключите временно role-management-правила на тестовой копии или добавьте нужную capability роли, которая должна управлять формами. Если вкладка появляется у администратора, но не появляется у редактора, это почти наверняка вопрос прав, а не поломка цепочки передачи.

Отдельно проверьте, не скрывают ли настройки плагины членства, клиентские панели или кастомная админка. Такие решения иногда ограничивают видимость пунктов меню и вкладок без явного сообщения об ошибке.

Настройка карты полей, условий и режимов передачи

Главный рабочий экран Gravity Forms Easy Passthrough - это конфигурация на целевой форме. Здесь выбирается исходная форма и строится карта соответствий. Чем точнее карта, тем меньше неожиданных значений попадёт пользователю. В отличие от ручных параметров в URL, здесь не нужно создавать отдельный параметр для каждого поля, но ответственность за правильное сопоставление остаётся.

Как выбирать поля для переноса

Начинайте с полей, которые нужны пользователю для продолжения. Имя, email, телефон, выбранная услуга, номер заявки, тип мероприятия, организация и город обычно безопаснее и полезнее, чем длинные внутренние заметки или технические значения. Для каждого поля спросите: "Пользователь должен увидеть это значение в целевой форме? Он должен иметь возможность изменить его? Если значение устарело, что произойдёт?"

Если поле нужно только для интеграции или уведомления, не всегда стоит показывать его в целевой форме. Иногда лучше использовать скрытое или административное поле Gravity Forms, но только если это не создаёт ложного ощущения безопасности. Скрытое поле в HTML не равно секрет. Для чувствительных данных лучше не передавать их в форму вообще.

Особенности choice-based полей

Выпадающие списки, радиокнопки и чекбоксы требуют точного совпадения значений. Визуальная подпись варианта может выглядеть похоже, но передача опирается на значение, которое хранится в записи. Если варианты не совпадают, целевая форма может остаться пустой или выбрать не то. Поэтому для таких полей полезно вести маленькую таблицу соответствий.

Если варианты не проходят, не меняйте сразу весь сценарий. Сначала сравните значения вариантов в исходной и целевой форме, затем проверьте условную логику, потом кеш. В большинстве случаев проблема находится в несовпадении значений или в том, что целевая форма ожидает другой тип поля.

Условная передача записей

Easy Passthrough поддерживает условную логику для конфигурации. Это полезно, когда целевая форма должна получать не любую последнюю запись, а только запись, соответствующую условию. Например, передавать данные только если в исходной форме выбран тип заявки "консультация", или только если пользователь согласился получить follow-up. Условия должны быть понятными и тестируемыми. Если логика зависит от нескольких полей, лучше записать её словами рядом с технической задачей: "передавать только записи с email и подтверждением согласия".

Как не запутаться в нескольких конфигурациях

Если на одной целевой форме несколько настроек Easy Passthrough, назовите их по сценарию, а не по номеру. Внутри команды гораздо проще обсуждать "опрос после регистрации на конференцию", чем "настройка 2". После изменения формы сверяйте карту полей заново: добавление нового поля в исходную форму не означает, что целевая форма автоматически получила правильное соответствие.

Токены, последующие письма и долгие сценарии

Передача через текущую сессию хороша для мгновенного перехода, но слабее в долгих сценариях. Пользователь может закрыть браузер, открыть ссылку с телефона, вернуться через письмо или перейти из CRM-рассылки. Для таких случаев в документации Gravity Wiz описан Easy Passthrough Token. В URL добавляется параметр ep_token, а merge tag {Easy Passthrough Token} подставляет уникальный токен записи.

Классический сценарий выглядит так: форма регистрации собирает имя и email, затем отправляется последующее письмо со ссылкой на форму опроса. В ссылке есть ep_token={Easy Passthrough Token}. Пользователь открывает письмо, переходит на страницу с опросом, а целевая форма уже знает, из какой записи взять имя и email. Такой подход уменьшает ручной ввод и снижает риск опечаток.

Где добавлять параметр

Токен можно использовать в подтверждениях и уведомлениях Gravity Forms. Для обычного перехода после отправки исходной формы проверьте Confirmations у формы A. Для сценария с письмом проверьте Notifications или связанный инструмент рассылки, если токен передаётся в CRM или систему рассылок. В любом случае ссылка должна вести на страницу, где размещена целевая форма, а не на случайную промежуточную страницу без формы.

Правильный принцип: токен нужен там, где целевая форма открывается позже или вне текущей сессии. Если пользователь сразу после отправки формы попадает на следующую страницу, сессии может хватить. Если ссылка уходит в письмо, токен почти всегда надёжнее.

Как не превратить токен в лишний риск

Не передавайте в целевую форму всё подряд. Если ссылка с токеном попадёт другому человеку, он может увидеть значения, которые вы решили подставить. Поэтому для публичных follow-up форм используйте минимальный набор: имя, email, номер заявки, выбранный вариант, контекст события. Не подставляйте поля, которые раскрывают внутреннюю оценку, приватные заметки, административные статусы или данные оплаты.

Если сценарий требует высокой приватности, рассмотрите дополнительную проверку: вход пользователя, одноразовый токен, ручную модерацию или другой инструмент, предназначенный для защищённого личного кабинета. Easy Passthrough удобен для предзаполнения форм, но его не стоит превращать в полноценную систему доступа к личным данным.

Когда нужен User Passthrough

Опция Use logged in user's last submitted entry полезна для сайтов, где пользователи авторизованы и повторно возвращаются к своим формам. В этом режиме можно использовать последнюю отправленную запись текущего пользователя вместо записи из текущей сессии. Это удобно для кабинета клиента или внутренней панели, но требует ясного правила: какая именно форма считается источником и что делать, если у пользователя несколько похожих записей.

Практический пример: лид-форма, подробный бриф и проверка результата

Разберём предметный сценарий. На сайте агентства есть короткая форма "Получить консультацию" и подробная форма "Заполнить бриф". Первая форма должна собрать минимум: имя, email, телефон, услуга. После отправки пользователь попадает на страницу с брифом. Там имя, email, телефон и услуга уже заполнены. Если пользователь не заполняет бриф сразу, администратор может отправить follow-up письмо с токеном, чтобы те же данные подтянулись позже.

Цель примера

Нам нужно уменьшить повторный ввод и не заставлять пользователя снова писать контактные данные. При этом мы не хотим передавать лишние внутренние поля. Целевая форма должна быть полноценной отдельной формой: у неё свои вопросы, своя логика, свои уведомления и своя запись после отправки.

Подготовка

• Форма A: Name, Email, Phone, Service.
• Форма B: такие же контактные поля плюс вопросы брифа, бюджет, сроки и поле для комментария.
• Страница /brief/ содержит форму B и исключена из агрессивного кеша, если кеш мешает формам.
• У администратора есть доступ к Forms и настройкам обеих форм.

Шаги настройки

1. Откройте форму B, потому что именно она должна принять значения.
2. Перейдите в Settings и выберите Easy Passthrough.
3. Создайте новую конфигурацию через Add New.
4. В качестве исходной формы выберите форму A.
5. В Map Fields сопоставьте Name с Name, Email с Email, Phone с Phone, Service с Service.
6. Если услуга выбирается из списка, убедитесь, что значения вариантов в обеих формах совпадают.
7. Сохраните конфигурацию через Save Settings.
8. В подтверждении формы A настройте переход на страницу с формой B.

Для мгновенного перехода после отправки может хватить сессионной передачи. Для письма добавьте ссылку на страницу брифа с параметром ep_token={Easy Passthrough Token} в уведомление или инструмент последующей рассылки. Не смешивайте оба варианта в одной проверке: сначала протестируйте переход сразу после отправки, затем отдельно ссылку из письма.

Ожидаемый результат

После отправки формы A пользователь открывает форму B и видит заполненные контактные поля. Он может проверить данные, исправить телефон или email, если вы оставили поля редактируемыми, и продолжить заполнять подробный бриф. Администратор получает отдельную запись формы B, в которой есть как перенесённые контактные значения, так и новые ответы.

Нюанс с редактируемостью полей

Если пользователь не должен менять перенесённые значения, не решайте это только стилем CSS. Лучше оценить, можно ли использовать read-only подход через соответствующий инструмент Gravity Wiz или штатные настройки видимости, если они подходят вашему процессу. Если поле просто скрыть, пользователь не увидит, что именно было подставлено. Если оставить поле редактируемым, он сможет исправить опечатку. Выбор зависит от задачи: для брифа редактирование часто полезно, для служебного ID заявки - нет.

Как проверить, что всё работает и не ломается кешем

Проверка результата должна быть отдельным этапом, а не беглым взглядом на заполненную форму. Easy Passthrough находится между записью Gravity Forms, браузером пользователя, возможным токеном, кешем страницы и настройками целевой формы. Если хотя бы один элемент цепочки ведёт себя иначе, чем ожидалось, результат может выглядеть как "поля пустые", хотя причина находится не в карте полей.

Базовый чек-лист после настройки

1. Отправьте исходную форму в обычном окне браузера и проверьте мгновенный переход.
2. Повторите проверку в приватном окне, чтобы увидеть поведение без старых cookies.
3. Проверьте ссылку с ep_token из тестового письма.
4. Откройте запись исходной формы и убедитесь, что значения действительно сохранены.
5. Откройте целевую форму и убедитесь, что все сопоставленные поля существуют и не удалены.
6. Проверьте каждый вариант choice-based поля, а не только один удачный вариант.
7. Временно отключите кеш страницы или исключите страницу целевой формы, если значения пропадают случайно.
8. Проверьте уведомления целевой формы, чтобы перенесённые значения попали туда, где они нужны.

Кеширование особенно важно для неавторизованных пользователей. Документация Gravity Wiz прямо указывает, что Easy Passthrough использует PHP sessions для неавторизованных пользователей, и что агрессивное кеширование может мешать передаче. Если форма иногда работает, а иногда нет, не ограничивайтесь повторным сохранением feed. Проверьте страницу с формой, cookie, исключения кеша и поведение хостинга.

Проверка токена

Для токена не достаточно увидеть, что ссылка "кликается". Проверьте, что ссылка содержит параметр ep_token, что merge tag заменился реальным значением, что целевая страница содержит нужную форму и что значения подтянулись в приватном окне. Если результат работает только в том же браузере, где вы отправляли форму A, возможно, вы видите сессионный passthrough, а не работу токена.

Признак корректной проверки: ссылка из письма открывается в приватном окне, целевая форма заполняется нужными значениями, а после изменения карты полей результат меняется предсказуемо.

Права доступа, файлы и интеграции с другими Perks

У небольшого сайта часто один администратор делает всё сам. У клиентских проектов доступ к формам могут получать редакторы, менеджеры заявок или сотрудники поддержки. В таком случае важно заранее определить, кто может менять Easy Passthrough feeds. Неправильно сопоставленное поле может раскрыть лишнее значение или сломать бизнес-процесс, поэтому доступ к таким настройкам не должен быть случайным.

Gravity Wiz указывает capabilities для просмотра и редактирования настроек Easy Passthrough, доступа к настройкам add-on и удаления. Если вкладка не видна нужной роли, проверьте capabilities. Если вкладка видна слишком широкому кругу людей, сузьте права. Это особенно важно для сайтов с персональными данными, заявками клиентов, медицинскими анкетами, юридическими запросами или внутренними HR-формами.

Файловые поля и GP File Upload Pro

В документации отмечена интеграция с GP File Upload Pro и поддержка передачи файлов из Single и Multi-file Upload fields, включая поля с File Upload Pro. На практике такие сценарии требуют отдельной проверки доступа к файлу. Не достаточно увидеть название файла в форме. Нужно проверить, что пользователь, администратор и уведомления видят файл так, как задумано, а публичная ссылка не раскрывает лишнего.

Если файл не является обязательной частью следующей формы, подумайте, нужно ли его вообще переносить. Для брифа может хватить контактных данных и номера заявки. Для процесса проверки документов файл может быть нужен, но тогда проверяйте права, срок хранения, уведомления и политику удаления.

Совместимость с динамическим заполнением

Gravity Forms умеет динамически заполнять поля через query string, shortcode, block field values и hooks. Это отдельная механика. Easy Passthrough удобен, когда источник - запись другой формы. Если поле в целевой форме одновременно получает значение из Easy Passthrough и из другого механизма динамического заполнения, заранее решите, какой источник должен быть приоритетным. В противном случае пользователь увидит не то значение, которое ожидали.

Для сложных сайтов полезно вести короткую карту источников данных: "это поле приходит из записи формы A", "это поле берётся из URL", "это поле заполняется через hook", "это поле пользователь вводит вручную". Такая карта экономит часы диагностики, когда через полгода кто-то меняет страницу, добавляет кеш или переносит форму в другой редактор.

Почему значения не передаются и как искать причину

Диагностику лучше вести от простого к сложному. Не начинайте с PHP snippets, если не проверена карта полей, источник записи и кеш. Easy Passthrough обычно ломается не "вообще", а в конкретной точке цепочки: нет записи, не тот source form, не совпали values, сессия истекла, токен не передан, страница закеширована или у пользователя нет прав видеть настройки.

Поля целевой формы остаются пустыми

Симптом: пользователь отправляет исходную форму, открывает целевую форму, но значения не появляются. Возможные причины: не создан Easy Passthrough feed, выбрана не та исходная форма, не сохранена карта полей, пользователь открыл страницу без актуальной сессии, ссылка не содержит ep_token.

Проверьте, что исходная форма действительно создала запись. Затем откройте настройки целевой формы и убедитесь, что feed активен. После этого протестируйте один простой текстовый field map. Если простой текст передаётся, проблема не в базовой работе плагина, а в конкретном поле или условии.

Checkbox, Radio Buttons или Drop Down не выбираются

Симптом: имя и email переносятся, но варианты выбора пустые или неверные. Чаще всего значения вариантов не совпадают полностью. Для choice-based полей важны не только видимые подписи, но и values. Они чувствительны к регистру и должны совпадать точно.

Сравните варианты в обеих формах. Если исходная форма использует Consulting, а целевая consulting, приведите values к одному виду и повторите тест. Если поле связано с условной логикой, проверьте, не скрывается ли оно до применения значения.

Ссылка из письма открывает пустую форму

Симптом: мгновенный переход после отправки работает, а письмо не заполняет форму. Вероятная причина - ссылка не содержит корректный ep_token, merge tag не заменился, пользователь попадает не на ту страницу или целевая форма не настроена на источник.

Откройте письмо и посмотрите фактический URL. В нём должен быть параметр ep_token с реальным значением, а не буквальная строка merge tag. Проверьте ссылку в приватном окне. Если приватное окно пустое, а обычное заполнено, значит вы могли видеть сессионную передачу, а не токен.

Передача работает нестабильно

Симптом: у одного пользователя всё работает, у другого нет; иногда значения появляются, иногда пропадают. Проверьте кеш страницы, кеш хостинга, исключения для страницы с формой и cookies. В документации Gravity Wiz отдельно упоминается проблема с WPEngine и необходимость whitelist для cookie gp_easy_passthrough_session в таких условиях.

На уровне WordPress можно временно отключить кеширующий плагин на тестовой копии или исключить страницу целевой формы. Если проблема исчезла, возвращайте кеш постепенно и документируйте исключение. Не оставляйте сайт без кеша целиком, если достаточно исключить одну страницу или cookie.

Вкладка настроек не отображается

Симптом: плагин активен, но в настройках формы нет вкладки Easy Passthrough. Проверьте роль пользователя и capabilities. На сайтах с membership или role-management-плагинами доступ к настройкам может быть скрыт даже при активном плагине.

Проверка проста: зайдите под администратором. Если вкладка появилась, настройте права роли, которая должна управлять формами. Если вкладки нет даже у администратора, проверьте активность Gravity Forms, активность Easy Passthrough и конфликты плагинов на тестовой копии.

Когда лучше откатить настройку

Откатывайте изменение, если целевая форма начала показывать лишние данные, токен открывает больше информации, чем нужно, choice-based поля выбирают неверные значения, или кеш заставляет форму работать непредсказуемо. Самый безопасный откат - временно отключить конкретный Easy Passthrough feed, а не удалять форму и не переписывать все подтверждения. После исправления карты полей включите feed снова и повторите тесты.

Безопасные улучшения без правки ядра плагина

Для Easy Passthrough часто хочется "добавить чуть-чуть логики": требовать токен, сохранять токен в поле, удалять токен после использования, переносить consent field или обновлять существующую запись вместо создания новой. У Gravity Wiz есть отдельная Snippet Library для таких случаев. Это хороший путь, потому что snippets опираются на документированные hooks продукта и не требуют правки ядра плагина.

Но snippet - не универсальная таблетка. Если вы не понимаете, какие формы и поля он затрагивает, не ставьте его на рабочий сайт. Сначала ответьте на три вопроса: какая форма является источником, какая форма является целью, какое поле или токен меняется. Затем проверьте snippet на тестовой копии, зафиксируйте, куда он добавлен, и подготовьте простой откат: отключить snippet в Code Snippets или удалить его из собственного мини-плагина.

Когда использовать официальные snippets

• Нужно запретить передачу без ep_token и оставить только token-based сценарий.
• Нужно сохранить Easy Passthrough Token в поле исходной записи для дальнейшей передачи в CRM или email-сервис.
• Нужно удалить только токен после использования, но сохранить саму запись для отчётности.
• Нужно расширить перенос для специфического типа поля, например consent field, если такой сценарий подтверждён официальным snippet.

В этой статье намеренно не вставлен большой PHP-код. Для таких задач безопаснее открыть актуальную страницу Snippet Library, взять свежую версию snippet, заменить только documented form ID и field ID, затем проверить результат. Это снижает риск, что в руководство попадёт устаревший фрагмент, который кто-то скопирует без понимания.

Небольшая UX-настройка без кода

Самое полезное улучшение часто не требует PHP. Добавьте рядом с предзаполненными полями короткое пояснение: "Мы подставили данные из предыдущего шага. Проверьте их перед отправкой". Если значения можно менять, пользователь поймёт, что это не ошибка. Если значения менять нельзя, объясните, как исправить опечатку: вернуться к предыдущей форме, обратиться в поддержку или отправить новую заявку.

Не правьте ядро: любые изменения логики делайте через настройки, официальные hooks, Code Snippets или отдельный мини-плагин. Правка файлов плагина потеряется при обновлении и усложнит поддержку.

Когда Gravity Forms Easy Passthrough будет удачным выбором

Gravity Forms Easy Passthrough стоит использовать, если у вас есть понятная цепочка отдельных форм, запись первой формы должна стать источником значений для второй, а пользователю важно не вводить одни и те же данные повторно. Плагин особенно полезен для последующих форм, коротких лид-форм с подробным вторым шагом, анкет после мероприятия, клиентских уточнений и внутренних процессов, где простая передача полей экономит время.

Перед запуском проверьте структуру форм, карту полей, choice values, поведение ep_token, кеширование и права доступа. Не переносите лишние данные и не превращайте токен в систему доступа к приватной информации. Если нужна динамическая фильтрация из базы, выбирайте другой инструмент. Если нужно редактировать entries в кабинете, сравните с Entry Blocks или GravityView. Если нужен сложный процесс согласования, смотрите в сторону Gravity Flow.

Когда тестовая цепочка работает стабильно, можно перейти к блоку загрузки и перейти к скачиванию Gravity Forms Easy Passthrough, затем повторить настройку на своём сайте по безопасному сценарию: сначала простые поля, затем токены, затем сложные поля, затем кеш и права. Такой порядок снижает риск и делает результат предсказуемым для пользователя и администратора.