The ms_geolocation module is based on the independent SypexGeo service. The module replaces the standard CS-Cart geolocation and works more accurately than analogs from Yandex and Google. The module determines the customer's city by IP address and allows manual city selection.
Main features
City detection by IP: Automatic detection of customer city by IP address via SypexGeo.
City selection: Ability for the customer to manually select a city.
Integration with city modules: Works with cities or rus_cities modules for city management.
Geolocation blocks: Ready-made blocks for displaying city selection and city information.
Popup window: Configurable popup for city selection.
Additional city information: Ability to add additional information about the city (phrase, link).
How the module works
The module uses the following mechanisms:
Database: On installation, the module runs migrations to create the necessary data structures.
City functions: fn_ms_geolocation_get_cities_tables() determines the city tables to use based on installed modules. If cities is active, it uses cities and city_descriptions. If rus_cities is active — rus_cities and rus_city_descriptions.
SypexGeo API: Integration with SypexGeo API for city detection by IP. Uses API key for service access.
Controllers: geo_cities.php — handles city selection on frontend; cities.post.php — city management in admin; ms_geolocation.php — module settings.
Blocks: Registers cities (city selection) and city_phrase (city information) blocks.
Where to find functionality
Administration panel: Module settings with SypexGeo API key; city management (if cities or rus_cities is installed).
Storefront: City selection and city information blocks; city selection popup (if not hidden); automatic city detection on first visit.
Module settings
API Key (apikey): API key for SypexGeo service access.
Number of requests (count_requests): Number of requests for city detection (default 3).
Hide popup (hide_popup): Hide the city selection popup.
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Buyers
- Owners
- 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 магазина для которого выписана подписка

Installation
1. Ensure the module is activated in Administration → Add-ons → Manage add-ons.
2. The module is automatically installed in Multivendor and Ultimate editions of CS-Cart.
3. On installation, the module runs migrations to create the necessary data structures.
Configuration
1. Get SypexGeo API key: Register at SypexGeo (https://sypexgeo.net/), obtain an API key.
2. Module settings: Go to Administration → Add-ons → Manage add-ons → MS: Geolocation from SypexGeo. Enter the API key in the «API Key» field. Set the number of requests (default 3). Enable «Hide popup» if needed. Save changes.
3. Check API key status: The module settings display the API key status. Ensure the key is active.
Usage for administrator
1. Adding blocks: Go to Administration → Design → Block manager. Add the «MS: Customer location» block (cities) for city selection. Add the «MS: City info» block (city_phrase) for displaying city information.
2. City management (if cities or rus_cities module is installed): Go to Administration → MS: Geolocation from SypexGeo. Cities. Manage the city list, configure additional information (phrase, link).
Usage for customer
1. Automatic detection: On first visit, the module detects the city by IP. A popup may appear for confirmation.
2. Manual city selection: Find the city selection block, click to open the list, select a city. The city is saved in the session.
3. Viewing information: The page displays information about the selected city (configured by administrator).
Verification
1. Open the site from a new IP — verify automatic city detection.
2. Select a city manually — ensure saving works.
3. Check block display on site pages.
Troubleshooting
City not detected: Check the API key and its status.
Popup not showing: Check the «Hide popup» setting.
Blocks not working: Ensure blocks are added via the block manager and the module is activated.
v1.2.0
from 21.02.2026
- [\*] Module template updated
v3.1.0
from 23.12.2025
- [+] Number of remaining requests
- [!] City search was performed by internal character match, fixed
- [-] Removed redundant city addition functionality from module, all works through third-party "Cities" module
- [!] Fixed close button icon in popup
- [+] Added API methods for working with cities
- [+] Added ability to get city from customer profile or Checkout -> Default customer location setting in API
- [+] Module refactoring
- [+] Compatibility with new cities module on CS-Cart > v4.19.0
v3.0.0
from 30.01.2025
- [\*] Updated block names and descriptions, as well as logos
- [+] Module refactoring
v2.1.0
from 15.05.2024
- [+] Module code standardization by template
- [+] Module text files standardization
- [\*] Changed short tags <? to regular <?php
v2.0.0
from 15.05.2023
- [\*] Licensing
Legend:
[+] Added | [-] Removed | [\*] Changed | [!] Bug fix
Ваш запрос отправлен!
Ваш запрос на доработку модуля отправлен в техническую поддержку. Мы изучим ваши пожелания и дадим обратную свзязь.
Вам придет уведомление на указанный Email.