Этот модуль входит в нашу Подписку.
Оформите подписку — и пользуйтесь всеми модулями без ограничений.
Расширенные геолокации
Модуль дополняет стандартную геолокацию 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.21.X
- 4.20.X
- 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.2 от 26.08.2026
[*] Обновлены описание и инструкция модуля, добавлены локализованные материалы и логотип.
v3.1.0 от 2025-12-23
[+] Добавлено:.
[*] Поле с количеством оставшихся запросов.
[*] API-методы для работы с городами.
[+] Возможность получать город из профиля покупателя или из настройки местоположения по умолчанию.
[*] Совместимость с новым модулем городов на CS-Cart 4.19+.
[!] Исправлено:.
[*] Поиск города по внутреннему вхождению символов.
[*] Значок крестика во всплывающем окне.
[+] Лишний функционал добавления городов из модуля, работа перенесена на сторонний модуль городов.
[*] Выполнен рефакторинг модуля.
v3.0.0 от 2025-01-30
[*] Обновлены названия и описания блоков, а также логотипы.
[+] Добавлено:.
[*] Выполнен рефакторинг модуля.
v2.1.0 от 2024-05-15
[+] Добавлено:.
[*] Стандартизирован код модуля по шаблону.
[*] Стандартизированы текстовые файлы модуля.
[*] Изменены короткие теги v2.0.0.
[*] 15.05.2023.
[+] Добавлено лицензирование.
v1.2.1 от 2026-06-30
[!] Исправлено:.
[*] Улучшена совместимость со списками городов, где часть дополнительных полей отсутствует.
v1.2.0 от 2026-02-21
[+] Добавлен выбор сервиса геолокации между 2ip и SypexGeo.
[*] Поле API key переиспользовано для платного ключа 2ip и ключа SypexGeo.
[*] Обновлена логика определения города с учетом выбранного сервиса.
Обозначения:
[+] Добавлено
[-] Удалено
[*] Изменено
[!] Исправлена ошибка