DadataWidgets plugin for OctoberCMS v.2

Плагин интеграции подсказок сервиса Dadata в OctoberCMS v.2

Установка

composer require gromit/oc-dadatawidgets-plugin

Настройка

Для использования плагина, необходимо получить токен сервиса Dadata. Получить токен можно бесплатно - необходимо зарегистрироваться на сайте https://dadata.ru/ и скопировать его в профиле.

Полученный токен (он же АПИ КЛЮЧ) вставляем в настройки плагина через Настройки -> Dadata Widgets

Использование

В конфиге формы указываем тип поля dadataSuggestions, тип подсказки suggestion и привязку данных к полям формы.

Пример конфига поля:

Маппер

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

Структура возвращаемых данных сервиса Dadata зависит от типа подсказки:

suggestion: company -> https://dadata.ru/api/suggest/party/#response

suggestion: bank -> https://dadata.ru/api/suggest/bank/#response

suggestion: address -> https://dadata.ru/api/suggest/address/#response

suggestion: email -> https://dadata.ru/api/suggest/email/#response

suggestion: fio -> https://dadata.ru/api/suggest/name/#response

Соответственно в маппере используем описанные выше структуры данных.

Примеры

Небольшие примеры использования виджета для разных ситуаций

Поиск контрагента и заполнение нужных полей

Поиск банка

Ввод адреса и его последующий разбор

Помощь при вводе email-адреса и его разбор

Помощь при вводе ФИО и разбор