Модуль Yandex Maps DLE предназначен для вывода в полной новости блока с Яндекс.Картой и точкой на ней, координаты и зум которой хранятся в дополнительном поле новости, а так же вывода, отфильтрованного по параметрам, JSON-массива с информацией о координатах точек с привязкой этих точек к соответсвующим новостям, для последующего размещения на Яндекс.Карте.
Версия DLE: 13.X и выше
Поддерживаемая кодировка: UTF-8
Версия php: 5.4 и выше
Все настройки описаны для шаблона Default. Не забывайте при копировании кода заменить название шаблона на свой.
Вывести карту при добавлении новости можно двумя способами:
Для вывода визуального добавления метки на карту в форму добавления новости с сайта в модальном окне необходимо:
btn-addmap у кнопки, иначе она будет скрываться при изменении категории.Для вывода визуального добавления метки на карту в форму добавления новости с сайта непосредственно в форме необходимо:
Для вывода визуального редактирования метки при быстром редактировании новости с сайта необходимо:
Таким образом иметь возможность визуального редактирования метки будут только пользователеи групп 1, 2 и 3. Вы можете изменить эти цифры на своё усмотрение.
где: id={news-id} — id новости, из которой необходимо вывести карту. Этот параметр является обязательным.
Так же у модуля есть дополнительные параметры подключения:
| Переменная | Значение по умолчанию и пример использования | Описание |
|---|---|---|
| template | ymaps/default &template=ymaps/simple | Имя (путь относительно текущего шаблона сайта) шаблона вывода без расширения. В комплекте с модулем поставляется два шаблона вывода карты:
|
| fields | false &fields=title,short_story | Поля, добавляемые в запрос на вывод контента из новости. Для вывода дополнительных данных необходимо прописать нужные поля через запятую. Допустимые к использованию поля:
|
Так как вариантов вывода меток может быть очень много, было решено сделать универсальный вывод — в виде json-массива. А так же предоставить возможность безопасного управления фильтрацией выводимых новостей.
Внимание! Данные для показа балуне метки при выводе всех меток необходимо формировать самостоятельно.
Так же для ускорения загрузки сайта рекомендуется вызывать все метки через AJAX (пример вывода смотрите ниже).
Для вывода всех меток на карту предназначен отдельный мини-модуль, управление параметрами которого осуществляется через шаблон заданного синтаксиса.
Пример шаблона для вывода всех меток находится в файле ymaps/all_placemarks.tpl
Особенностью работы мини-модуля является то, что параметры вызова (аналог строки подключения) передаются в него не напрямую, а через шаблон. Это обеспечивает безопасность передаваемых данных и уменьшает нагрузку на хостинг. При этом необходимо соблюдать следующий синтаксис:
| Параметр | Значение по умолчанию и пример использования | Описание |
|---|---|---|
| startFrom | 0 startFrom = 15 | С какой новости начинать отбор. |
| limit | 1000 limit = 150 | Максимальное количество выводимых точек. |
| postId | false postId = 1,2,3-50 | ID конкретных новостей (можно использовать диапазоны или this, тогда будет выводиться просматриваемая новость) |
| notPostId | false notPostId = 0 | ID исключаемых новостей (можно использовать диапазоны или this, тогда просматриваемая новость будет игнорироваться) |
| catId | false catId = 1-5,15,45 | ID категорий для вывода (можно использовать диапазоны или this, тогда будет выводиться просматриваемая категория) |
| subcats | false subcats = yes | Обрабатывать подкатегории выводимых категорий. Если определить переменную, то в вывод будут включены и подкатегории указанных категорий. |
| notCatId | false notCatId = 1-8 | ID исключаемых категорий (можно использовать диапазоны или this, тогда просматриваемая категория будет игнорироваться) |
| notSubcats | false notSubcats = yes | Обрабатывать подкатегории исключаемых категорий. Если определить переменную, то из вывода будут исключены и подкатегории игнорируемых категорий. |
| type | json type = json | Тип возвращаемых данных. Пока только json т.к. это наиболее правильный вариант |
| Название тега | Описание |
|---|---|
| {id} | Выводит ID новости. |
| {key} | Выводит ключ, полученный от яндекса (актуально только для коммерческих лицензий Яндекс.карт). |
| {scripts} | Выводит все необходимые скрипты для отображения карты в модальном окне. |
| {script_yandex} | Выводит скрипт библиотеки яндкс.карт. |
| {script_popup} | Выводит скрипт попап окна. В модуле используется jQuery.MagnificPopup. |
| {script_module} | Выводит скрипт ymaps_public.js из папки шаблона модуля. |
| {lon} и {lat} | Выводят координаты точки на карте. |
| {zoom} | Выводит значение зума карты. |
| {controls} | Выводит информацию об элементах управления картой. |
| {baloon} | Устаревший тег. В версиях до 1.4 выводил содержимое балуна метки. |
| {placemarkStyle} | Данные о стилизации метки. |
| {mapHeight} | Высота карты из настроек модуля. |
| {title}, {title limit="x"} | Заголовок новости. limit="x" — урезанный до x символов, заголовок новости. Выведется только по требованию (если в строке подключения указать &fields=title). |
| {short_story}, {short_story limit="x"} | Краткое содержание новости. limit="x" — урезанное до x символов, краткое содержание новости без HTML форматирования и картинок. Выведется только по требованию (если в строке подключения указать &fields=short_story). |
| {full_story}, {full_story limit="x"} | Полное содержание новости. limit="x" — урезанное до x символов, полное содержание новости без HTML форматирования и картинок. Выведется только по требованию (если в строке подключения указать &fields=full_story). |
| [xfvalue_x] [xfvalue_x limit="y"] | Значение дополнительного поля x. limit="y" — урезанное до y символов, значение дополнительного поля x. |
| [xfgiven_x]текст[/xfgiven_x] | Выводится текст, если допполе x не пустое |
| [xfnotgiven_x]текст[/xfnotgiven_x] | Выводится текст, если допполе x пустое |
| {image-x} | URL картинки x из краткой новости. |
| [image-x]текст[/image-x] | Выводится текст, если картинка x присутствует в краткой новости. |
| [not-image-x]текст[/not-image-x] | Выводится текст, если картинка x отсутствует в краткой новости. |
| {fullimage-x} | URL картинки x из полной новости. |
| [fullimage-x]текст[/fullimage-x] | Выводится текст, если картинка x присутствует в полной новости. |
| [not-fullimage-x]текст[/not-fullimage-x] | Выводится текст, если картинка x отсутствует в полной новости. |
Если требуется добавление новых тегов — жду ваших предложений по координатам, указанным в контактной информации к модулю при покупке.
