PHPackages                             gromit/oc-dadatawidgets-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. gromit/oc-dadatawidgets-plugin

ActiveOctober-plugin[Utility & Helpers](/categories/utility)

gromit/oc-dadatawidgets-plugin
==============================

Formwidgets working with Dadata services

2261PHP

Since May 17Pushed 4y ago1 watchersCompare

[ Source](https://github.com/gromitsoft/oc-dadatawidgets-plugin)[ Packagist](https://packagist.org/packages/gromit/oc-dadatawidgets-plugin)[ RSS](/packages/gromit-oc-dadatawidgets-plugin/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

DadataWidgets plugin
====================

[](#dadatawidgets-plugin)

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

Установка
---------

[](#установка)

```
composer require gromit/oc-dadatawidgets-plugin

```

Настройка
---------

[](#настройка)

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

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

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

[](#использование)

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

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

[](#пример-конфига-поля)

```
name:
    label: Название компании
    type: dadataSuggestions
    suggestion: company
```

Маппер
------

[](#маппер)

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

```
map:
    имя поля1: значение из ответа Dadata
    имя поля2: значение из ответа Dadata
    ...
    имя поляN: значение из ответа Dadata
```

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

Тип подсказкиОписание ответаsuggestion: **company**suggestion: **bank**suggestion: **address**suggestion: **email**suggestion: **fio**Соответственно в маппере используем описанные выше структуры данных.

Примеры
-------

[](#примеры)

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

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

[](#поиск-контрагента-и-заполнение-нужных-полей)

```
fields:
    name:
        label: Название компании
        type: dadataSuggestions
        suggestion: company
        map:
            name: value
            inn: data.inn
            kpp: data.kpp
            ogrn: data.ogrn
    inn:
        label: ИНН
    kpp:
        label: КПП
    ogrn:
        label: ОГРН
```

### Поиск банка

[](#поиск-банка)

```
fields:
    bank:
        label: Банк
        type: dadataSuggestions
        suggestion: bank
        map:
            bank: value
            bic: data.bic
            cs: data.correspondent_account
    bic:
        label: БИК
    cs:
        label: К/С
```

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

[](#ввод-адреса-и-его-последующий-разбор)

```
fields:
    address:
        label: Адрес
        type: dadataSuggestions
        suggestion: address
        map:
            address: value
            country: data.country
            city: data.city
            lat: data.geo_lat
            lon: data.geo_lon

    country:
        label: Страна
    city:
        label: Город
    lat:
        label: Координаты (широта)
    lon:
        label: Координаты (долгота)
```

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

[](#помощь-при-вводе-email-адреса-и-его-разбор)

```
fields:
    email:
        label: Email
        type: dadataSuggestions
        suggestion: email
        map:
            email: value
            local: data.local
            domain: data.domain
    local:
        label: Локальное (до собачки)
    domain:
        label: Домен
```

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

[](#помощь-при-вводе-фио-и-разбор)

```
fields:
    fio:
        label: ФИО
        type: dadataSuggestions
        suggestion: fio
        map:
            fio: value
            surname: data.surname
            name: data.name
            patronymic: data.patronymic
            gender: data.gender
    surname:
        label: Фамилия
    name:
        label: Имя
    patronymic:
        label: Отчество
    gender:
        label: Пол
```

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity29

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/77480921?v=4)[gromitsoft](/maintainers/gromitsoft)[@gromitsoft](https://github.com/gromitsoft)

---

Top Contributors

[![gromitsoft](https://avatars.githubusercontent.com/u/77480921?v=4)](https://github.com/gromitsoft "gromitsoft (1 commits)")

### Embed Badge

![Health badge](/badges/gromit-oc-dadatawidgets-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/gromit-oc-dadatawidgets-plugin/health.svg)](https://phpackages.com/packages/gromit-oc-dadatawidgets-plugin)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)