YandexMapsLocator

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

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

Free и Pro

	Free	Pro
Карта, список, поиск, геолокация	да	да
Категории, return=chunks/data/json	да	да
search.php (AJAX на том же сайте)	да	fallback, если REST выключен
Фильтр «открыто сейчас», бейджи в UI	-	да
MiniShop3: карта «где забрать товар»	-	да
CSV import/export в CMP	-	да
REST API v1, CORS, Bearer	-	да

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

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

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

Что даёт Pro

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

• фильтр working_now, бейджи «Открыто» / «Закрыто», кнопка «Только открытые»
• поля is_open_now, working_hours_schedule в чанках и API
• на карточке товара MiniShop3 только точки с этим товаром (productId + TV ms3_product_id)

В менеджере: импорт и экспорт CSV по контейнеру.

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

Разделы: Что даёт Pro.

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

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

Pro требует установленный Free (yandexmapslocator >=1.0.0 <2.0.0). Совместимость: Free 1.0.x ↔ Pro 1.0.x.

Установка

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	Типовые ошибки