Модуль выводит материалы Joomla метками на Яндекс Картах. Координаты берутся из настраиваемого поля, макеты меток и всплывающих окон задаются для категории или материала. API Яндекс Карт 3.0.
WT Yandex map items показывает материалы Joomla как метки на Яндекс Картах: офисы, магазины, объекты, мероприятия — всё, что уже ведётся материалами сайта. Координаты хранятся в настраиваемом поле материала, поэтому контент-менеджер добавляет точку на карту так же, как заполняет обычную статью. Модуль написан по структуре Joomla 4+ и с версии 2.0.0 работает на API Яндекс Карт 3.0.
Возможности
- Вывод меток из источников данных; пока источник один — материалы Joomla.
- Координаты — в настраиваемом поле типа text (через запятую) или в поле плагина Fields - WT Yandex map.
- Стандартные макеты меток и всплывающих окон API Яндекс Карт 3.0 или собственные макеты.
- Изображение или HTML-макет в качестве маркера метки.
- Свой макет для всей категории — в настраиваемом поле категории, и для отдельного материала — в поле материала. Параметры материала имеют приоритет над параметрами категории. Работает и для метки, и для содержимого всплывающего окна.
- Выбор макета из списка с помощью плагина поля WT Layout Select — без ручного ввода путей.
- Переопределение макетов в папке шаблона Joomla.
- Макеты меток и всплывающих окон загружаются в тело страницы как JavaScript-литералы.
- Собственный стиль карты для типа «Схема» из редактора стилей Яндекс Карт.
- Оптимизация под большое число меток: на одной карте можно вывести несколько тысяч меток.
Макеты меток и всплывающих окон
Путь к макету указывается относительно папки layouts, с точкой вместо слэша, например modules.mod_wtyandexmapitems.marker.city-marker. Так работает штатный механизм переопределений Joomla: макет можно переопределить в своём шаблоне по пути templates/[ШАБЛОН]/html/layouts/mod_wtyandexmapitems/marker/city-marker.php. Для указания макета метки или всплывающего окна подходит поле типа text или list (список, радиокнопки, чекбоксы).
Установка и настройка
- Установить пакет через менеджер расширений Joomla.
- Получить ключ API в кабинете разработчика Яндекса; при необходимости указать в параметрах ключа домен сайта.
- Создать настраиваемое поле для координат: типа text (координаты через запятую) или типа WT Yandex map.
- Заполнить координаты в материалах.
- В настройках модуля указать API-ключ Яндекс Карт и тип API (бесплатный или платный), выбрать источник данных и поле координат, при необходимости — категорию, тег и количество материалов.
Собственный стиль карты подключается так:
- Создать стиль в редакторе стилей Яндекс Карт и экспортировать его в JSON-файл.
- Положить файл на сайт, например в
/media/mod_wtyandexmapitems/map-style.json. - Указать этот файл в параметре модуля «Путь к JSON-файлу стиля карты». Модуль передаёт содержимое файла в
YMapDefaultSchemeLayer.customization.
Совместимость и требования
- Joomla 4 (с 4.2) и Joomla 5.
- Ключ API Яндекс Карт.
- Версия 1.0.0 использовала устаревший API 2.1; для перехода с неё в документации есть отдельная инструкция по обновлению.
