Gravity Forms Advanced Select - Плагин WordPress

Руководство по настройке и применению Gravity Forms Advanced Select

Gravity Forms Advanced Select нужен не для того, чтобы просто заменить один выпадающий список другим. Его ценность появляется там, где обычное поле выбора в Gravity Forms становится медленным, неудобным или слишком длинным: каталог товаров, список компаний, страны и регионы в адресе, навыки кандидата, медицинские состояния, внутренние справочники, записи WordPress или данные, которые подтягиваются через GP Populate Anything.

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

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

Какую задачу решает улучшенный выбор в формах

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

Плагин добавляет улучшенный интерфейс для полей Drop Down, Multi Select и Address. В документации Gravity Wiz отдельно отмечает, что для адресных полей поддерживаются все типы адреса. Это важно для сайтов, где выбор страны, штата, провинции или региона должен оставаться привычным для пользователя, но не превращаться в бесконечную прокрутку.

Самый сильный сценарий - связка с GP Populate Anything. В таком режиме choices не обязательно хранить внутри формы как статический список. Их можно динамически подставлять из записей WordPress, пользователей, таксономий, entries Gravity Forms, таблиц базы данных или других поддерживаемых источников. Advanced Select в этой связке отвечает за удобный поиск, ленивую загрузку, фильтрацию по введенному поисковому значению и бесконечную подгрузку результатов.

Когда плагин действительно нужен

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

Еще один признак - данные часто меняются. Если список компаний, продуктов или внутренних категорий обновляется из записей WordPress или стороннего источника, ручное редактирование choices становится слабым местом. Тогда динамическая подстановка через Populate Anything плюс Advanced Select дает более управляемую схему: источник данных обновляется отдельно, а форма показывает актуальные варианты.

Когда лучше не усложнять форму

Если в поле всего 3-8 вариантов, обычный Drop Down, Radio Buttons или Checkboxes часто будут понятнее. Search-поле полезно, когда есть что искать. Для короткого списка оно может добавить лишний слой интерфейса и замедлить принятие решения. Также не стоит включать улучшенный выбор только ради визуального эффекта, если форма уже работает быстро, а пользователи не жалуются на длинные списки.

Практическое правило: сначала определите, какую боль должен снять Advanced Select - длинный список, динамические данные, выбор нескольких пунктов, поиск по справочнику или производительность. Если такой боли нет, начните с штатного поля Gravity Forms.

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

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

Документация Gravity Forms для Drop Down и Multi Select предупреждает: если labels содержат HTML или специальные символы, нужно включать Show Values и задавать простые уникальные значения. Это особенно важно для расчетов, условной логики, динамической подстановки и проверки отправленных значений. Advanced Select не исправляет такие исходные ошибки - он делает выбор удобнее, но данные все равно должны быть аккуратно подготовлены.

Базовый чек-лист совместимости

• Проверьте, что форма использует поддерживаемые поля: Drop Down, Multi Select или Address.
• Отключите штатный Enable enhanced user interface Gravity Forms для поля, где будет работать Advanced Select, потому что документация Gravity Wiz указывает это как ограничение.
• Если choices динамические, проверьте настройки GP Populate Anything и источник данных до включения Advanced Select.
• Убедитесь, что values уникальны и не зависят от сложных символов в label.
• Проверьте форму без кеша страниц и без объединения JavaScript, если на сайте используются агрессивные оптимизаторы.
• Запланируйте тест на публичной странице, а не только в редакторе формы.

Где риск выше обычного

Больше внимания нужно формам, где choices завязаны на большие справочники, Google Sheets через Populate Anything, записи пользователей, кастомные таблицы базы данных или вложенные условия показа. В официальных ограничениях Gravity Wiz отдельно указано, что связка Advanced Select и Populate Anything для фильтрации больших наборов Google Sheets может давать проблемы производительности. Поэтому для таких форм лучше начинать с тестовой копии, уменьшенного набора данных и понятной проверки времени отклика.

Также стоит заранее проверить соседние плагины Gravity Forms. В документации указаны несовместимости с редактированием через Entry Detail, inline edit режимом GravityEdit и Search Bar в GravityView. Если ваш рабочий процесс строится вокруг редактирования entries или поиска по записям на публичной части, Advanced Select может быть отличным для самой формы, но не подходить для этих отдельных экранов.

Установка и первое включение поля

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

Откройте нужную форму в редакторе Gravity Forms и выберите поле Drop Down, Multi Select или Address. Если поля еще нет, добавьте его из библиотеки полей. Затем в настройках поля откройте вкладку Perks и включите параметр Enable Advanced Select. После сохранения формы проверьте ее на странице, где она реально встроена.

Первичная проверка после включения

1. Откройте форму в обычном окне браузера, где вы не авторизованы как администратор.
2. Кликните по улучшенному полю и убедитесь, что появляется поисковый список.
3. Введите часть названия варианта и проверьте, что фильтрация работает ожидаемо.
4. Выберите вариант, отправьте тестовую заявку и проверьте entry в админ-панели.
5. Если поле множественного выбора, выберите несколько элементов и проверьте, что все значения сохранились.

На этом этапе не стоит сразу включать дополнительные snippets. Сначала убедитесь, что базовая форма работает в нативном состоянии и с Advanced Select. Если проблема проявилась сразу, отключите Advanced Select на этом поле и повторите отправку. Такой тест быстро отделяет проблему в исходной форме от проблемы в улучшенном интерфейсе.

Нюанс с адресными полями

Адресное поле Gravity Forms состоит из нескольких подполей: улица, город, регион, индекс, страна и другие части в зависимости от типа адреса. Advanced Select улучшает выборочные части адресного поля, где есть выпадающий список. При проверке не ограничивайтесь кликом по стране. Отправьте форму полностью и убедитесь, что обязательные подполя проходят валидацию, потому что сама валидация адреса остается логикой Gravity Forms.

Подробная настройка после установки

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

Начните с самой формы. Откройте поле, где включен Advanced Select, и проверьте три зоны: базовые choices в General, расширение через Perks и, если используется Populate Anything, настройки динамической подстановки. Не меняйте все сразу. Сохраните одно изменение, проверьте результат, затем переходите к следующему. Такой подход проще откатить.

Настройки для статического списка

Если choices заданы вручную, проверьте, что список не содержит дублей, а у сложных labels есть отдельные values. Для длинного списка используйте Bulk Add / Predefined Choices или подготовленный текстовый список, но после импорта просмотрите значения. Advanced Select улучшит поиск, но не сможет понять, что два пункта с похожими названиями на самом деле должны быть разными сущностями, если value у них одинаковый или неочевидный.

Для Multi Select заранее решите, нужно ли пользователю выбирать много пунктов или достаточно одного. Если бизнес-логика требует верхний предел, не пытайтесь решать это только текстом в описании поля. У Gravity Wiz есть отдельный snippet Limit Multi Selects, который ограничивает минимальное и максимальное количество выбранных вариантов. Его стоит использовать только если такое ограничение действительно нужно форме.

Настройки для динамических choices

Если поле получает choices через GP Populate Anything, настройка становится более интересной. Сначала выберите объект, из которого будут подтягиваться варианты: запись, пользователь, taxonomy term, entry Gravity Forms, таблица базы данных или другой поддерживаемый источник. Затем задайте, какое свойство будет label, а какое value. Для пользовательского интерфейса label должен быть понятен человеку, а value - стабилен для обработки заявки.

Фильтры Populate Anything позволяют ограничить набор объектов. Например, можно показывать только опубликованные записи, только пользователей определенной роли или только entries со статусом, который подходит форме. Для Advanced Select важен еще один сценарий: фильтрация по Advanced Select Search Value. В этом режиме запрос выполняется по введенному пользователем поисковому значению, а не грузит весь справочник сразу.

Ленивая загрузка

Lazy Load Choices появляется только для полей, choices которых заполняются через Populate Anything. Ее смысл простой: не загружать все варианты при первом рендере формы, а дождаться взаимодействия пользователя с полем. Это особенно полезно, если на форме несколько динамических select-полей или часть полей скрыта условной логикой.

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

Фильтрация по поисковому значению

Документация Gravity Wiz объясняет, что фильтрация по поисковому значению помогает обходить стандартный лимит запросов Populate Anything без прямого увеличения лимита. Вместо загрузки огромного набора данных поле делает свежий запрос по введенному значению и возвращает более короткий список совпадений. Это обычно лучше для производительности, чем просто поднимать лимит через gppa_query_limit.

Чтобы включить эту схему, в настройках поля добавьте группу фильтров и сравните нужное свойство объекта с Advanced Select Search Value. Например, для списка компаний это может быть название записи или мета-поле с юридическим названием. После этого пользователь должен ввести минимум несколько символов, прежде чем появятся результаты. В документации по gpadvs_js_init_args указано значение minSearchLength, которое по умолчанию равно 3.

Бесконечная подгрузка результатов

Когда choices фильтруются по поисковому значению, Advanced Select автоматически использует бесконечную подгрузку. Сначала возвращается первая порция результатов, затем при приближении к концу списка подгружается следующая. Официальная документация описывает порции по 50 результатов. Для пользователя это выглядит как естественная прокрутка, а для сервера - как серия более коротких запросов вместо одного тяжелого запроса на весь справочник.

Если настройка не подошла, откат простой: снимите галочку Enable Advanced Select на поле и сохраните форму. Для динамических списков можно отдельно отключить фильтр по поисковому значению и вернуться к обычной выдаче Populate Anything. Не удаляйте поле и не переписывайте choices, пока не отделите проблему интерфейса от проблемы источника данных.

Связка с Populate Anything для больших справочников

Самая продуктовая часть Advanced Select - не просто красивый поиск, а работа с динамическими choices. Populate Anything умеет получать данные из разных объектов WordPress и Gravity Forms, а Advanced Select делает эту выдачу пригодной для человека. Получается цепочка: источник данных хранит справочник, Populate Anything выбирает подходящие записи, Advanced Select показывает поисковый интерфейс, пользователь выбирает вариант, а Gravity Forms сохраняет entry.

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

Пример источника: записи WordPress как каталог услуг

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

В Populate Anything для такого поля можно выбрать объект Post, ограничить Post Type, отфильтровать опубликованные записи, а label собрать из названия услуги. Если в каталоге есть несколько похожих услуг, добавьте в label безопасное уточнение: город, категория, уровень тарифа или внутренний код. Но не перегружайте label техническими данными, которые пользователь не понимает.

Пример источника: entries Gravity Forms как внутренняя база

Gravity Wiz прямо указывает, что Populate Anything может работать с entries Gravity Forms. Это полезно, если одна форма собирает заявки или справочник, а другая форма должна выбирать из уже отправленных записей. Например, внутренняя форма поддержки выбирает клиента из ранее созданных entries, а затем добавляет новый запрос.

В таком сценарии особенно важны фильтры. Не показывайте все старые entries без статуса, даты или признака актуальности. Лучше отфильтровать только активные записи и показывать в label понятную комбинацию полей. Advanced Select здесь улучшает поиск, но качество выбора зависит от того, насколько хорошо вы построили label и value.

Поиск, ленивые choices и бесконечная подгрузка

Если в форме есть большой справочник, главный вопрос не "как показать все", а "как показать нужное без лишней нагрузки". Advanced Select дает три связанных механизма: поиск внутри поля, ленивую загрузку choices и бесконечную подгрузку результатов. Они решают разные задачи, но часто включаются вместе.

Поиск помогает пользователю. Ленивая загрузка помогает странице формы не грузить варианты заранее. Бесконечная подгрузка помогает не упираться в один большой ответ. Когда поле фильтруется по Advanced Select Search Value, пользователь вводит запрос, Populate Anything возвращает подходящую порцию, а Advanced Select подгружает следующие порции по мере прокрутки.

Почему не стоит просто увеличивать лимит запросов

У Populate Anything есть фильтр gppa_query_limit, который позволяет изменить лимит результатов. Это полезный инструмент разработчика, но не универсальное решение для огромных списков. Если поднять лимит без необходимости, страница или поле могут стать тяжелее, особенно при нескольких динамических select-полях.

Для пользовательского поиска обычно лучше фильтровать по введенному значению. Человек редко хочет увидеть все тысячи вариантов. Он хочет найти "Acme", "Berlin", "cardiology" или другой конкретный фрагмент. Поэтому поисковая фильтрация совпадает с реальным поведением пользователя и одновременно снижает объем данных.

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

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

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

Мини-итог: для больших справочников начинайте не с увеличения лимитов, а с поисковой фильтрации, ленивой загрузки и проверки реального пользовательского запроса.

Изображения в вариантах выбора и визуальные справочники

Advanced Select умеет работать не только с текстовыми choices. Документация Gravity Wiz описывает интеграцию с JetSloth Image Choices, которая позволяет показывать изображение рядом с вариантом выбора. Это полезно, когда текстового названия недостаточно: выбор товара, образца, модели, цвета, помещения, специалиста или визуальной категории.

Важно не путать два разных подхода. У Gravity Forms есть собственное поле Image Choice, которое показывает изображения как choices в форме. JetSloth Image Choices - отдельная интеграция, которую Advanced Select может использовать для отображения изображений внутри улучшенного выбора. Выбор зависит от интерфейса, который нужен пользователю: карточки с изображениями сразу на форме или поисковый select, где картинка помогает распознать вариант.

Когда изображение улучшает выбор

Картинка помогает, если варианты похожи по названию или пользователь выбирает визуальный объект. Например, "Oak Classic" и "Oak Natural" могут выглядеть почти одинаково в тексте, но по миниатюре человек быстрее поймет разницу. Для услуг или компаний изображения нужны реже, потому что они могут отвлекать и утяжелять интерфейс.

Если choices динамические, Populate Anything может связать вариант с URL изображения. В документации Gravity Wiz описан сценарий, где после включения Image Choices и настройки динамических choices появляется дополнительный шаблон Image, куда можно сопоставить свойство объекта с URL картинки. В этом случае источник данных должен быть аккуратным: изображения доступны, имеют нормальный размер и не превращают dropdown в тяжелую галерею.

Проверка результата с картинками

1. Включите Image Choices на конкретном поле и настройте варианты или динамическое сопоставление изображения.
2. Откройте форму на публичной странице и проверьте, что миниатюры видны внутри выбора.
3. Введите поисковый запрос и убедитесь, что фильтрация не скрывает нужные картинки.
4. Выберите вариант, отправьте форму и проверьте, что сохраняется правильное value, а не только визуальный label.
5. Откройте форму на мобильном устройстве или узком экране, чтобы убедиться, что миниатюры не ломают ширину поля.

Практический сценарий: форма заявки с поиском компании

Разберем сценарий, который хорошо показывает смысл продукта. На сайте есть форма регистрации партнера. Пользователь должен выбрать компанию из большого внутреннего справочника. Компании хранятся как записи WordPress или entries другой формы. Обычный dropdown слишком длинный, а ручное редактирование choices быстро устаревает.

Цель

Нужно получить поле "Компания", где пользователь вводит часть названия, видит только подходящие результаты, выбирает компанию, а в entry сохраняется стабильное значение. Форма должна быстро открываться даже при большом справочнике и не показывать все компании до начала поиска.

Подготовка

• Установлены Gravity Forms, GP Populate Anything и Gravity Forms Advanced Select.
• Есть источник компаний: записи WordPress, entries Gravity Forms или другой поддерживаемый объект.
• У каждой компании есть понятное название и стабильный идентификатор.
• Форма встроена на тестовую страницу, где можно безопасно отправлять заявки.

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

1. Откройте форму и добавьте поле Drop Down для выбора компании.
2. Включите динамическое заполнение choices через Populate Anything и выберите источник компаний.
3. Настройте label так, чтобы пользователь видел название компании и, при необходимости, короткое уточнение.
4. Настройте value как стабильный идентификатор, который пригодится в обработке заявки.
5. Добавьте фильтр по свойству названия, используя Advanced Select Search Value.
6. Перейдите во вкладку Perks поля и включите Enable Advanced Select.
7. Сохраните форму и очистите кеш страницы, если сайт использует кеширование.

Проверка

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

Что должно быть видно

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

Что может пойти не так

Если результаты не появляются, проверьте фильтр Populate Anything и длину поискового запроса. Если появляется слишком много компаний, уточните фильтр или label. Если отправка сохраняет неожиданный текст, проверьте, какое свойство назначено как value. Если поле визуально работает, но заявка не проходит условную логику, вернитесь к values и убедитесь, что условия сравнивают правильные значения.

Проверка результата на сайте и в админ-панели

Проверка Advanced Select должна охватывать три уровня: интерфейс пользователя, сохранение entry и дальнейшую обработку данных. Только первый уровень часто вводит в заблуждение. Поле может красиво открываться и фильтровать список, но сохранять не то value, ломать условную логику или вести себя иначе после включения кеша.

Публичная часть сайта

На странице формы проверьте загрузку, клик по полю, поиск, выбор, очистку выбора, повторный выбор и отправку. Для Multi Select отдельно проверьте удаление выбранных элементов клавишами Backspace или Delete, потому что документация Advanced Select описывает такую навигацию для множественного выбора. Если форма многошаговая, проверьте переходы между страницами формы.

Админ-панель и entries

После отправки откройте запись в Forms - Entries. Сверьте label, value и то, как данные выводятся в уведомлениях. Если поле используется в расчетах, условной логике или интеграции, проверьте не только отображение, но и результат этой логики. Для choices со специальными символами особенно важно, чтобы value было простым и уникальным.

Производительность

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

Проверка результата считается полной, когда пользователь может найти вариант, entry сохраняет правильное value, уведомления получают ожидаемые данные, а повторный тест после очистки кеша дает тот же результат.

Полезные улучшения и осторожные snippets

Gravity Wiz документирует несколько hooks и snippets для Advanced Select. Их не нужно включать "на всякий случай". Каждый snippet должен решать конкретную задачу: изменить минимальную длину поиска, показать результаты без ввода запроса, включить ленивую загрузку для нужного поля или добавить поведение, которое действительно нужно форме.

Лучшее место для таких snippets - дочерняя тема, небольшой site-specific plugin или плагин Code Snippets. Не правьте ядро WordPress, Gravity Forms, Gravity Perks или тему. Перед изменением сохраните исходное поведение: сделайте тестовую отправку, запишите ID формы и ID поля, а затем применяйте snippet точечно.

Изменить минимальную длину поиска

По умолчанию при фильтрации через Advanced Select Search Value пользователь должен ввести минимум несколько символов. Если справочник небольшой или названия короткие, можно уменьшить порог через официальный фильтр gpadvs_js_init_args. Делайте это осторожно: один символ может создавать больше запросов к источнику данных.

add_filter( 'gpadvs_js_init_args', function ( $init_args, $form, $field ) {
    // Уменьшайте порог только для форм, где короткий поиск действительно нужен.
    $init_args['minSearchLength'] = 2;

    return $init_args;
}, 10, 3 );

После добавления кода откройте форму, введите один символ, затем два символа и проверьте момент появления результатов. Если сервер начинает отвечать медленно или список становится шумным, верните значение по умолчанию или примените фильтр только к конкретной форме и полю через вариант hook с ID.

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

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

add_filter( 'gpadvs_js_init_args', function ( $init_args, $form, $field ) {
    // Подходит только для источников, которые быстро отдают стартовый набор.
    $init_args['ignoreEmptySearchValue'] = true;

    return $init_args;
}, 10, 3 );

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

CSS для выпадающего списка, который скрывается под блоком

В troubleshooting-разделе документации Gravity Wiz указано, что dropdown может появляться за другими элементами из-за z-index. В таком случае можно добавить небольшой CSS через Appearance - Customize - Additional CSS или через безопасное место для стилей вашей темы.

.gform_wrapper .ts-dropdown {
    z-index: 9999;
}

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

Label, value и клавиатурная навигация в улучшенном select

Advanced Select делает выбор визуально удобнее, но качество данных по-прежнему зависит от того, как настроены label и value. В Gravity Forms label - это то, что видит пользователь, а value - то, что обычно используется при сохранении, условной логике, расчетах, уведомлениях и интеграциях. Если эти две роли смешаны, форма может выглядеть правильно, но дальше работать нестабильно.

Для простого статического списка это не всегда заметно. Например, если у вас поле "Страна" и choices совпадают с названиями стран, label и value могут выглядеть одинаково. Но в реальных рабочих формах часто появляются похожие значения, внутренние коды, языковые варианты, длинные названия организаций и специальные символы. В таком случае лучше сразу включать Show Values и задавать короткие стабильные values, особенно если поле участвует в условной логике или передает данные дальше.

Как проектировать label для человека

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

При этом label не должен превращаться в техническую строку. Не стоит выводить длинный набор полей, ID, служебный статус и внутренний комментарий, если человек не использует эти данные для выбора. Поисковый select работает лучше, когда в списке есть достаточно контекста, но каждый вариант остается читаемым в одну-две строки.

Как проектировать value для обработки

Value лучше делать стабильным и коротким. Для динамических choices часто удобно сохранять ID записи, ID entry, slug или другой уникальный идентификатор. Тогда уведомление, CRM, таблица или последующая автоматизация получает предсказуемые данные, даже если visible label позже изменится. Это особенно важно для каталогов компаний и продуктов, где название может обновиться, но внутренняя связь должна остаться прежней.

Если форма используется только для письма администратору, можно сохранять читаемое значение. Но даже в таком сценарии стоит избегать одинаковых values. Два варианта с одинаковым value могут ломать условную логику, расчеты и фильтрацию entries. Если choices содержат HTML, запятые, pipes, скобки или другие специальные символы, ориентируйтесь на рекомендацию Gravity Forms: labels могут быть удобными, но values должны быть простыми и уникальными.

Проверка клавиатуры и доступности

Gravity Wiz указывает, что Advanced Select поддерживает клавиатурную навигацию и screen readers. Но доступность нельзя считать проверенной только потому, что она заявлена в документации. Конкретная тема, popup, page builder, кастомные стили и оптимизация скриптов могут изменить поведение поля на странице.

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

Мини-чеклист для проверки без мыши

• Фокус доходит до поля в ожидаемом порядке.
• Открытый список не перекрывается шапкой, popup или соседними блоками.
• Введенный текст фильтрует варианты, а не теряется после первого символа.
• Стрелки перемещают выделение по списку.
• Выбор сохраняется после перехода к следующему полю.
• В Multi Select выбранные элементы можно удалить клавиатурой.

Если проверка провалилась, не начинайте с изменения PHP snippets. Сначала временно переключите тему на базовую, отключите оптимизацию JavaScript на тестовой странице и проверьте нативное поле. Если нативное поле доступно, а Advanced Select нет, собирайте точный конфликт: браузер, тема, плагины оптимизации, тип поля, наличие динамических choices и шаги воспроизведения.

Что записать в рабочую документацию сайта

После успешной настройки полезно оставить короткую внутреннюю заметку для команды. Укажите ID формы и поля, источник данных, какое свойство используется как label, какое как value, включена ли ленивая загрузка, есть ли фильтр по Advanced Select Search Value и какие snippets применены. Такая заметка экономит время при следующем обновлении формы и снижает риск случайно сломать search-поле при правке choices.

Главная мысль этого раздела: Advanced Select улучшает интерфейс выбора, но не заменяет аккуратную модель данных. Сначала спроектируйте label и value, потом включайте поиск, ленивую загрузку и snippets.

Диагностика: почему Advanced Select может работать не так, как ожидается

Хорошая диагностика начинается с изоляции. Не пытайтесь сразу менять snippets, кеш и источник данных. Сначала отключите Enable Advanced Select на проблемном поле и проверьте нативное поведение. Если обычное поле тоже не сохраняет значение, не проходит валидацию или показывает неверные choices, причина не в Advanced Select.

Поле не стало поисковым

Симптом: после включения настройки поле выглядит как обычный dropdown или multi select. Возможные причины - выбран неподдерживаемый тип поля, настройка включена не на том поле, страница отдает старый кеш или конфликтует штатный enhanced UI Gravity Forms.

Проверьте тип поля, вкладку Perks, отключение Enable enhanced user interface в настройках Gravity Forms и очистку кеша. Если на тестовой странице без оптимизации все работает, проблема, скорее всего, в кешировании или объединении скриптов.

Поиск не возвращает динамические результаты

Симптом: поле открывается, но при вводе запроса список пустой. Проверьте источник Populate Anything, фильтр по Advanced Select Search Value, минимальную длину поиска и то, какое свойство объекта сравнивается с поисковым значением. Для начала используйте запрос, который точно есть в источнике данных.

Если используется snippet для minSearchLength или ignoreEmptySearchValue, временно отключите его. Если после отключения поведение стало предсказуемым, возвращайте snippet только точечно и с понятным ограничением по форме или полю.

Dropdown появляется под соседними элементами

Симптом: список открывается, но его перекрывает sticky header, popup, вкладка, блок конструктора или контейнер с высоким z-index. Документация Gravity Wiz прямо рекомендует проверить CSS z-index для такого случая.

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

Множественный выбор сохраняется не так, как ожидалось

Симптом: пользователь выбирает несколько вариантов, но уведомление, расчет или условная логика получает неожиданные данные. Проверьте values, разделители, merge tags и то, не используются ли одинаковые labels без уникальных values. Для Multi Select особенно важно заранее продумать, как данные будут читаться в entry и письмах.

Если нужно ограничить количество вариантов, используйте документированный подход вроде snippet Limit Multi Selects, а не только текстовую подсказку. Но сначала проверьте базовое сохранение без ограничения.

Форма стала медленнее

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

Откат в этом случае должен быть поэтапным: отключить snippets, отключить поисковую фильтрацию, отключить Advanced Select, проверить нативную форму. Так вы поймете, где именно возникает задержка.

Ограничения, о которых лучше знать заранее

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

В официальной документации указано, что Advanced Select не поддерживается при редактировании через Entry Detail, не совместим с inline edit режимом GravityEdit и не совместим с Search Bar в GravityView. Если ваша команда часто редактирует entries прямо из таких интерфейсов, не обещайте себе, что улучшенный select автоматически появится там же. Тестируйте именно тот экран, где пользователи будут работать.

Еще одно ограничение - использование Live Merge Tags в choices Advanced Select. Если вы строите labels на динамически обновляемых merge tags, проверьте альтернативную схему через Populate Anything, custom value templates или более простой label. Лучше иметь предсказуемый выбор, чем сложную строку, которая красиво выглядит в настройках, но не поддерживается в нужном интерфейсе.

Для Google Sheets через Populate Anything документация Gravity Wiz предупреждает о возможных проблемах производительности при больших наборах. В таком случае стоит подумать о другом источнике данных, промежуточной таблице, уменьшении справочника или более строгой фильтрации. Advanced Select помогает управлять выдачей, но не отменяет ограничения внешнего источника.

Для каких сайтов подходит Gravity Forms Advanced Select

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

Для агентства или разработчика ценность еще выше: один и тот же подход можно применять в разных клиентских формах, но включать только там, где он оправдан. Advanced Select не требует перестраивать всю форму. Он улучшает конкретные поля, а в связке с Populate Anything помогает держать choices ближе к источнику данных.

Кому может не подойти

Если сайт использует Gravity Forms только для простых контактных форм, Advanced Select может быть лишним. Для коротких списков "Тема обращения", "Способ связи" или "Количество человек" стандартные поля обычно достаточно понятны. Также продукт может не подойти, если ключевой сценарий завязан на редактирование entries в интерфейсах, которые официально указаны как несовместимые.

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

Когда стоит использовать Gravity Forms Advanced Select

Gravity Forms Advanced Select будет удачным выбором, если ваша форма упирается в длинные или динамические списки, а пользователю нужен быстрый поиск вместо прокрутки. Особенно сильный результат получается в связке с GP Populate Anything: данные остаются в своем источнике, поле загружает только нужные результаты, а форма становится легче и понятнее.

Перед внедрением проверьте исходные values, отключите штатный enhanced UI для выбранного поля, настройте динамическую подстановку аккуратно и протестируйте публичную форму после очистки кеша. Если все работает в нативном поле и ломается только после включения Advanced Select, используйте диагностику из этого руководства: поле, источник данных, минимальная длина поиска, ленивую загрузку, CSS и соседние плагины.

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