[YandexMaps2] 1.1.2 Полноценная работа с mFilter2 и кастомизация плагинами

- Добавлен новый метод работы с mFilter2, поддерживающий вывод результатов в текстовом виде
- Добавлено событие плагина ymOnLoadObjects с параметрами: array $data, array $objects, array $snippetProperties
- Добавлен параметр objectsInScope в сниппет YandexMaps2
- Добавлена системная настройка ym2_objects_in_scope для бек-энда
- Добавлены параметры defaultIconContent, defaultIconCaption и defaultBalloonContent в сниппет YandexMaps2
- Добавлен параметр scrollZoom в сниппет YandexMaps2
- Добавлен перехват ошибки из-за некорректного JSON в default.js
- Поправлено большинство конфликтов, возникающих из-за повторной загрузки jQuery

Сниппет YandexMaps2

Основной и единственный сниппет компонента получил 5 новых параметров.

objectsInScope

Эту функцию многие знают с первой версии, там она называлась checkZoomRange. Если параметр активирован, то все объекты карты попадут в область видимости, независимо от установленных center и zoom. Особенно это удобно при использовании mFilter2, ибо при фильтрации совершенно нормально, когда все результаты поиска отображаются в поле зрения.
Кстати, для бек-энда тоже добавлена такая системная настройка ym2_objects_in_scope.

scrollZoom

Зуммирование при скролле. Отключив эту функцию карта перестанет зумировать при скроллинге мышкой. Некоторые люди приходят в бешенство, когда эта функция активирована. Именно поэтому он по-умолчанию включён. Пришлось оставить его включённым по-умолчанию, чтобы не нарушать работу компонента после обновления.

defaultIconContent
defaultIconCaption
defaultBalloonContent

Эти параметры будут использованы, если у объекта на карте они не указаны.

Более подробнее можно почитать в документации компонента, в разделе Сниппеты.

Взаимодействие с mFilter2

Компонент научился выводить результаты и на карте, и давать mFilter выводить их в текстовом виде. Настраивается это немного иначе, чем раньше, поэтому предлагаю всем перейти на новый способ взаимодействия, не смотря на то, что поддержка старого метода осталась.

События для плагинов

У компонента появились события плагина. Пока одно, но в будущем их станет больше!

ymOnLoadObjects

С помощью этого события мне уже удавалось:
— добавлять точкам на карте свои иконки,
— выводить на фронт-энде объекты на карте, добавленные через MIGX.
Простора для действий, на самом деле, гораздо больше. При желании, можно полностью изменить список объектов на карте! Планирую сделать пару кейсов работы с этим плагином.

Ошибки и конфликты

И последнее, но не менее важное!
Мне удалось выявить проблему работы в бек-энде с некоторыми компонентами. Между YandexMaps2 и компонентами, которые используют jQuery, происходил конфликт.
Ну и на фронт-энде, при выдаче mFilter2 сообщения о том, что результатов для вывод нет, компонент пытался распарсить эту строку, как JSON, от этого происходила ошибка.
Выявил и устранил!

[[!YandexMaps2?
                    &defaultIconContent=`test`
                    &defaultBalloonContent=`test2`
                    &objects=`[{
                        type: 'placemark',
                         geometry: {
                             coordinates:[[!ymaps_center? &x=`[[*os_latitude]]` &y=`[[*os_longitude]]`]]
                         }
                    }]`
                    &class=`msProduct`
                    &objectsInScope=`true`
                    &center=`[[!ymaps_center? &x=`[[*os_latitude]]` &y=`[[*os_longitude]]`]]`
                ]]