Skip to content
YandexMapsLocator
YandexMapsLocator
Локатор точек на Яндекс.Картах для MODX 3. Free: карта и поиск. Pro: «открыто сейчас», MiniShop3, CSV и REST
  • MODX 3
  • PHP 8.2
  1. Компоненты
  2. YandexMapsLocator
  3. Pro

Что даёт Pro ​

YandexMapsLocatorPro: платный пакет поверх Free. Свой сниппет и чанки он не кладёт: на сайте вы по-прежнему вызываете YandexMapsLocator. Pro добавляет фильтры, pro.js, страницу в менеджере и REST через Extension API Free.

Матрица: Free и Pro.

Возможности ​

ФункцияГдеРаздел
Фильтр working_now, бейджи, пояс на точкесайтОткрыто сейчас
Фильтры amenity, brandсайт / RESTFree и Pro
Карта на карточке товара MiniShop3сайтMiniShop3
CSV, массовый геокод, превью расписанияменеджерCSV в менеджере
REST API v1 (locations, geocode, meta)HTTPREST API
CORS, Bearer, лимит запросов, выключательHTTPБезопасность API

Как устроено ​

text
Free: сервис yandexmapslocator, сниппет, search.php, chunks, Extension API
  └── Pro: сервис yandexmapslocatorpro, api.php, менеджер, фильтры, pro.js

Плагин Pro слушает:

  • OnYandexMapsLocatorRegisterFeatureProviders
  • OnYandexMapsLocatorRegisterFilters
  • OnYandexMapsLocatorBeforeStorePrepare
  • OnYandexMapsLocatorAfterStorePrepare
  • OnYandexMapsLocatorSerializeLocation
  • OnDocFormRender

REST v1 включается самим фактом установки Pro: эндпоинт лежит в assets/components/yandexmapslocatorpro/api.php и capability не проверяет. Capability pro это сигнал, который читает Free: по нему локатор на странице переключается с search.php на REST и разрешается product_id. Модуль /assets/components/yandexmapslocatorpro/js/pro.js рисует бейджи и кнопку «Только открытые».

Установка ​

  1. Free уже стоит и отвечает на сайте (рекомендуется ≥ 1.0.0-pl7).
  2. Поставьте Pro через ModStore (1.1.0-pl2).
  3. Задайте yandexmapslocator_timezone под сеть и при необходимости TV yandexmaps_timezone на точках.
  4. На рабочем сайте: api_token (серверные клиенты) и api_cors_origins. Локатор на сайте при заданном токене остаётся на search.php.

Зависимость: yandexmapslocator >=1.0.0-pl7 <2.0.0.