Подсказки DaData.ru

Вручную вводить ФИО, email и особенно адрес — неудобно. Люди ошибаются и неправильно заполняют поля, а некоторые вовсе уходят, если форма слишком сложная. Менеджерам приходится перезванивать и уточнять детали, впустую тратя время компании и клиента.

Используйте DaData — модуль для быстрого ввода любых контактных данных: адресов, ФИО, email, реквизитов компаний. С ним клиенты легко вводят правильные данные, а заказы готовы к доставке без перезвона и уточнения деталей.

Инструкция по подключению

1. Перейдите на сайт DaData.ru и зарегистрируйте личный кабинет.
2. После авторизации в личном кабинете из блока "Ключи" скопируйте API-ключ и Секретный ключ и внесите их в соответствующие поля в разделе "Настройки" модуля.
3. В разделе "Настройки" обязательно проверьте правильность указания пути к корзине на вашем сайте, например /shop/cart/
4. Модуль готов к использованию!

Настройки модуля

• API-ключ - API-ключ из личного кабинета DaData.
• Секретный ключ - секретный ключ из личного кабинета DaData.
• Путь к корзине - путь узла корзины на текущем сайте.
• Ручной вызов - ручной вызов подсказок для собственных форм.
• Подсказки: адреса - включить/выключить подсказки адреса.
• Подсказки: организации - включить/выключить подсказки организаций.
• Подсказки: email - включить/выключить подсказки электронной почты.
• Подсказки: ФИО - включить/выключить подсказки ФИО.

Настройки клиентской части

Названия полей и классы

Для полей используются следующие селекторы имен полей и классов для подключения подсказок:

Подсказки: адреса - input[name = address], .hostcms-dadata-address
Подсказки: организации - input[name = company], .hostcms-dadata-company
Подсказки: email - input[name = email], .hostcms-dadata-email
Подсказки: ФИО - input[name = surname], input[name = name], input[name = patronymic], input[name = fio], .hostcms-dadata-name

CSP

Если в настройках сайта включен CSP, то необходимо добавить в секцию Connect: *.dadata.ru

Макет

Если в макете сайте подключение jQuery идет через стандартный Core_Page::instance()->js(), то необходимо ->js() заменить на ->prependJs(). Только для подключения jQuery!

Ручной вызов

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

<?php
$oSite = Core_Entity::factory('Site', CURRENT_SITE);

$oHostcms_Dadata_Controller = new Hostcms_Dadata_Controller($oSite);
$oHostcms_Dadata_Controller->show();
?>

* Доступно с версии 1.2

Информация о разработчике:

• Разработчик: Hostmake LLC
  
• Вопросы по модулю: support@hostcms.ru
  
• Поддержка: support@hostcms.ru