Зачем этот модуль нужен? Данный модуль позволяет заменять поле ввода адреса при оформлении заказа на удобную форму с возможностью обращаться к базе адресов Российской Федерации («ФИАС»).
Формы позволяет вводить адреса не только крупных городов, но и любой мелкой деревни из базы адресов Российской Федерации («ФИАС»). При этом форма исключает возможность ошибки предоставляя выбирать населенный пункт, улицу или дом из предоставленного списка. Все списки снабжены выпадющими автоподсказками.
Таким образом, с помощью этой формы можно выбирать населенный пункт (город, поселок и т.д.) из списка городов РФ, затем улицу из списка улиц этого населённого пункта, номер дома из списка домов выбранной улицы. Модуль определяет выбранный город или область из списка местоположений сайта и показывает отфильтрованные только для него улицы или населенные пункты.
Для удобства восприятия, выбранный адрес отображается на карте. Карта уточняется по мере ввода адреса.
Также форма автоматически определит почтовый индекс для случаев если предстоит отправить заказ по почте.
Форма предусматривает раздельный ввод города, улицы, дома и квартиры. Это полезно в случае, например, если предстоит передать заказ службе доставки и требуется передать адрес покомпонентно, а не единой строкой.
Как это работает? Модуль использует API сервис «Кладр Api»
Технически модуль меняет поле типа textarea, предназначенное для ввода адреса при оформлении заказа, на удобную форму, позволяющую выбрать адрес из базы адресов Российской Федерации(«ФИАС»). По указанному в настройках модуля символьному коду свойства "адрес доставки" определяется текстовое поле, которое стирается, а вместо него подставляется форма Кладр. Местоположение (город или область) из свойства типа "местоположение" устанавливается в качестве родительского для всех полей формы, т.е. поиск адреса в форме осуществляется именно для выбранного местоположения (если это свойство есть)
Кладр 2.0 В версии 2.0 появилась возможность производить замену стандартного поля "Местоположение" на поле выбора города из КЛАДР. Это дает большое преимущество. Во-первых потому что в базе КЛАДР есть абсолютно все населенные пункты России вплоть до самых маленьких деревень и сел. Во вторых функционал работает в разы быстрее чем стандартные подсказки битрикса. Кроме того сохранена возможность вернуться к стандартному полю, для клиентов, которые делают заказ не в Россию. Также модуль научился определять поле установленное как индекс и подставлять туда значение пришедшее из КЛАДР. При всем при этом расчет доставки и другие функциональные зависимости от поля с Местоположением остались не тронутыми, так как модуль сопоставляет населенные пункты КЛАДРА и Битрикса. Если например сопоставление завершилось неудачей и город, село или деревня не был найден в Битриксе, то за расчет будет взят его "родитель" (Регион, область).
Внимание! Функционал поддерживается только в новом шаблоне оформления заказа и в версии Битрикс > 16.
Также в модуле добавлена возможность указывать улицу, дом и квартиру в разные свойства оформления заказа, для тех случаев, когда необходимо производить внешнюю интеграцию с другими автоматизированными системами (например 1С), либо для удобства восприятия и последующей обработки заказов менеджерами магазина.
Также в новой версии были исправлены многие специфичные проблемы, возникавшие у клиентов за все время работы модуля.
Примеры интернет-магазинов
kalyanis.net
Совместимость с битрикс 17. Модуль совместим с битрикс 17 в режиме с включенной поддержкой устаревших событий. К сожалению, в некоторых новых шаблонах могут наблюдаться небольшие неточности, связанные с версткой. Проблемы с версткой мы можем решить только в рамках платной техподдержки.
Установка модуля из маркетплейса происходит стандартным способом.
После установки модуля необходимо зайти на страницу настроек и заполнить их в соответствии с указаниями из раздела FAQ.
В настройках модуля необходимо указать символьный код свойства "адрес доставки". Если на сайте несколько типов покупателей, то у них должен быть одинаковый символьный код.
Для настройки модуля требуется ввести код свойства, поле от которого требуется заменить.
Стилизация формы выбора адреса под актуальный стандартный шаблон компонента оформления заказа;
Доработки для поддержки PHP 8 версии;
Code style и рефакторинг;
Прочие мелкие доработки;
Ввиду обновления большинства файлов модуля, рекомендуется до установки обновления сделать резервную копию сайта, особенно если модуль был модифицирован сторонними разработчиками.
2.0.4, 20.09.2019
Новая опция 'Не выводить форму КЛАДР для служб доставки': актуально для самовывоза, с выбором адреса ПВЗ через виджет службы доставки
Исправление мелких ошибок
Коррективы в документации модуля
2.0.3, 17.07.2019
Модуль переведен на использование JQuery плагина $.fias
Новая опция 'API-ключ Яндекс.Карт'
Коррективы в документации модуля
После установки обновления рекомендуется выполнить сброс кеша в Битриксе.
2.0.2, 29.04.2019
Улучшена работа с профилями пользователей
Новая опция 'Не добавлять почтовый индекс (ZIP) в адрес'
Новая опция 'Не добавлять наименования области и района в адрес'
Исправления в документации, на странице настроек модуля
Прочие небольшие улучшения и исправления
2.0.1, 07.09.2018
Незначительные правки
2.0.0, 30.08.2018
Добавлена возможность производить замену стандартного поля "Местоположение" на поле выбора города из КЛАДР. Добавлена возможность разделять поля адреса на "Улицу", "Дом", "Квартиру". Исправлены ошибки неверного определения индекса некоторых домов. Исправлена ошибка совместимости со СДЕК в новом шаблоне оформления заказа. Исправлены другие незначительные ошибки.
1.5.20, 10.07.2018
Исправлены ошибки
1.5.19, 29.06.2018
„обавлена возможность отключать Api Љарт, если оно загружаетсЯ сторонним скриптом
1.5.18, 06.06.2018
Ошибка совместимости со Сдек
1.5.17, 04.06.2018
Исправлены ошибки совместимости с php 7 версии.
1.5.16, 01.02.2018
Перенос запросов на более стабильный сервер kladr-api. Токен, полученный в системе "Кладр в облаке" теперь не нужен. Исправлена ошибка совместимости для новых шаблонов.
1.5.15, 21.03.2017
исправлены некоторые ошибки
1.5.14, 09.02.2017
Исправлены проблемы, возникающие при работе с другими странами.
1.5.13, 23.01.2017
Переписаны некоторые внутренние функции для повышения стабильности модуля
1.5.12, 10.01.2017
Внедрена поддержа раздельного поля адреса: для случаев, если поле адрес заменено на поля "улица","дом","квартира"
1.5.11, 09.01.2017
Исправлена ошибка совместимости для новых шаблонов
1.5.10, 29.11.2016
Исправлена ошибка в фформирвоании адреса
1.5.9, 05.10.2016
Добавлены поддержка деревень
1.5.8, 29.09.2016
Изменен механизм формирования адреса
1.5.7, 18.08.2016
Исправлена ошибка в старых версиях IE
1.5.6, 12.08.2016
Решены проблемы с выводом формы в новых шаблонах
Изменен способ вывода формы кладр
1.5.4, 28.06.2016
испрвлены некоторые проблемы совместимости шаблнов
1.5.3, 24.06.2016
Добавлена возможность отключать модуль
1.5.1, 20.06.2016
Добавлена поддержка Битрикс 16
Добавлена возможность отслеживать ввод адреса
Исправлены некоторые ошибки
1.1.23, 18.02.2016
Исправлена ошибка отображения некоторых городов на некоторых сайтах
1.1.22, 16.11.2015
Добавлена проверка работоспособности внешнего сервиса kladr-api
Ошибки внешнего сервера теперь не критичны
Исправлены ошибки с кодировкой
Добавлена проверка cUrl
1.1.18, 02.11.2015
Испрвслена js ошибка
1.1.17, 02.11.2015
Добавлена возможность отключить вывод карты
Исправлена ошибка, связанная с выбором в качестве поля адреса текстового поля (вместо textarea)
1.1.16, 26.10.2015
Пофиксена проблема с позиционированием карты в случае сёл
1.1.15, 19.10.2015
Исправлены ошибки поддержки https
1.1.14, 16.07.2015
Добавлены уведомления о работе модуля
Изменена логика работы при неустановленных местоположениях
1.1.12, 03.07.2015
Обновлен алгоритм выбора города из базы, что ускорит работу и повысит правильность определения города
1.1.11, 23.06.2015
обновление css формы
1.1.10, 23.06.2015
Увеличены возможности интеграции с другими модулями
1.1.9, 09.06.2015
повышение стабильности работы модуля
1.1.7, 09.06.2015
Исправлена ошибка прои невбранном городе
1.1.6, 26.05.2015
Исправлена ошибка со свойствами заказа не попадающими в профиль
1.1.5, 25.05.2015
Повышена стабильность работы. Исправлены языковые ошибки
Совместимость с битрикс 17. Модуль совместим с битрикс 17 в режиме с включенной поддержкой устаревших событий. К сожалению, в некоторых новых шаблонах могут наблюдаться небольшие неточности, связанные с версткой. Проблемы с версткой мы можем решить только в рамках платной техподдержки.