docs.modx.pro
mxDadata
mxDadata
Подсказки DaData и валидация адреса для MiniShop3 в MODX 3
  • MODX 3
  • PHP 8.2
  • miniShop3
Зависимости
  • minishop3
  1. Компоненты
  2. mxDadata
  3. Быстрый старт

Быстрый старт ​

Как подключить подсказки DaData к оформлению заказа MiniShop3.

Требования ​

ТребованиеВерсия
MODX Revolution3.0.3+
PHP8.2+
MiniShop3пакет minishop3 ≥ 1.0.0
Учётная запись DaDataToken и Secret из кабинета
VueToolsВ requires транспорта для Vue-админки. Сниппеты на сайте без него

Шаг 1: Установка пакета ​

  1. Extras → Installer — найдите mxDadata (ModStore) или установите собранный транспорт
  2. Убедитесь, что установлен MiniShop3
  3. Настройки → Очистить кэш

После установки создаются:

  • 18 системных настроек (фильтр Настройки → Системные настройки: mxdadata)
  • пункт меню Extras → mxDadata
  • сниппеты mxDadataAddressSuggest, mxDadataPartySuggest, mxDadataForm
  • плагин mxDadata на события OnWebPageInit, msOnBeforeCreateOrder, msOnSubmitOrder
  • чанки оформления (в т.ч. tpl.mxdadata.msOrder с демо-блоком — см. Подключение на сайте)

Проверка админки: откройте Extras → mxDadata (нужно право mxdadata_view). Без VueTools installer/resolver предупреждает. Сниппеты на сайте работают независимо.

Шаг 2: Ключи DaData ​

  1. dadata.ru — регистрация / вход
  2. Профиль → информация — API Key (Token) и Secret
  3. В MODX: Настройки → Системные настройки (mxdadata) или Extras → mxDadata → Настройки — mxdadata_api_token, mxdadata_api_secret
  4. Extras → mxDadata → Dashboard → Подключение → Тест соединения — при успехе подтверждение в интерфейсе

Token используется для Suggest. Secret — для Clean (нормализация) и Party (юрлица), в том числе в плагине заказа.

Подробнее: Системные настройки.

Шаг 3: Включение компонента ​

Проверьте mxdadata_enabled = «Да» в системных настройках mxdadata. При «Нет» плагин валидации и логика заказа не выполняются.

Шаг 4: Сниппеты в чанке заказа ​

Подключайте некэшированные вызовы ([[!…]] или Fenom !snippet).

Минимум для адреса:

fenom
{'!mxDadataAddressSuggest' | snippet}
modx
[[!mxDadataAddressSuggest]]

Адрес + юрлицо по ИНН:

fenom
{'!mxDadataAddressSuggest' | snippet}
{'!mxDadataPartySuggest' | snippet}
modx
[[!mxDadataAddressSuggest]]
[[!mxDadataPartySuggest]]

Порядок с msRussianPost: сначала поля адреса и mxDadata (подсказки), затем виджет Почты России. См. Подключение на сайте.

Шаг 5: Настройки MiniShop3 (по желанию) ​

Настройки → Системные настройки (mxdadata, область miniShop3):

  • строгая валидация телефона/email
  • обязательный FIAS / индекс
  • JSON маппинга полей DaData → поля адреса MS3

См. Системные настройки → MiniShop3.

Шаг 6: Проверка ​

  1. Откройте страницу оформления заказа. Начните вводить адрес в поле, к которому привязан сниппет. По умолчанию это поля с name="address", address_text_address и др.
  2. Должны появиться подсказки DaData. После выбора заполняются город, индекс, FIAS (если настроено в форме).
  3. Оформите тестовый заказ. При включённой валидации неверный телефон или email может заблокировать создание заказа. См. Интеграция.

Отладка в браузере: ?mxdadata_debug=1 в URL или mxdadata_debug_mode = «Да» в настройках. В консоли появятся расширенные логи. См. Интеграция.

Что дальше ​