Модуль ms_geolocation работает на основе независимого сервиса SypexGeo. Модуль заменяет стандартную геолокацию CS-Cart и работает точнее аналогов от Яндекса и Google. Модуль определяет город покупателя по IP-адресу и позволяет выбирать город вручную.
Основные возможности
Определение города по IP: Автоматическое определение города покупателя по IP-адресу через SypexGeo.
Выбор города: Возможность выбора города покупателем вручную.
Интеграция с модулями городов: Работа с модулями cities или rus_cities для управления городами.
Блоки геолокации: Готовые блоки для отображения выбора города и информации о городе.
Всплывающее окно: Настраиваемое всплывающее окно для выбора города.
Дополнительная информация о городе: Возможность добавления дополнительной информации о городе (фраза, ссылка).
Как работает модуль
Модуль использует следующие механизмы:
База данных: При установке модуль выполняет миграции для создания необходимых структур данных.
Функции работы с городами: fn_ms_geolocation_get_cities_tables() определяет используемые таблицы городов в зависимости от установленных модулей. Если активен модуль cities, используются таблицы cities и city_descriptions. Если активен модуль rus_cities — таблицы rus_cities и rus_city_descriptions.
API SypexGeo: Интеграция с API SypexGeo для определения города по IP. Использование API ключа для доступа к сервису.
Контроллеры: geo_cities.php — обработка выбора города на витрине; cities.post.php — управление городами в админке; ms_geolocation.php — настройки модуля.
Блоки: Регистрирует блоки cities (выбор города) и city_phrase (информация о городе).
Где находится функциональность
Административная панель: Настройки модуля с API ключом SypexGeo; управление городами (если модуль cities или rus_cities установлен).
Витрина: Блоки выбора города и информации о городе; всплывающее окно для выбора города (если не скрыто); автоматическое определение города при первом посещении.
Настройки модуля
Ключ API (apikey): API ключ для доступа к сервису SypexGeo.
Количество запросов (count_requests): Количество запросов для определения города (по умолчанию 3).
Скрыть всплывающее окно (hide_popup): Скрыть всплывающее окно выбора города.
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Владельцам
- Покупателям
- English
- Русский
- 4.19.X
- 4.18.X
Оформление подписки
Мы переходим на новую подписную систему, открывая для вас полный доступ ко всем нашим модулям. Подробную информацию об условиях подписки и часто задаваемых вопросах вы можете найти здесь.
Обратите внимание, что приобретение модулей по отдельности теперь недоступно — воспользоваться ими возможно исключительно в рамках подписки.
За единую стоимость подписки - 2000 руб/мес. Вы получаете доступ ко всем модулям.
Как оформить подписку у нас на сайте
Зарегистрируйтесь или авторизуйтесь на нашем сайте и выберите интересующий вас модуль
Нажмите кнопку Запросить триал доступ
Введите в поле URL сайта ваш домен в формате domain.com, без www и https://

Далее в личном кабинете в разделе загрузки вы сможете скачать нужный вам модуль и менеджер модулей для удобного управления модулями и оформления подписки.


Далее у вас есть 7 дней для тестирования выбранного модуля.
По истечении строка триала, для продолжения работы необходимо оплатить подписку.
Сделать это можно из менеджера модулей.
На выбор вы можете оплатить:
для зарубежных карт - PayPal
для РФ карт - Robokassa

Или на странице на сайте https://makeshop.pro/subscription/

При оплате нужно указать электронную почту с которой вы оформляли триал доступ.
При покупке на маркетплейсе CS-Cart
При покупке любого модуля зарубежной картой или картой РФ
Так как система при оформлении подписки не спрашивает дополнительных вопросов (на какой домен подписка оформляется) желательно вводить электронную почту ту же что и ваша учетная запись у нас на сайте (если она есть), тогда ваши учётки свяжутся между собой.
Выберите интересующий модуль и нажмите кнопку “Оформить подписку“

Далее после оплаты подписки вы сможете скачать модуль перейдя в раздел “Загрузки“, там выберите свой заказ и в нем будет ссылка на скачивание.

В дальнейшем, для получения новых модулей по подписке рекомендуем пользоваться нашим сайтом.
Всё что вам будет нужно сделать это на интересующем вас модуле (после авторизации) нажать кнопку “Запросить модуль по подписке“ и после одобрения скачать его в разделе загрузки.

Если что-то пойдет не так - проверьте выписалась ли лицензия

Найдите заказ с датой оформления подписки

Убедитесь что у вас прописался URL сайта в заказ

Если URL сайта неправильный и вам нужно обновить его: переходите в пункт меню “Мои модули”

Ищите модуль и проверьте URL магазина для которого выписана подписка

Установка
1. Убедитесь, что модуль активирован в разделе Администрирование → Модули → Управление модулями.
2. Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart.
3. При установке модуль выполняет миграции для создания необходимых структур данных.
Настройка
1. Получение API ключа SypexGeo: Зарегистрируйтесь на сайте SypexGeo (https://sypexgeo.net/), получите API ключ.
2. Настройка модуля: Перейдите в Администрирование → Модули → Управление модулями → MS: Геолокация от SypexGeo. Введите API ключ в поле «Ключ API». Укажите количество запросов (по умолчанию 3). Включите «Скрыть всплывающее окно» при необходимости. Сохраните изменения.
3. Проверка статуса API ключа: В настройках модуля отображается статус API ключа. Убедитесь, что ключ активен.
Использование для администратора
1. Добавление блоков: Перейдите в Администрирование → Дизайн → Менеджер блоков. Добавьте блок «MS: Местоположение покупателя» (cities) для выбора города. Добавьте блок «MS: Информация о городе» (city_phrase) для отображения информации о городе.
2. Управление городами (если установлен модуль cities или rus_cities): Перейдите в Администрирование → MS: Геолокация от SypexGeo. Города. Управляйте списком городов, настраивайте дополнительную информацию (фраза, ссылка).
Использование для покупателя
1. Автоматическое определение: При первом посещении модуль определяет город по IP. Может отображаться всплывающее окно для подтверждения.
2. Выбор города вручную: Найдите блок выбора города, нажмите для открытия списка, выберите город. Город сохраняется в сессии.
3. Просмотр информации: На странице отображается информация о выбранном городе (настраивается администратором).
Проверка работы
1. Откройте сайт с нового IP — проверьте автоматическое определение города.
2. Выберите город вручную — убедитесь, что сохранение работает.
3. Проверьте отображение блоков на страницах сайта.
Устранение неполадок
Город не определяется: Проверьте API ключ и его статус.
Всплывающее окно не отображается: Проверьте настройку «Скрыть всплывающее окно».
Блоки не работают: Убедитесь, что блоки добавлены через менеджер блоков и модуль активирован.
v1.2.0
от 21.02.2026
- [\*] Обновлен шаблон модуля
v3.1.0
от 23.12.2025
- [+] Количество оставшиеся запросов
- [!] Поиск по городу производился по внутреннему вхождению символов, исправлено
- [-] Убран лишний функционал добавления городов из модуля, все работает через сторонний модуль "Города"
- [!] Исправлен значек крестика в попап окне
- [+] Добавлены API методы для работы с городами
- [+] Добавлена возможность в api получать город из профиля покупателя или настройки Оформление заказа -> Местоположение покупателя по умолчанию
- [+] Рефакторинг модуля
- [+] Добавление совместимости с новым модулем городов на версии CS-Cart > v4.19.0
v3.0.0
от 30.01.2025
- [\*] Обновлены названия и описания блоков, а также логотипы
- [+] Рефакторинг модуля
v2.1.0
от 15.05.2024
- [+] Стандартизация кода модуля по шаблону
- [+] Стандартизация текстовых файлов модуля
- [\*] Изменены короткие теги <? на обычные <?php
v2.0.0
от 15.05.2023
- [\*] Лицензирование
Обозначения:
[+] Добавлено | [-] Удалено | [\*] Изменено | [!] Исправлена ошибка
Ваш запрос отправлен!
Ваш запрос на доработку модуля отправлен в техническую поддержку. Мы изучим ваши пожелания и дадим обратную свзязь.
Вам придет уведомление на указанный Email.