Справка по плагину «Подсказки» от DaData.ru

Эта страница содержит идентификаторы полей, которые плагин использует для подключения подсказок DaData.ru. Она пригодится при настройке WooCommerce и произвольных HTML-форм.

Перед началом установите плагин и укажите API-ключ в настройках WordPress. Подробная инструкция описана в статье «Установка и настройка плагина».

Как устроено автозаполнение

#

Идентификатор из таблицы указывается в HTML-атрибуте id поля:

<input type="text" id="dadata_custom_address">

Основное поле выделено жирным. После выбора варианта из списка оно заполняет связанные поля, отмеченные стрелкой ↳.

Например, поле dadata_custom_address заполняет адрес, а поля dadata_custom_address_city и dadata_custom_address_postal_code получают город и индекс. Связанные поля необязательны: добавляйте только те, которые нужны в форме.

Важные требования

#

• id должен полностью совпадать с идентификатором из таблицы, включая регистр символов.
• Идентификатор нужно назначать самому полю <input>, а не его контейнеру или <label>.
• На одной странице не должно быть нескольких полей с одинаковым id.
• Для автозаполнения связанных данных в форме должны присутствовать и основное поле, и нужные связанные поля.
• Если поле создаётся конструктором, проверьте, что конструктор не заменяет id после загрузки страницы.

Идентификаторы WooCommerce

#

Эти поля работают со стандартными полями оформления заказа WooCommerce.

Идентификаторы произвольных полей

#

ФИО

#

Адреса

#

Организации и банки

#

Другие типы данных

#

Для телефона доступны идентификаторы billing_phone и dadata_custom_phone.

Пример обычной HTML-формы

#

<form action="">
  <label for="dadata_custom_address">Адрес</label>
  <input type="text" id="dadata_custom_address">

  <label for="dadata_custom_address_city">Город</label>
  <input type="text" id="dadata_custom_address_city">

  <label for="dadata_custom_address_postal_code">Индекс</label>
  <input type="text" id="dadata_custom_address_postal_code">
</form>

После выбора адреса из подсказки плагин заполнит город и индекс, если соответствующие поля присутствуют в форме.

Пример для Contact Form 7

#

В поле Форма укажите нужный id параметром id::

[text address id:dadata_custom_address]
[text city id:dadata_custom_address_city]
[text postal-code id:dadata_custom_address_postal_code]

Больше готовых вариантов для организаций, ИНН, ФИО и телефона приведено в статье «Пример использования плагина».

Если подсказки не появляются

#

Проверьте:

1. Плагин активирован, а API-ключ сохранён в Настройки → Общие.
2. У ключа есть доступ к нужному типу запросов DaData.ru.
3. id поля написан без опечаток и не изменяется темой или конструктором.
4. Основное поле и связанные поля находятся в DOM одновременно.
5. В консоли разработчика браузера нет JavaScript-ошибок.

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