Этот модуль входит в нашу Подписку.
Оформите подписку — и пользуйтесь всеми модулями без ограничений.
Расширенные геолокации
Модуль дополняет стандартную геолокацию CS-Cart, помогает точнее определять город покупателя и использовать его данные в витрине и оформлении заказа. Он полезен, когда нужно показывать актуальный город, давать выбор вручную и подстраивать checkout под выбранное местоположение.
Для чего нужен
Модуль нужен, чтобы определять город покупателя по IP через 2ip или SypexGeo, позволять выбрать город вручную, а также подставлять данные местоположения в оформление заказа. Он помогает связать геолокацию, блоки на витрине и данные checkout в одном сценарии работы.
Основные возможности
Автоматическое определение города по IP.
Выбор между сервисами 2ip и SypexGeo.
Ручной выбор города на витрине и всплывающее подтверждение.
Готовые блоки выбора города и дополнительной информации о городе.
Подстановка города, региона и страны в checkout.
Поддержка модулей cities и rus_cities.
Ограничение числа запросов к сервису геолокации и защита от ботов.
Как работает
Модуль запрашивает геолокацию по IP, сохраняет выбранный город в сессии и переносит данные в поля покупателя на checkout. Если активен модуль городов, найденный город сопоставляется с записью в базе. Если сопоставление невозможно, используются данные API напрямую.
Администратор может выбрать сервис геолокации, задать API-ключ, ограничить число запросов и скрыть всплывающее окно, если оно не нужно.
Остались вопросы по работе модуля?
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Владельцам
- Покупателям
- English
- Русский
- 4.19.X
- 4.18.X
Инструкция к модулю Расширенные геолокации
Что делает модуль
Модуль определяет город покупателя по IP через 2ip или SypexGeo, позволяет выбрать город вручную и подставляет данные местоположения в оформление заказа. Если активен модуль городов, он использует его данные и может связать найденный город с записью в базе.
Где находится модуль
Настройки модуля находятся в Администрирование → Модули → Управление модулями → Расширенные геолокации.
Блоки модуля добавляются через Дизайн → Менеджер блоков: MS: Местоположение покупателя и MS: Информация о городе.
Список городов открывается в админке через раздел MS: Расширенные геолокации. Города.
Настройки
Сервис геолокации — выберите 2ip или SypexGeo.
Ключ API — общий ключ для выбранного сервиса. Для SypexGeo укажите ключ SypexGeo, для 2ip укажите платный ключ 2ip.
Количество запросов — дневной лимит запросов к сервису геолокации для одного пользователя.
Скрыть всплывающее окно — отключает показ popup после определения города.
Как использовать
1. Откройте настройки модуля и выберите сервис геолокации.
2. Укажите API-ключ, если он нужен выбранному сервису.
3. При необходимости задайте лимит запросов и включите скрытие popup.
4. Добавьте блок выбора города на витрину, если нужен ручной выбор города.
5. Добавьте блок с информацией о городе, если нужно показывать дополнительный текст или ссылку.
6. Если используются модули cities или rus_cities, проверьте список городов и заполнение дополнительных полей.
Как проверить работу
1. Откройте витрину с нового IP и проверьте автоматическое определение города.
2. Выберите город вручную и убедитесь, что он сохраняется в сессии.
3. Проверьте, что в checkout подставляются город, регион и страна.
4. Если включено всплывающее окно, убедитесь, что оно показывается после определения города.
5. Если используются модули городов, проверьте, что выбранный город отображается в их списке и в блоках модуля.
История изменений
v1.2.0 от 21.02.2026
[*] Добавлен выбор сервиса геолокации между 2ip и SypexGeo
[*] Переиспользовано поле API key для платного ключа 2ip и ключа SypexGeo
[*] Обновлена логика определения города с учетом выбранного сервиса
v3.1.0 от 23.12.2025
[+] Добавлено поле с количеством оставшихся запросов
[!] Исправлен поиск города по внутреннему вхождению символов
[-] Убран лишний функционал добавления городов из модуля, работа перенесена на сторонний модуль городов
[!] Исправлен значок крестика во всплывающем окне
[+] Добавлены API-методы для работы с городами
[+] Добавлена возможность получать город из профиля покупателя или из настройки местоположения по умолчанию
[+] Выполнен рефакторинг модуля
[+] Добавлена совместимость с новым модулем городов на CS-Cart 4.19+
v3.0.0 от 30.01.2025
[*] Обновлены названия и описания блоков, а также логотипы
[+] Выполнен рефакторинг модуля
v2.1.0 от 15.05.2024
[+] Стандартизирован код модуля по шаблону
[+] Стандартизированы текстовые файлы модуля
[*] Изменены короткие теги <? на обычные <?php
v2.0.0 от 15.05.2023
[*] Добавлено лицензирование
Обозначения:
[+] Добавлено
[-] Удалено
[*] Изменено
[!] Исправлена ошибка