View source for Zh YandexMap Description/ru

{{Zh_YandexMap_Description_Install/ru}}


{{Zh_YandexMap_Description_Map/ru}}


{{Zh_YandexMap_Description_Placemark/ru}}


{{Zh_YandexMap_Description_Placemark_Group/ru}}


{{Zh_YandexMap_Description_Route/ru}}


{{Zh_YandexMap_Description_Path/ru}}


{{Zh_YandexMap_Description_Category/ru}}


{{Zh_YandexMap_Description_ShowMap/ru}}


== Установка ==

Компонент устанавливается на 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" и ввести категории для компонент. Потом можно пройтись по картам и меткам и пометить их категорией. На основании категорий можно будет дополнительно каким-либо образом расширить функциональность компонента.
Вывод карты на сайте

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

{{Languages}}