Yandex Maps DLE 3.0.0 : Яндекс карты

Модуль предназначен для вывода в полной новости блока с Яндекс.Картой и точкой на ней, координаты и зум которой хранятся в дополнительном поле новости, а так же вывода, отфильтрованного по параметрам, JSON-массива с информацией о координатах точек с привязкой этих точек к соответствующим новостям, для последующего размещения на Яндекс.Карте.


Ключевые особенности:

• Лёгкая настройка модуля. Редактирование настроек модуля сделано максимально удобно и дружелюбно для пользователя. Всё, что можно было визуализировать - визуализировано.
  
• Гибкий вывод данных на карту. На карту можно выводить доп.поля, заголовок, категорию, краткую и полную новости. Поддерживаются конструкции с получением картинок из новости и обрезкой текста.
  
• Визуальное добавление и редактирование меток с сайта и из админки. Метки в новостях удобно редактируются простым перетаскиванием на карте. Добавление и редактирование меток работает как на сайте, так и в админ.панели. Для возможности редактирования в админ.панели необходимы минимальные правки файлов движка (вставка одной строки кода).
  
• Вывод всех меток на одну карту. В модуле реализована возможность гибкого вывода всех меток в виде JSON-массива, который удобно использовать самостоятельно. Получение массива с метками реализовано на AJAX.

Важно: все настройки описаны для шаблона Default. Не забывайте при копировании кода заменить название шаблона на свой.

Вывести карту при добавлении новости можно двумя способами:

1. В модальном окне - для вывода визуального добавления метки на карту в форму добавления новости с сайта в модальном окне необходимо открыть templates/Default/main.tpl и дописать рядом с выводом подключения CSS файлов строку:
   

   <link href="{THEME}/ymaps/ymaps.css?v=3.0.0" rel="stylesheet">

   
   Этот файл отвечает за стилизацию кнопки показа модального окна с картой и самого модального окна.
   
   Далее открыть templates/Default/addnews.tpl и в самом начале добавить:
   

   {include file="engine/modules/ymaps/addnews.php"}

   
   В нужном месте вставить:
   

   <a href="#" class="btn btn-addmap" data-mfp-src="#addMap">Добавить метку на карту</a>

   
   Если использование карты разрешено во всех категориях - необходимо удалить класс btn-addmap у кнопки, иначе она будет скрываться при изменении категории.
   
   
2. Непосредственно в форме добавления новости - для вывода визуального добавления метки на карту в форму добавления новости с сайта, непосредственно в форме необходимо открыть templates/Default/addnews.tpl и в самом начале добавить:
   

   {include file="engine/modules/ymaps/addnews-inline.php"}

Быстрое редактирование с сайта: для вывода визуального редактирования метки, при быстром редактировании новости с сайта, необходимо открыть templates/Default/main.tpl и дописать рядом с выводом подключения JS файлов строку:

[group=1,2,3]<script src="/engine/modules/ymaps/js/ymaps_editnews.js?v=3.0.0"></script>[/group]

Таким образом иметь возможность визуального редактирования метки будут только пользователей групп 1, 2 и 3. Эти цифры можно изменить на своё усмотрение.

Вывод карты в полной новости: для вывода карты в полной новости необходимо в нужном месте шаблона прописать строку подключения модуля, отвечающего за вывод карты:

{include file="engine/modules/ymaps/detail.php?id={news-id}"}

id={news-id} — id новости, из которой необходимо вывести карту (этот параметр является обязательным).

Так же у модуля есть дополнительные параметры подключения:


Вывод всех меток на карту: так как вариантов вывода меток может быть очень много, было решено сделать универсальный вывод — в виде json-массива. А так же предоставить возможность безопасного управления фильтрацией выводимых новостей.

Важно: данные для показа балун-метки при выводе всех меток необходимо формировать самостоятельно. Так же для ускорения загрузки сайта рекомендуется вызывать все метки через AJAX.

Для вывода всех меток на карту предназначен отдельный мини-модуль, управление параметрами которого осуществляется через шаблон заданного синтаксиса.

Пример шаблона для вывода всех меток находится в файле ymaps/all_placemarks.tpl

Особенностью работы мини-модуля является то, что параметры вызова (аналог строки подключения) передаются в него не напрямую, а через шаблон. Это обеспечивает безопасность передаваемых данных и уменьшает нагрузку на хостинг. При этом необходимо соблюдать следующий синтаксис:
1. Параметры необходимо писать по одному в строке.
2. Имя параметра и его значение необходимо разделять знаком равенства.

Параметры, используемые для фильтрации вывода всех меток:


Теги шаблона вывода карты в полной новости:


• Версия DLE: 13.х-14.х
• Кодировка: utf-8
• Версия PHP: 5.4 и выше
• Автор: ПафНутиЙ
• Источник