Zh YandexMap Description/ru

From Documentation
Jump to: navigation, search

Установка

Компонент устанавливается на Joomla! 2.5 (1.7, 1.6) стандартным способом установки через Extension Manager


Компонент поддерживает функцию автообновления

Настройка

Переходим на компонент

Нажимаем (меню):

  • Components
  • Zh YandexMap


YM-Map-Option-Position.JPG


Нажимаем кнопку "Options".

YM-Map-Option.JPG


Вводим полученный ранее в Яндексе ключ для сервиса.

При создании новых картографических объектов при открытии карты автоматически вычисляется местоположение, если вычислить не удается, то выводится центр Дворцовой площади Санкт-Петербурга (если не установлены значения по умолчанию Default Latitude и Default Longitude)


Режим совместимости

В некоторых случаях, когда для карты разрешено Управление метками через список групп, Вы можете получить сообщение об ошибке
link.hasClass is not a function

Это может быть связано с конфликтом JQuery и mootools в некоторых шаблонах
В этом случае Вы можете установить режим совместимости, при котором вызовы методов hasClass и toggleClass изменяются на вызовы JavaScript функций, реализующих похожую логику.


Режим совместимости для файлов ресурсов

В некоторых случаях вы ограничиваете доступ к папке administrator folder. В этой папке для компонента по умолчанию есть папка assets, которая содержит иконки, css-файлы для компонента и плагина.

Если вы блокируете доступ к ней, то при попытке пользователей увидеть карту будет выведено окно логина.

И вот для этого случая в компоненте предусмотрена опция Compatible Mode for Resource Files.

Просто установите значение в ДА, и все ссылки в документе, который содержит карту (вызванную как через компонент, так и через плагин), будут на папку site assets. Не перемещайте файлы и папки, просто используйте их.

Если вы хотите использовать свои иконки для меток, вам следует их скопировать в обе папки. В папке administrator иконки будут использоваться в backend (административная панель), для отображения - из папки site.


Создание карт

Переходим на закладку "Maps"

YM-Map-List.JPG

Вводим необходимое количество карт с нужной нам конфигурацией. Координаты удобно выбирать путем перетаскивания метки (значения автоматически подставляются в поля формы) или кликая мышкой на необходимом месте.

YM-Map-Detail.JPG


Свойства карты

YM-Map-Detail-MapDetails.JPG

Title Наименование карты
Description Примечание
Show Title Вывести наименование карты как всплывающее окно или метку
  • No - Метка не создается
  • Balloon - Как всплывающее окно
  • Placemark - Как метка с возможностью открытия всплывающего окна
  • Icon with Text - Как иконка с текстом
Width Ширина карты

если ввести ширину, равную нулю, то карта откроется на всю доступную ширину области

Height Высота карты
Latitude Широта центра карты
Longitude Долгота центра карты
Zoom Масштаб
  • Max available - максимально возможный для выбранного типа карты
Min Zoom Минимальный масштаб карты
Max Zoom Максимальный масштаб карты
  • Unlimited - Масштаб не ограничен (это связано с тем, что на определенных типах карт масштаб может отличаться от максимально описанного)
Map Type Тип карты
YMapsML-document
KML-document
GPX-document
Object Manager for Placemarks Выводить маркеры только при определенном масштабе, диапазон которого указывается у группы

маркеров. Иными словами, Вы указываете на маркере к какой группе он принадлежит. Соответственно, на экране ввода/корректировки группы маркеров указывается минимальный и максимальный масштаб. Данная функциональность работает только если не используется управление маркерами через список групп (поле Placemark Control = No см. ниже в разделе Placemark Groups)

Category Категория

Оформление карты

YM-Map-Detail-MapDecoration.JPG

Header HTML-text HTML-text над картой
Show Header Separator Отображать верхний разделитель
Show Footer Separator Отображать нижний разделитель
Footer HTML-text HTML-text под картой


Доступные элементы управления

YM-Map-Detail-MapControls.JPG

Map Type Control Выводить элемент управления переключением типа карты
Map Type Control for PMap Возможность переключения на Народную карту
Toolbar Выводить панель инструментов
Search Control Выводить элемент для поиска по карте
Double Click Zoom Возможность масштабирования по двойному щелчку мыши
Scroll Wheel Zoom Возможность масштабирования колёсиком мыши
Zoom Control Выводить элемент управления масштабом
Scale Control Выводить шкалу масштабирования
MiniMap Выводить обзорную карту
Traffic Control Возможность использования сервиса Яндекс.Пробки
Find Control (geocoding) Возможность поиска по введенному адресу
Find Control width Ширина поля ввода адреса для поиска
Draw route from search point to place Отобразить маршрут от найденного адреса до центра карты


Расположение элементов управления

YM-Map-Detail-ControlPositions.JPG


Управление маркерами с помощью списка групп

YM-Map-Detail-PlacemarkGroups.JPG

Placemark Control Признак возможности управления метками через список групп, дополнительно сразу же определяется местоположение списка
Placemark Group Column Width Ширина столбца таблицы списка групп(если табличное представление)
Show Placemark Group Icon Вывести иконку группы
Placemark Group CSS Внешний вид списка групп (стиль)
Group List Title Заголовок списка
Top Description Примечание, расположенное над картой
Show Top-Separator Признак вывода разделителя над картой
Show Bottom-Separator Признак вывода разделителя под картой
Bottom Description Примечание, расположенное под картой


Дополнительные параметры

Создан дополнительный раздел для настройки карты. В текущей версии этот раздел используется для задания возможности ввода меток со стороны пользователей и тонкой настройки области видимости маркеров.

YM-Map-Detail-AdvancedOptions.JPG

Placemark Filter Фильтр меток
Allow to user enter markers Ввод маркеров пользователями
New Placemark State Состояние новой метки



Автоматическое позиционирование

YM-Map-Detail-Geolocation.JPG

Auto Positioning Автоматическое позиционирование при отображении карты
Geolocation Control Отображение кнопки геопозиционирования
Geolocation Button Style Стиль кнопки геопозиционирования
  • Icon
  • Text
  • Icon and Text

Интеграция

YM-Map-Detail-Integration.JPG

Use contacts Возможность использование контактов

Вы можете разрешить использование информации из контактов, ассоциировать контакт с меткой и вывести контактную информацию во всплывающем окне.

Use users Возможность использование профиля пользователя

Вы можете разрешить использование информации из профиля пользователя, ассоциировать пользователя с меткой и вывести контактную информацию во всплывающем окне.



Смотрите также


Создание меток

Переходим на закладку "Placemarks"

YM-Placemark-List.JPG

Вводим необходимое количество меток с привязкой к конкретной карте. Координаты удобно выбирать путем перетаскивания метки (значения автоматически подставляются в поля формы) или кликая мышкой на необходимом месте.


Свойства метки

YM-Placemark-Detail-PlacemarkDetails.JPG

Title Наименование
Description Примечание
Addition HTML text Дополнительный текст в формате HTML

Будьте внимательны, если вы вводите email адрес, то другой плагин Joomla! его изменит, и в результате возникнет ошибка и карта не будет выведена. В этом случае вы можете скопировать код, который создался в результате работы плагина и вставить его в HTML текст, и в этом случае плагин его не поменяет.

Published Признак публикации, т.е. активности записи
Latitude Широта
Longitude Долгота
Map Title Наименование карты, на которой будет выводиться метка
Placemark Group Группа, к которой относится метка
Protected from user correction Запрет на изменение пользовательской метки
Category Категория


Внешний вид метки

YM-Placemark-Detail-AppearanceProperties.JPG

Icon Type Иконка
Icon X-offset Отступ иконки по X
Icon Y-offset Отступ иконки по Y

Если установить оба поля (Icon X-offset и Icon Y-offset) равными нулю, то стиль иконки формируется без указания отступов согласно значениям по умолчанию а API

Open baloon Сразу открыть всплывающее окно
Balloon Content Тип содержимого всплывающего окна
Show Icon with Text Показать метку как иконку с текстом
Action by Click Выполнить действие при нажатии на метке
  • None - ничего не выполнять
  • Open Balloon - открыть всплывающее окно
  • Open Link in new page - открыть ссылку на новой странице
  • Open Link
Zoom by Click Изменить масштаб при нажатии на метке
  • Do not change - не изменять
  • 1...17 - новое значение масштаба
URL Site URL адрес сайта
Site Name Наименование сайта, если хочется вместо URL видеть красивое название
URL Image URL адрес изображения, которое можно вывести во всплывающем окне
Start Publishing Дата начала публикации метки
Finish Publishing Дата окончания публикации метки

Интеграция

YM-Placemark-Detail-Integration.JPG

Contact Контакт, ассоциированный с меткой
Show contact Тип представления контактной информации
  • No
  • Text
  • Icon
  • No prompts
User Пользователь, ассоциированный с меткой
Show user Тип представления контактной информации
  • No
  • Text
  • Icon
  • No prompts

Дополнительные поля для пользовательской кастомизации

Если Вам дополнительно нужны поля, которые хотите заполнять через интерфейс, а затем их использовать в своих скриптах, то в разделе дополнительных полей для пользовательской кастомизации Вы можете определить в какое поле будет записываться нужная вам информация.


YM-Placemark-Detail-HiddenFields.JPG

Эти поля никак не обрабатываются, соответственно, Вы можете использовать их на свое усмотрение.

Это позволяет пользователю вводить какую-то дополнительную информацию по метке в одном месте со всей остальной информацией, и при дополнительном исправлении вывода основной информации, настроить компонент (плагин) для вывода этой (дополнительной) информации.


Для удобства Вы также можете изменить подпись этих полей в файле

/administrator/language/en-GB/en-GB.com_zhyandexmap.ini

для английского варианта административной панели, или для русского

/administrator/language/ru-RU/ru-RU.com_zhyandexmap.ini


строки

COM_ZHYANDEXMAP_MAPMARKER_DETAIL_ATTRIBUTE1_LABEL

COM_ZHYANDEXMAP_MAPMARKER_DETAIL_ATTRIBUTE2_LABEL

...

COM_ZHYANDEXMAP_MAPMARKER_DETAIL_ATTRIBUTE9_LABEL

Кастомизация меток

Скопируйте свои изображения меток (в формате PNG) в каталог

/administrator/components/com_zhyandexmap/assets/icons/

Компонент автоматически подхватит изображения при выборе типа метки.

Единственное требование – чтобы расширение файла было .png т.е. в нижнем регистре, т.к. наименования изображений хранятся в БД без расширения, и оно дописывается при выводе.


Группировка меток

Метка может входить в одну из групп, для этого на метке указываете принадлежность к группе.

Если на карте установлен признак использования группировки меток (значение поля Placemark Control отлично от No), то начинает работать дополнительная функциональность: появляется список активных групп (местоположение определяется этим же полем, причем первые четыре (left, top, right, bottom) соответствуют табличной форме представления, а два последний (Group-Map, Map-Group) – строится на div, и у Вас есть возможность делать с ними что угодно.

На карте также есть выпадающий список Placemark Group CSS – который реализует следующую функциональность:

  • первые два стиля – предопределенные, и находятся в файле в папке

/administrator/components/com_zhyandexmap/assets/css/markergroups.css

  • третий – Вы его можете переопределить в своем css-файле шаблона


при этом в этих трех случаях просто имеем три разных названия объектов, соответственно, можно изменять стили как вздумается.

Наименования следующие

для div-тега идентификатор принимает значения

  • YMapsMenu-advanced
  • YMapsMenu-simple
  • YMapsMenu-external

для ul-тега

  • zhym-menu-advanced
  • zhym-menu-simple
  • zhym-menu-external


Соответственно, стили прописываем для них.

Поле Show Placemark Group Icon на закладке "Maps" используется для отображения иконки группы в списке групп.


Создание групп меток

Переходим на закладку "Placemark Groups"

YM-Group-List.JPG

Вводим необходимое количество групп


Свойства группы

YM-Group-Detail-PlacemarkGroupDetail.JPG

Title Наименование группы
Description Примечание
Published Признак публикации, т.е. активности записи
Icon Type Иконка группы (можно использовать свои, т.к. механизм тот же)
Override Placemark Icon Признак переопределения иконки на маркере, т.е. когда маркер выводится, то его иконка может быть переопределена иконкой группы
Active in Placemark Group Признак активности группы в списке групп, т.е. маркеры будут сразу же выведены
Min Zoom for Object Manager Минимальный масштаб, при котором будут выведены маркеры этой группы при включенном на карте Object Manager.

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

Max Zoom for Object Manager Максимальный масштаб, при котором будут выведены маркеры этой группы при включенном на карте Object Manager
Category Категория

На закладке "Placemarks" Вы можете указать к какой группе принадлежит маркер. Это поле можно и не заполнять. Отображение групп и маркеров следующее

  • список групп выводится только когда включена функциональность на карте
  • выводятся только активные и у которых нет указания группировки на них
  • выводится группа если включена группировка, есть активные маркеры и группа активна и у них определена эта группа
  • активные маркеры выводятся если выключена функциональность группировки на карте, но на маркере есть ссылка на группу (активную, или нет)

Примечание: в стилях сделан отступ слева на -20 для того, чтобы прижать к началу, если у Вас наименование группы "наползает" слева на какие-то объекты, измените значение на другое, возможно это в моем шаблоне такое поведение, а в Вашем его нет, возникает из-за того, что это список, и по умолчанию есть точка в начале, которая убирается стилем, а место под нее остается.


Создание маршрутов

Под маршрутом понимается автоматическая прокладка маршрута между ключевыми точками (данная функциональность присутствует в Яндекс.Карты API).

Переходим на закладку "Routes".

YM-Route-List.JPG

Вводим необходимое количество маршрутов с привязкой к конкретной карте


Свойства маршрута

YM-Route-Detail-RouteDetails.JPG

Title Наименование маршрута
Description Примечание
Addition HTML text Дополнительный текст в формате HTML
Published Признак публикации, т.е. активности записи
Route Маршрут, вводится как описано в API т.е. каждая точка маршрута в кавычках, разделителем между точками является запятая

например: "Арбатская", "Кропоткинская", "Москва, проспект Мира 20"

Route by Placemarks Маршрут, определяемый списком идентификаторов меток через точку с запятой
Show Type Масштабировать карту для вывода всего маршрута или не изменять масштаб
With traffic jam Строить маршрут с учетом пробок
Show Route Panel Выводить дополнительную информацию о маршруте
Show total distance Выводить общую информацию о протяженности и времени пути
Show description Выводить описание маршрута
YMapsML-document
KML-document
GPX-document
Map Title Наименование карты, на которой будет выводиться маршрут
Category Категория


Прокладывание пути

Под путем понимается произвольная ломаная линия.

Переходим на закладку "Paths"

YM-Path-List.JPG

Вводим необходимое количество путей с привязкой к конкретной карте.

Координаты удобно выбирать путем перетаскивания метки (значения подставляются в справочное поле формы Current coordinates, оттуда можно скопировать и добавить через разделитель в поле Path) или кликая мышкой на необходимом месте.


Свойства пути

YM-Path-Detail-PathDetails.JPG

Title Наименование пути
Description Примечание
Published Признак публикации, т.е. активности записи
Path Путь, набор координат точек, координаты отделены между собой запятой, сами точки - через точку с запятой

например: 30.385787878185525,59.92335689062723;30.387547407299284,59.92374467628344;30.38804093375804,59.92375544804234

Color Цвет линии (в системе RGBA)

например: FF0000FF

Width Толщина линии
Map Title Наименование карты, на которой будет выводиться путь
Category Категория
Current coordinates Текущие координаты метки


Настройка категорий

Можно перейти на закладку "Categories" и ввести категории для компонента.

Потом можно пройтись по картам и меткам и пометить их категорией.

На основании категорий можно будет дополнительно каким-либо образом расширить функциональность компонента.


Вывод карты на сайте

Создаем пункт меню

Выбираем соответствующий тип

YM-Menu-List.JPG


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

YM-Menu-Select.JPG


См. также

Icon-attachment.pngПлагин для компонента


Language: English  • русский