-------
Модуль определяет город по IP-адресу пользователя и устанавливает нужное местоположение в форме заказа.
Основные возможности модуля:
- модуль устанавливается вместе с базой IP-адресов;
- дополнительный обработчик геолокации называется «Модуль askaron.geo на основе локальной базы Sypex Geo»;
- обработчик геолокации может применяться в типовом и нетиповом функционале Битрикса;
- обработчик геолокации быстро узнает город, к сторонним сервисам не обращается, не замедляет работу сайта,
- используется производительная база Sypex Geo,
- локальную базу Sypex Geo можно обновлять;
- модуль поддерживает все возможности геолокаций Битрикса, может работать, если включено несколько обработчиков геолокации или только один любой;
- модуль содержит дополнительные методы для разработчика для IP и для Местоположения из Интернет-магазина;
- модуль находит город по IP и устанавливает местоположение из Интернет-магазина на странице оформления заказа, согласно настройкам модуля (город по умолчанию по IP или заданный пользователем);
Использование:
Модуль устанавливается и работает на любых редакциях 1С-Битрикс Управление сайтом и Битрикс24 в коробке. Функционал определения города по IP есть везде.
Однако функционал поиска местоположения для подстановки в заказ может работать только, если есть модуль "Интернет-магазин" (sale):
- Малый бизнес
- Бизнес
- Энтерпрайз
- Битрикс24 в коробке (любые редакции)
Документация:
http://askaron.ru/api_help/course1/lesson151/
- незначительные исправления
- Финальная версия серии обновлений модуля с 3.0.0 до 6.0.0, рекомендуется к внедрению.
- В 6.0.0 исправлено описание опций. Исправлен текст о возможностях модуля.
- После 3.0.0 до 6.0.0 значительно переделан модуль, добавлена совместимость с API геолокаций 1С-Битрикс. Но оставлен старый функционал и совместимость после обновлений.
- Если страшно обновлять с 3.0.0 до 6.0.0, то сделайте себе копию папки /bitrix/modules/askaron.geo/
- Метод \Askaron\Geo\Location::getLocation(); больше не ищет по встроенной базе Sypex Geo, теперь метод ищет геолокацию по обработчикам геолокаций.
- Проверяется ситуация, если найдены города с одинаковыми названиями. Метод \Askaron\Geo\Location::getLocation(); теперь использует метод интернет-магазина \Bitrix\Sale\Location\GeoIp::getLocationId($ip, "ru");, чтобы лучше и точнее находить Город с учётом Региона и Страны. Как и раньше, требуется, чтобы названия местоположений были заполнены на русском языке.
- Улучшены инструменты на вкладке Проверка на странице настроек модуля
- При установке модуля обработчик геолокации автоматически устанавливается включённым.
- При обновлении обработчик геолокации включается.
- Незначительные изменения API
- Новое описание модуля на странице настройки модуля. Выводится, включен обработчик геолокации или нет
- Большое изменение API модуля. Добавлена совместимость с API Битрикса. Минимальная версия Главного модуля 1С-Битрикс теперь 17.0.9.
- Добавлена поддержка функционала Геолокации Битрикса. Теперь модуль содержит один из Обработчиков геолокации, дополнительно к предустановленным. Модуль может теперь использоваться в типовом функционале Битрикса для поиска города (например в стандартном поиске местоположения в новой форме заказа), если включить обработчик на странице списка обработчиков геолокации.
- После обновления на странице «Настройки - Настройки продукта - Геолокация» должен появиться новый обработчик. Или он будет в списке на кнопке «Добавить».
- Совместимость API со версиями модуля сохранена. Обновлять можно на сайтах, где раньше модуль стоял.
- Если страшно обновлять, то сделайте бекап папки /bitrix/modules/askaron.geo/
- Метод \Askaron\Geo\Info::getIp() теперь внутри вызывает стандартный \Bitrix\Main\Service\GeoIp\Manager::getRealIp(). Они практически одинаковые.
- Метод \Askaron\Geo\Info::getIp(), как и раньше, возвращает другой $ip, если вызывали \Askaron\Geo\Info::setIp( $ip )
- Метод \Askaron\Geo\Info::getSxGeoCityFull( $ip = '' ) теперь содержит необязательный параметр $ip. Если IP не задан или пустой, то как и раньше адрес берется из \Askaron\Geo\Info::getIp().
-
Метод \Askaron\Geo\Info::getSxGeoCityFull() теперь совсем нежелательно использовать в своём коде.
Как и раньше работает метод $arLocation = \Askaron\Geo\Location::getLocation();
Но ещё появился типовой метод Битрикса с нашим и другими обработчиками. Возвращает объект геолокации, или null, когда не найдено, или выключены все обработчики.
$result = \Bitrix\Main\Service\GeoIp\Manager::getDataResult( \Askaron\Geo\Info::getIp(), "ru"); - Метод \Askaron\Geo\Info::getSxGeoCityFull() работает быстрее, чем \Bitrix\Main\Service\GeoIp\Manager::getDataResult(). Но это практически незаметно. Метод \Bitrix\Main\Service\GeoIp\Manager::getDataResult() работает с любыми обработчиками геолокации, поэтому используйте теперь его.
-
Метод $arLocation = \Askaron\Geo\Location::getLocation(); теперь внутри себя вызывает \Bitrix\Main\Service\GeoIp\Manager::getDataResult и обращается ко всем установленным обработчикам.
Если все обработчики геолокации выключены, или ничего не найдено, то вызывает \Askaron\Geo\Info::getSxGeoCityFull второй раз, для совместимости на сайтах, где раньше стоял модуль.
\Askaron\Geo\Location::getLocation(); запоминает результат у пользователя поэтому лишняя нагрузка не создается.
- Разрешена установка модуля на редакции, где нет модуля Интернет-магазин (sale).
Методы определения города по IP работают на любых редакциях. Для собственных задач определения города по IP, которые не связаны с модулем sale, модуль можно применять.
Если нет модуля sale, то нет местоположений и нет формы заказа. Соответственно не будет доступен функционал модуля по установке местоположения в форму заказа.
- Незначительные исправления на странице настроек модуля
- Обновлена база городов в ядре модуля. Изменён тип базы городов с Windows-1251 на UTF8
- ВАЖНОЕ замечание для старых сайтов в кодировке 1251:
Теперь Битрикс поставляется только в кодировке UTF8 начиная с версии 24.0.0 и все сайты теперь в UTF8.
В новой версии модуля askaron.geo база городов SypexGeo теперь тоже в кодировке UTF8 вместо Windows-1251.
Мы не делаем проверку работоспособности модуля на Windows-1251, не гарантируем правильную работу на Windows-1251.
Если у вас старый сайт в Windows-1251, то вы можете попробовать обновить модуль. Только сделайте копию папки /bitrix/modules/askaron.geo/ перед обновлением, если что-то будет не так, вы переустановите модуль. - Если был дополнительный файл /bitrix/php_interface/include/askaron.geo/SxGeoCity.dat, то он переименован SxGeoCity_old1.dat
- Теперь если вы будете обновлять самостоятельно /bitrix/php_interface/include/askaron.geo/SxGeoCity.dat, то его надо скачивать в формате UTF8
Использование:
Модуль устанавливается и работает на любых редакциях 1С-Битрикс Управление сайтом и Битрикс24 в коробке. Функционал определения города по IP есть везде.
Однако функционал поиска местоположения для подстановки в заказ может работать только, если есть модуль "Интернет-магазин" (sale):
- Малый бизнес
- Бизнес
- Энтерпрайз
- Битрикс24 в коробке (любые редакции)
Установка
Модуль устанавливается из маркетплейса, как и любые другие модули. Никаких вопросов не задает.
После установки проверьте, какие обработчики геолокаций у вас включены, должен появиться новый обработчик:
Настройки - Настройки продукта - Геолокации
Настройки модуля:
Настройки - Настройки продукта - Настройки модулей - Город по IP, определение местоположения для доставки
Требования к интернет-магазину:
Для поиска местоположения из Интернет-магазина должен быть установлен модуль Интернет-магазин (sale) и в нём должны быть заполнены Местоположения. Местоположения можно установить стандартным мастером.
В местоположениях должны быть заполнены названия городов на русском языке.
Для подстановки местоположения в форме заказа должно быть свойство типа «Местоположение».
Техподдержку оказывают разработчики лично.
Пожалуйста, ознакомьтесь с документацией по модулю «Отзывы о товаре». Там всё очень подробно и понятно описано:
http://askaron.ru/api_help/course1/lesson151/
Мы стараемся отвечать, как можно быстрее. Не дольше 5 рабочих часов. Иногда отвечаем в выходные дни.
Срок ответа не регламентирован. Может быть и дольше 5 часов. Это связано с загрузкой разработчиков, мы не только техподдержку оказываем, но и проекты делаем.
Еще раз: прежде чем писать в техподдержку, прочитайте описание модуля и ознакомьтесь с документацией. Это сэкономит время вам и нам.
При обращении в техподдержку сразу присылайте адрес страницы, на которой проблема, логин и пароль администратора. Это ускорит решение вопроса. Присылайте свой телефон или скайп, чтобы с вами можно было оперативно связаться.
Пишите в техподдержку на mail@askaron.ru
Для покупки товара в нашем интернет-магазине выберите понравившийся товар и добавьте его в корзину. Далее перейдите в Корзину и нажмите на «Оформить заказ» или «Быстрый заказ».
Если оформляете быстрый заказ: напишите ФИО, телефон и e-mail. Вам перезвонит менеджер и уточнит условия заказа. По результатам разговора вам придет подтверждение оформления товара на почту или через СМС. Теперь останется только ждать доставки и радоваться новой покупке.
Оформление заказа в стандартном режиме выглядит следующим образом. Заполняете полностью форму по последовательным этапам: адрес, способ доставки, оплаты, данные о себе. Советуем в комментарии к заказу написать информацию, которая поможет курьеру вас найти. Нажмите кнопку «Оформить заказ».
Оплачивайте покупки удобным способом. В интернет-магазине доступно 3 варианта оплаты:
- Наличные при самовывозе или доставке курьером. Специалист свяжется с вами в день доставки, чтобы уточнить время и заранее подготовить сдачу с любой купюры. Вы подписываете товаросопроводительные документы, вносите денежные средства, получаете товар и чек.
- Безналичный расчет при самовывозе или оформлении в интернет-магазине: карты МИР. Чтобы оплатить покупку на сайте, система перенаправит вас на сервер платежной системы. Здесь нужно ввести номер карты, срок действия и имя держателя.
- Электронные системы при онлайн-заказе: ЮMoney. Для совершения покупки система перенаправит вас на страницу платежного сервиса. Здесь необходимо заполнить форму по инструкции.
- Безналичная оплата на наш расчетный счет по выставленному счету.
Экономьте время на получении заказа. В интернет-магазине доступно 4 варианта доставки:
- Электронная поставка - все необходимые сведения о лицензии, праве пользования, кодах, ключах и др. высылаются покупателю на его e-mail.
- Курьерская доставка. Когда товар будет отправлен с нашего склада, Вам придет уведомление. В день доставки с Вами заблаговременно свяжется курьер для уточнения времени и деталей доставки. Доставка производится "до двери". Осмотрите упаковку на целостность и соответствие указанной комплектации.
- Постамат. Когда заказ поступит на точку, на Ваш телефон или e-mail придет уникальный код. Заказ нужно оплатить в терминале постамата. Срок хранения — 3 дня.
- Доставка Почтой России. Когда заказ придет в отделение, на Ваш адрес придет извещение о посылке. Перед оплатой Вы можете оценить состояние коробки: вес, целостность. Вскрывать коробку самостоятельно Вы можете только после оплаты заказа. Один заказ может содержать не больше 10 позиций и его стоимость не должна превышать 100 000 р.
Дополнительная информация.
Изучите полный алгоритм продления лицензий на модули 1С-Битрикс: Маркетплейс, включая активацию льготных купонов. Мы детально разбираем все условия: обязательный 30-дневный срок для сохранения максимальной выгоды, пропорциональное ценообразование (12,5%, 25%, 50% от цены модуля) и ограничение по минимальной сумме в 500 рублей. Этот гайд поможет вам эффективно планировать бюджет и гарантировать актуальность вашего проекта.