Zh YandexMap Description/ru: Difference between revisions

From Documentation
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 84: Line 84:
Вводим необходимое количество меток с привязкой к конкретной карте. Координаты удобно выбирать путем перетаскивания метки (значения автоматически подставляются в поля формы) или кликая мышкой на необходимом месте.
Вводим необходимое количество меток с привязкой к конкретной карте. Координаты удобно выбирать путем перетаскивания метки (значения автоматически подставляются в поля формы) или кликая мышкой на необходимом месте.


== Элементы метки ==
=== Элементы метки ===
Marker Details
Marker Details
Свойство Описание
Свойство Описание
Line 102: Line 102:




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


(Hidden Attributes for Customization)
(Hidden Attributes for Customization)

Revision as of 20:06, 29 October 2011

Установка

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


Настройка

Переходим на компонент, нажимаем кнопку "Options". Options Вводим полученный ранее в Яндексе ключ для сервиса. При создании новых картографических объектов при открытии карты автоматически вычисляется местоположение, если вычислить не удается, то выводится центр Дворцовой площади Санкт-Петербурга :)

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

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

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

Элементы карты

Title Наименование карты Description Примечание Show Title Вывести наименование карты как всплывающее окно или метку Width Ширина если ввести 0, то карта откроется на всю ширину Height Высота Latitude Широта Longitude Долгота Zoom Масштаб Map Type Тип карты YMapsML-document Object Manager for Placemarks Выводить маркеры только при определенном масштабе, диапазон которого указывается у группы маркеров. Иными словами, Вы указываете на маркере к какой группе он принадлежит. Соответственно, на экране ввода/корректировки группы маркеров указывается минимальный и максимальный масштаб. Данная функциональность работает только если не используется управление маркерами через список групп (поле Placemark Control = No см. ниже в разделе Placemark Groups) Category Категория


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

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


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

Map Type Control Выводить элемент управления переключением типа карты Map Type Control for PMap Возможность переключения на Народную карту Toolbar Выводить панель инструментов Search Control Выводить элемент для поиска по карте Double Click Zoom Возможность масштабирования по двойному щелчку мыши Scroll Wheel Zoom Возможность масштабирования колёсиком мыши Zoom Control Выводить элемент управления масштабом Scale Control Выводить шкалу масштабирования MiniMap Выводить обзорную карту Traffic Control Возможность использования сервиса Яндекс.Пробки


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

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

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 Примечание, расположенное под картой


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

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


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

Элементы метки

Marker Details Свойство Описание Map Title Наименование карты, на которой будет выводиться метка Title Наименование Description Примечание Published Признак публикации, т.е. активности записи Icon Type Иконка Latitude Широта Longitude Долгота Open baloon Сразу открыть всплывающее окно URL Site URL адрес сайта Site Name Наименование сайта, если хочется вместо URL видеть красивое название URL Image URL адрес изображения, которое можно вывести во всплывающем окне Placemark Group Группа, к которой относится метка Category Категория


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

(Hidden Attributes for Customization)


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

Скопируйте свои изображения меток (в формате PNG) в каталог /administrator/components/com_zhyandexmap/assets/icons/ Компонент автоматически подхватит изображения при выборе типа метки. Единственное требование – чтобы расширение файла было .png т.е. в нижнем регистре, т.к. наименования изображений хранятся в БД без расширения, и оно дописывается при выводе. Если Вам дополнительно нужны поля, которые хотите заполнять через интерфейс, а затем их использовать в своих скриптах, то в разделе дополнительных полей для пользовательской кастомизации Вы можете определить в какое поле будет записываться нужная вам информация. Для удобства Вы также можете изменить подпись этих полей в файле /administrator/language/en-GB/en-GB.com_zhyandexmap.ini строки COM_ZHYANDEXMAP_MAPMARKER_DETAIL_ATTRIBUTE1_LABEL COM_ZHYANDEXMAP_MAPMARKER_DETAIL_ATTRIBUTE2_LABEL ... COM_ZHYANDEXMAP_MAPMARKER_DETAIL_ATTRIBUTE9_LABEL Группировка меток

Метка может входить в одну из групп, для этого на метке указываете принадлежность к группе. Если на карте установлен признак использования группировки меток (значение поля 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 используется для отображения иконки группы в списке групп.


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

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


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

Элементы группы

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".

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

Элементы маршрута

Title Наименование маршрута Description Примечание Published Признак публикации, т.е. активности записи Map Title Наименование карты, на которой будет выводиться маршрут Category Категория Route Маршрут, вводится как описано в API т.е. каждая точка маршрута в кавычках, разделителем между точками является запятая например: "Арбатская", "Кропоткинская", "Москва, проспект Мира 20"


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

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

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

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

Элементы пути

Title Наименование пути Description Примечание Published Признак публикации, т.е. активности записи Color Цвет линии (в системе RGBA) например: FF0000FF Width Толщина линии Map Title Наименование карты, на которой будет выводиться путь Category Категория Current coordinates Текущие координаты метки Path Путь, набор координат точек, координаты отделены между собой запятой, сами точки - через точку с запятой например: 30.385787878185525,59.92335689062723;30.387547407299284,59.92374467628344;30.38804093375804,59.92375544804234


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

Можно перейти на закладку "Categories" и ввести категории для компонент. Потом можно пройтись по картам и меткам и пометить их категорией. На основании категорий можно будет дополнительно каким-либо образом расширить функциональность компонента. Вывод карты на сайте

Создаем пункт меню, и выбираем соответствующий тип

Language: [[::Zh YandexMap Description/ru|English]]