1С-Битрикс

---

• Скачать ZIP

Описание

Модуль 1С-Битрикс предоставляющий форму для ввода адреса с автодополнением. В качестве источника данных используется сервис «КЛАДР в облаке»

Установка

• Загрузите модуль
• Скопируйте в папку «/bitrix/modules» вашего сайта
• Переименуйте модуль в primepixkladr
• Установите модуль
  
• Разместите компонент «Форма для ввода адреса» на странице для ввода адреса
  
• В настройках компонента укажите токен и ключ для подключения к сервису «КЛАДР в облаке»
  

Параметры компонента «Форма для ввода адреса»

• Основные параметры
  • Токен для доступа к КЛАДР API - токен для доступа к сервису
  • Ключ для доступа к КЛАДР API - ключ для доступа к сервису
  
  
• Выводить поля для ввода
  • Области – Добавляет поле с именем «region» для ввода названия области
  • Района – Добавляет поле с именем «district» для ввода названия района
  • Населённого пункта – Добавляет поле c именем «location» для ввода названия населённого пункта
  • Улицы – Добавляет поле c именем «street» для ввода названия улицы
  • Дома – Добавляет поле с именем «building» для ввода номера дома
  
  
• Выводить скрытые поля
  • Код объекта – добавляет скрытое поле с именем «kladr_id», в которое по окончанию ввода адреса будет записан его код
  • Почтовый индекс – добавляет скрытое поле с именем «zip_code» в которое по окончанию ввода адреса будет записан его почтовый индекс из КЛАДР
  • Подписи – добавляет скрытое поле с постфиксом «_label» к каждому полю ввода в которое будет записана подпись к введённому пользователем значению (например: город, посёлок, село)
  • Сокращения подписей – добавляет скрытое поле к постфиксом «_label_min» к каждому полю ввода, в которое будет записано сокращение подписи к введённому пользователем значению (г., пос., с.)
  
  
• Опции
  • Обновлять подписи при вводе – Включает обновление подписей к полям ввода. Например, если пользователь в поле город введёт «Москва», то подпись «Населённый пункт» автоматически будет изменена на «Город»
  • Удалять значения, которых нет в КЛАДР – Включает проверку ввода в поля адреса и удаление ошибочно введённых значений. Например, если пользователь введёт в поле «Населённый пункт» значение «Мухосранск», то оно будет автоматически удалено, т.к. населённого пункта «Мухосранск» в России нет.
  
  
• Дополнительные параметры
  • Подключить jQuery – Компонент использует библиотеку jQuery, поэтому если она не используется у вас на сайте включите данный пункт
  • Подключить jQuery UI – Компонент использует библиотеку jQuery UI, поэтому если она не используется у вас на сайте включите данный пункт
  • Подключить тему jQuery UI – Компонент использует тему jQuery UI для автодополнения адреса. Если она не используется у вас на сайте включите данный пункт
  
  

Результат

Компонент выводит на сайт несколько текстовых и скрытых полей для ввода адреса. Компонент не генерирует формы (<form></form>) для отправки на сервер введённой пользователем информации! Это сделано для того чтобы вы без проблем могли включить поля для ввода адреса в любую другую существующую форму на вашем сайте (к примеру форму оформления заказа).