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
Соответственно в маппере используем описанные выше структуры данных.
Примеры
Небольшие примеры использования виджета для разных ситуаций