MS: Геолокация от SypexGeo
Описание
Модуль ms_geolocation работает на основе независимого сервиса SypexGeo. Модуль заменяет стандартную геолокацию CS-Cart и работает точнее аналогов от Яндекса и Google. Модуль определяет город покупателя по IP-адресу и позволяет выбирать город вручную.
Основные возможности
- Определение города по IP: Автоматическое определение города покупателя по IP-адресу через SypexGeo
- Выбор города: Возможность выбора города покупателем вручную
- Интеграция с модулями городов: Работа с модулями
citiesилиrus_citiesдля управления городами - Блоки геолокации: Готовые блоки для отображения выбора города и информации о городе
- Всплывающее окно: Настраиваемое всплывающее окно для выбора города
- Дополнительная информация о городе: Возможность добавления дополнительной информации о городе (фраза, ссылка)
Как работает модуль
Модуль использует следующие механизмы:
- База данных (
upgrades/migrations/): При установке модуль выполняет миграции для создания необходимых структур данных
- Функции работы с городами (
func.php):
fn_ms_geolocation_get_cities_tables()- определяет используемые таблицы городов в зависимости от установленных модулей:- Если активен модуль
cities, использует таблицыcitiesиcity_descriptions - Если активен модуль
rus_cities, использует таблицыrus_citiesиrus_city_descriptions fn_ms_geolocation_geo_get_cities_list()- получает список городов с учетом настроек модуляfn_ms_geolocation_check_tables_exist()- проверяет существование таблиц городов
- API SypexGeo (
hooks.php):
- Интеграция с API SypexGeo для определения города по IP
- Использование API ключа для доступа к сервису
- Контроллеры:
controllers/frontend/geo_cities.php- обработка выбора города на витринеcontrollers/backend/cities.post.php- управление городами в административной панелиcontrollers/backend/ms_geolocation.php- настройки модуля
- Блоки (
schemas/block_manager/blocks.post.php):
- Регистрирует блоки:
cities- блок выбора городаcity_phrase- блок информации о городе
- Хуки (
hooks.php):
- Обработка определения города при загрузке страницы
- Сохранение выбранного города в сессии
Где находится функциональность
- Административная панель:
- Настройки модуля с API ключом SypexGeo
- Управление городами (если модуль
citiesилиrus_citiesустановлен) - Витрина:
- Блоки выбора города и информации о городе
- Всплывающее окно для выбора города (если не скрыто)
- Автоматическое определение города при первом посещении
Настройки модуля
- Ключ API (
apikey): API ключ для доступа к сервису SypexGeo - Количество запросов (
count_requests): Количество запросов для определения города (по умолчанию 3) - Скрыть всплывающее окно (
hide_popup): Скрыть всплывающее окно выбора города - Статус токена (
token_status): Отображение статуса API ключа
Использование
- Получение API ключа:
- Зарегистрируйтесь на сайте SypexGeo
- Получите API ключ для использования сервиса
- Настройка модуля:
- Укажите API ключ в настройках модуля
- Настройте количество запросов (если необходимо)
- Выберите, показывать ли всплывающее окно выбора города
- Добавление блоков:
- Добавьте блок "MS: Местоположение покупателя" для выбора города
- Добавьте блок "MS: Информация о городе" для отображения информации о городе
Технические детали
- Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
- При установке выполняет миграции для создания необходимых структур данных
- Работает с модулями
citiesилиrus_citiesдля управления городами - Использует API SypexGeo для определения города по IP-адресу
- Сохраняет выбранный город в сессии (
$_SESSION['selected_city_id'])
- 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 магазина для которого выписана подписка

Инструкция
Установка
После скачивания модуля, его установка производится штатными средствами CS-Cart, на странице Панель администратора → Модули → Скачанные модули → Кнопка Шестеренка → Ручная установка (Для версии CS-Cart более 4.18.1)
Нажимаем Загрузить, в появившемся окне выбираем файл модуля, далее Загрузить и установить.
Предварительные действия
- Перейдите на https://sypexgeo.net и зарегистрируйтесь.

- После регистрации вы получите 30 000 бесплатных запросов, которые обновляются ежемесячно. При необходимости можно докупить запросы.
- В личном кабинете получите API-ключ. Здесь же можно отслеживать оставшиеся запросы и приобретать дополнительные.
⚠️ При покупке дополнительных запросов необходимо выбирать пункт REST API.

Настройка
-
После установки, переходим в его настройки. Для этого выполняем следующие действия: Панель администратора → Модули → Скачанные модули → Геолокация от SypexGeo → Настройки и активируем необходимые параметры:

-
Ключ API:
Введите в поле полученный ранее API-ключ, чтобы активировать работу модуля.
-
Скрыть всплывающее окно:
Установите галочку, чтобы скрыть всплывающее окно подтверждения выбора конкретного города в блоке “MS: Местоположение покупателя”

-
-
Для отображения работы модуля на витрине, необходимо перейти в Панель администратора → Веб-сайт → Темы → Макеты.
-
Выбрать необходимое место на сайте и добавить один из следующих блоков:
- MS: Местоположение покупателя – отображает город покупателя, а также список для выбора.
- MS: Информация о городе – выводит дополнительный текст и ссылку выбранного города.
**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.