YandexMapsLocator

Store network locator on Yandex Maps for MODX Revolution 3. A location is a published resource with TVs: address, coordinates, phone, working hours. On the site you get a list, map, address search, geolocation, and distance sorting.

Two packages, one docs set. Free is the locator core. Pro installs on top of Free and extends the same UI, plus CSV in the manager and REST. Pro does not duplicate the snippet or chunks.

Free and Pro

	Free	Pro
Map, list, search, geolocation	yes	yes
Categories, return=chunks/data/json	yes	yes
search.php (same-site AJAX)	yes	fallback when REST is off or api_token is set
"Open now" filter, badges, TZ per location	-	yes
amenity / brand filters	-	yes
MiniShop3: "pick up product here" map	-	yes
CSV, bulk geocode in CMP	-	yes
REST API v1 (locations, geocode, meta)	-	yes

Details: Free and Pro.

Free features

• Locations as MODX resources, TVs created on install
• YandexMapsLocator snippet: list, map, search form
• Geolocation ("My location" / "All locations"), route link
• Marker clustering, custom icons and balloon image
• Category filter, sort by distance
• return modes: HTML, placeholders, JSON
• "Get coordinates" button on the resource form
• Extension API for third-party extras and Pro
• Multi-context: context parameter, allowlist in settings

What Pro adds

On the same locator:

• working_now filter, "Open" / "Closed" badges, "Open only" button
• fields is_open_now, status_hint, closes_at, next_open_at on the storefront and in search.php. working_hours_schedule is REST-only
• timezone per location (yandexmaps_timezone) or network yandexmapslocator_timezone
• amenity / brand filters
• on a MiniShop3 product page only locations with that product (productId + ms3_product_ids / ms3_product_id)

In the manager: CSV, bulk geocode, schedule preview.

For Nuxt, Next, and other clients: REST v1 (locations, geocode, meta) with CORS and Bearer.

Sections: What Pro adds.

Requirements

Requirement	Version
MODX Revolution	3.0+
PHP	8.2+
MySQL / MariaDB	same as MODX
pdoTools	Fenom chunks
Yandex Maps API key	JS API and HTTP Geocoder

Pro 1.1.0-pl2 requires Free ≥ 1.0.0-pl7 (yandexmapslocator >=1.0.0-pl7 <2.0.0). Matrix: Free and Pro.

Installation

Free

1. Connect the ModStore repository.
2. Extras → Installer → YandexMapsLocator → Download → Install.
3. Set yandexmapslocator_api_key.
4. Create a container and child location resources, fill TVs.
5. Insert the snippet: Quick start.

Package: modstore.pro.

Pro

1. Install Free.
2. Install YandexMapsLocatorPro.
3. Set yandexmapslocator_timezone for the network (for "open now").
4. If needed: api_token, CORS, CSV in Components → YandexMapsLocator Pro.

Pro package: modstore.pro.

Quick links

Section	Description
Quick start	Key, locations, snippet
Free and Pro	Feature matrix
Snippet	Parameters and examples
Pro	REST, CSV, MiniShop3, open now
FAQ	Common errors