YandexMapsLocator
Store locator on Yandex Maps for MODX 3. Free: map and search. Pro: open now, MiniShop3, CSV, and REST
- MODX 3
- PHP 8.2
Locations and TVs
A map location is a published MODX resource. The container is set with snippet parameter parents.
Free TVs
On install the YandexMapsLocator category and TVs are created:
| TV | Type | Purpose |
|---|---|---|
yandexmaps_address | text | Address |
yandexmaps_latitude | text | Latitude |
yandexmaps_longitude | text | Longitude |
yandexmaps_phone | text | Phone |
yandexmaps_email | text | |
yandexmaps_working_hours | textarea | Working hours (text or JSON for Pro) |
yandexmaps_category | text | Category |
yandexmaps_balloon_image | image | Balloon image |
yandexmaps_marker_icon | image | Map marker icon |
Rename via yandexmapslocator_tv_*: settings.
Pro TVs
Pro resolver creates (if missing):
| TV | Type | Purpose |
|---|---|---|
yandexmaps_timezone | text | IANA timezone for the location (Europe/Moscow, Asia/Omsk). Empty → network yandexmapslocator_timezone |
ms3_product_id | number | Single MiniShop3 product ID (legacy) |
ms3_product_ids | text | Multiple IDs: 25,26 or JSON [25,26]. When set, wins over ms3_product_id |
yandexmaps_amenities | text | Comma-separated amenity tags (wifi,card,parking) |
yandexmaps_brand | text | Brand for brand filter |
TVs are not bound to templates automatically. Assign them to the location template like other locator TVs.
Geocode in the manager
Free plugin on OnDocFormRender adds "Get coordinates" under the address field: reads the address TV and fills coordinates. Requires yandexmapslocator_api_key.
Pro adds "Check schedule" under working hours TV: JSON via formatter, open-now status, next open/close.
Free chunks
| Chunk | Purpose |
|---|---|
yandexmapslocator.outer | Locator wrapper |
yandexmapslocator.search | Search form |
yandexmapslocator.store | Location card |
yandexmapslocator.empty | Empty result |
yandexmapslocator.error | Error |
Pro ships no chunks. UI and data-yml-*: Frontend.
Working hours
Plain text in yandexmaps_working_hours shows in the card.
For "open now" and Pro badges you need JSON and the correct timezone (location TV or yandexmapslocator_timezone). Otherwise the location is closed for working_now. Details: Open now.