Информация для пользователей: 22 декабря 2022 года выпущена новая мажорная версия модуля.
Модуль «Определение города по IP адресу пользователя» определяет город посетителя вашего сайта по его IP-адресу.
Модуль «Определение города по IP адресу пользователя» использует сервис MaxMind. При первом обновлении базы она загружается в Highload-блоки, после чего работает с данными непосредственно из них. Если удаленная база не обновлялась после последней загрузки, то на вкладке База городов кнопки с обновлением не будет - это значит, у вас уже установлена актуальная версия базы.
Особенности модуля:
1. Применяются локальные базы
Преимущество локальной базы данных IP-адресов в том, что сайт не зависит от внешних сервисов геопозиционирования, и их функционирование не влияет на работу модуля. Недостаток — эти БД нужно периодически обновлять, для чего в настройках предусмотрен специальный интерфейс.
Локальные базы хранятся в Highload-блоках, что позволяет гибко настраивать города и привязку к ним.
2. Автоматическое определение местоположения
Решение автоматически определит город посетителя по его IP и может выводить окна с подтверждением города либо выбором другого, из списка или в строке поиска.
3. Поставляются готовые компоненты
В модуле присутствует компонент, необходимый для отображения выбранного местоположения и возможности его изменения пользователем.
Модуль «Определение города по IP адресу пользователя» работает на любой редакции «1С-Битрикс: Управление сайтом».
Стандартная установка через систему обновления сайта.
Модуль работает только с версии главного модуля 21.1200.800 и выше, рекомендуемая версия PHP - 7.4.*.
С версии модуля 2.2.1 добавлена поддержка PHP 8.2
На этапе установки модуля будет предложено "Загрузить данные только для России и стран СНГ". Оставьте галочку включенной, если вам не нужен выбор зарубежных городов.
Если галочка установлена, модуль при обновлении базы будет загружать только города, которые входят в страны СНГ и Россию.
Как альтернатива API можно привязываться к cookie REASPEKT_GEOBASE. Либо использовать библиотеку модуля, статическую функцию getAddr() в классе Reaspekt\Geobase\DefaultCities. В этом направлении планируются доработки в дальнейшем.
Пример кода по работе с cookie:
<?
// Получить через класс-обертку:
use \Reaspekt\Geobase\DefaultCities;
$arCityInfo = DefaultCities::getAddr();
// Получить через работу напрямую с cookie
$request = \Bitrix\Main\Application::getInstance()->getContext()->getRequest();
$strData = $request->getCookie("REASPEKT_GEOBASE");
$arCityInfo = current(\CUtil::JsObjectToPhp($strData));
?> |
Внутри массива $arCityInfo будут ключи CITY - название города, OKRUG - название страны, REGION - название региона/области, ID - ID города, UF_XML_ID - XML_ID города (по нему связка база IP -> база городов и выбор избранных местоположений), ID - ID выбранного города в highload’e.
Для корректной работы модуля необходимо будет получить ключ API от сервиса Maxmind. Для этого необходимо:
Подписаться на бесплатную триал-версию по ссылке
Заполнить и отправить форму, в графе Intended Use выбрать пункт Personalizing web content
В течение нескольких дней на указанный email вам должно прийти подтверждение, что вы создали аккаунт. Теперь в нем необходимо будет авторизоваться: ссылка на личный кабинет
После этого откроется ваша личная страница с меню слева, там необходимо выбрать пункт Manage License Keys, и нажать справа кнопку Generate new license key
Полученный ключ и надо ввести в поле для API-ключа
На главной странице личного кабинета в самом низу обязательно проверьте, появился ли у вас доступ к базам
Если таблица продуктов пустая, вам необходимо сначала принять лицензионное соглашение. Для этого в адресной строке уберите лишнее - должно остаться https://www.maxmind.com/en/accounts/ID_АККАУНТА/, после этого добавьте к ссылке geolite2/eula. Итого, общая ссылка должна иметь вид: https://www.maxmind.com/en/accounts/ID_АККАУНТА/geolite2/eula. Пролистайте страницу до конца, поставьте галочку соглашения, и нажмите кнопку I Agree. После этого доступ к продуктам должен появиться автоматически.
После установки необходимо на страницу добавить компонент "Определение местоположения по IP"
<?$APPLICATION->IncludeComponent( "reaspekt:reaspekt.geobase.city", "", Array( "CHANGE_CITY_MANUAL" => "Y" )); ?> |
Для покупки товара в нашем интернет-магазине выберите понравившийся товар и добавьте его в корзину. Далее перейдите в Корзину и нажмите на «Оформить заказ» или «Быстрый заказ».
Если оформляете быстрый заказ: напишите ФИО, телефон и e-mail. Вам перезвонит менеджер и уточнит условия заказа. По результатам разговора вам придет подтверждение оформления товара на почту или через СМС. Теперь останется только ждать доставки и радоваться новой покупке.
Оформление заказа в стандартном режиме выглядит следующим образом. Заполняете полностью форму по последовательным этапам: адрес, способ доставки, оплаты, данные о себе. Советуем в комментарии к заказу написать информацию, которая поможет курьеру вас найти. Нажмите кнопку «Оформить заказ».
Оплачивайте покупки удобным способом. В интернет-магазине доступно 3 варианта оплаты:
- Наличные при самовывозе или доставке курьером. Специалист свяжется с вами в день доставки, чтобы уточнить время и заранее подготовить сдачу с любой купюры. Вы подписываете товаросопроводительные документы, вносите денежные средства, получаете товар и чек.
- Безналичный расчет при самовывозе или оформлении в интернет-магазине: карты МИР. Чтобы оплатить покупку на сайте, система перенаправит вас на сервер платежной системы. Здесь нужно ввести номер карты, срок действия и имя держателя.
- Электронные системы при онлайн-заказе: ЮMoney. Для совершения покупки система перенаправит вас на страницу платежного сервиса. Здесь необходимо заполнить форму по инструкции.
- Безналичная оплата на наш расчетный счет по выставленному счету.
Экономьте время на получении заказа. В интернет-магазине доступно 4 варианта доставки:
- Электронная поставка - все необходимые сведения о лицензии, праве пользования, кодах, ключах и др. высылаются покупателю на его e-mail.
- Курьерская доставка. Когда товар будет отправлен с нашего склада, Вам придет уведомление. В день доставки с Вами заблаговременно свяжется курьер для уточнения времени и деталей доставки. Доставка производится "до двери". Осмотрите упаковку на целостность и соответствие указанной комплектации.
- Постамат. Когда заказ поступит на точку, на Ваш телефон или e-mail придет уникальный код. Заказ нужно оплатить в терминале постамата. Срок хранения — 3 дня.
- Доставка Почтой России. Когда заказ придет в отделение, на Ваш адрес придет извещение о посылке. Перед оплатой Вы можете оценить состояние коробки: вес, целостность. Вскрывать коробку самостоятельно Вы можете только после оплаты заказа. Один заказ может содержать не больше 10 позиций и его стоимость не должна превышать 100 000 р.
Дополнительная информация.
