YandexMapsLocator

Локатор точек сети на Яндекс.Картах для MODX Revolution 3. Точка: опубликованный ресурс с TV (адрес, координаты, телефон, часы работы). На сайте: список, карта, поиск по адресу, геолокация и сортировка по расстоянию.

Free: ядро локатора. Pro ставится поверх Free: тот же интерфейс, плюс CSV в менеджере и REST. Свой сниппет и чанки Pro не дублирует.

Free и Pro

	Free	Pro
Карта, список, поиск, геолокация	да	да
Категории, return=chunks/data/json	да	да
search.php (запрос с той же страницы)	да	запасной вариант, если REST выключен или задан api_token
Фильтр «открыто сейчас», бейджи, пояс на точке	-	да
Фильтры amenity / brand	-	да
MiniShop3: карта «где забрать товар»	-	да
CSV, массовый геокод в менеджере	-	да
REST API v1 (locations, geocode, meta)	-	да

Подробнее: Free и Pro.

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

• Точки как ресурсы MODX, TV ставятся при установке
• Сниппет YandexMapsLocator: список, карта, форма поиска
• Геолокация («Моё местоположение» / «Все точки»), маршрут
• Кластеризация маркеров, свои иконки и картинка в балуне
• Фильтр по категории, сортировка по distance
• Режимы return: HTML, плейсхолдеры, JSON
• Кнопка «Получить координаты» в форме ресурса
• Extension API для сторонних extras и для Pro
• Несколько контекстов: параметр context, белый список в настройках

Что даёт Pro

На том же локаторе:

• фильтр working_now, бейджи «Открыто» / «Закрыто», кнопка «Только открытые»
• поля is_open_now, status_hint, closes_at, next_open_at на витрине и в search.php. working_hours_schedule только в REST
• часовой пояс на точке (yandexmaps_timezone) или сеть yandexmapslocator_timezone
• фильтры amenity / brand
• на карточке товара MiniShop3 только точки с этим товаром (productId + ms3_product_ids / ms3_product_id)

В менеджере: CSV, массовый геокод, превью расписания.

Для Nuxt, Next и других клиентов: REST v1 (locations, geocode, meta) с CORS и Bearer.

Системные требования

Требование	Версия
MODX Revolution	3.0+
PHP	8.2+
MySQL / MariaDB	как у MODX
pdoTools	chunks на Fenom
API-ключ Яндекс.Карт	JS API и HTTP Геокодер

Pro 1.1.0-pl2 требует Free ≥ 1.0.0-pl7 (yandexmapslocator >=1.0.0-pl7 <2.0.0). Матрица: Free и Pro.

Локатор берёт pdoTools по порядку: сервис ModxPro\PdoTools\CoreTools, сервис pdoTools, затем $modx->getService('pdoTools'). Берётся любой объект с методом getChunk(). Если не нашлось ни одного, в лог один раз падает предупреждение [YandexMapsLocator] Fenom chunks require pdoTools, и чанки рендерятся через $modx->getChunk() без Fenom.

Установка

Free

1. Подключите репозиторий ModStore.
2. Extras → Installer → YandexMapsLocator → Download → Install.
3. Укажите yandexmapslocator_api_key.
4. Создайте контейнер и дочерние ресурсы-точки, заполните TV.
5. Вставьте сниппет: Быстрый старт.

Пакет: modstore.pro.

Pro

1. Установите Free.
2. Установите YandexMapsLocatorPro.
3. Задайте yandexmapslocator_timezone под сеть (для «открыто сейчас»).
4. При необходимости: api_token, CORS, CSV в Компоненты → YandexMapsLocator Pro.

Пакет Pro: modstore.pro.

Быстрые ссылки

Раздел	Описание
Быстрый старт	Ключ, точки, сниппет
Free и Pro	Матрица возможностей
Сниппет	Параметры и примеры
Pro	REST, CSV, MiniShop3, «открыто сейчас»
FAQ	Типовые ошибки