Zh YandexMap Description/ru

From Documentation
Jump to navigation Jump to search

Установка

Компонент устанавливается на Joomla! 3.x стандартным способом установки через Extension Manager


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

Настройка

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

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

  • Components
  • Zh YandexMap



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


Место по умолчанию

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

Вы можете установить широту и долготу для места по умолчанию.

После чего, когда Вы создаете новую карту, метку, путь через административную панель, местоположение метки на карте будет установлено по умолчанию.


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

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

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


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

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

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

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

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

И вы должны скопировать иконки из administrator папки (/administrator/components/com_zhyandexmap/assets/icons) в site папку (/components/com_zhyandexmap/assets/icons), т.к. изначально она пустая (потому что если site папка будет содержать иконки, то размер расширения увеличится в два раза)

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

Тип карты в редакторе

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


Протокол

Вы можете установить протокол для загрузки карты

powered by

Вы можете определить место вывода моего логотипа, или скрыть его


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

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

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

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


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

Вы можете указать использовать иконку не из файла, а метку с определенным стилем в API См. список

Width Ширина карты

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

Height Высота карты
Latitude Широта центра карты
Longitude Долгота центра карты
Zoom Масштаб
  • Max available - максимально возможный для выбранного типа карты
Map Bounds Границы карты
Min Zoom Минимальный масштаб карты
Max Zoom Максимальный масштаб карты
  • Unlimited - Масштаб не ограничен (это связано с тем, что на определенных типах карт масштаб может отличаться от максимально описанного)
Map Type Тип карты
OpenStreetMap Layer Слой OSM
Allow Custom Map Types Разрешить пользовательские типы карт
Custom Map Types List Список идентификаторов пользовательских типов карт
Grid coordinates Устаревший параметр для АПИ 1.x
YMapsML-document
KML-document
GPX-document
Object Manager for Placemarks Выводить маркеры только при определенном масштабе, диапазон которого указывается у группы маркеров. Иными словами, Вы указываете на маркере к какой группе он принадлежит. Соответственно, на экране ввода/корректировки группы маркеров указывается минимальный и максимальный масштаб. Данная функциональность работает только если не используется управление маркерами через список групп (поле Placemark Control = No см. ниже в разделе Groups)
Language Язык
Category Категория

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


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



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

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

Map Type Control Выводить элемент управления переключением типа карты
Map Type Control for PMap Возможность переключения на Народную карту
Toolbar Выводить панель инструментов
Toolbar Action Активное действие
  • Default - по умолчанию
  • Magnifier - увеличительное стекло
  • Ruler - линейка
Search Control Выводить элемент для поиска по карте
Double Click Zoom Возможность масштабирования по двойному щелчку мыши
Scroll Wheel Zoom Возможность масштабирования колёсиком мыши
Zoom Control Выводить элемент управления масштабом
Scale Control Выводить шкалу масштабирования
MiniMap Выводить обзорную карту
MiniMap Type Тип обзорной карту
Traffic Control Возможность использования сервиса Яндекс.Пробки
Show Traffic Layer Вывести данные сервиса Яндекс.Пробки
Traffic Layer Provider Провайдер данных сервиса Яндекс.Пробки
  • Actual
  • Archive
Draggable Возможность изменения положение центра карты
Right Button Magnifier Возможность изменения машштаба выделенной области правой кнопкой мыши
Find Control (geocoding) Возможность поиска по введенному адресу
Find Control width Ширина поля ввода адреса для поиска
Draw route from search point to place Отобразить маршрут от найденного адреса до центра карты

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



Zoom Control Элемент масштабирования
Zoom Control Offset: X-position Смещение по X
Zoom Control Offset: Y-position Смещение по Y
Scale Control Шкала
Scale Control Offset: X-position Смещение по X
Scale Control Offset: Y-position Смещение по Y
Map Type Control Элемент выбора типа карты
Map Type Control Offset: X-position Смещение по X
Map Type Control Offset: Y-position Смещение по Y
Map Type Control for PMap Элемент выбора типа карты
Map Type Control for PMap Offset: X-position Элемент выбора типа народной карты
Map Type Control for PMap Offset: Y-position Смещение по Y
MiniMap Миникарта
MiniMap Offset: X-position Смещение по X
MiniMap Offset: Y-position Смещение по Y
Toolbar Инструментальная панель
Toolbar Offset: X-position Смещение по X
Toolbar Offset: Y-position Смещение по Y
Search Control Элемент поиска
Search Control Offset: X-position Смещение по X
Search Control Offset: Y-position Смещение по Y
Traffic Control Элемент Яндекс.Пробки
Traffic Control Offset: X-position Смещение по X
Traffic Control Offset: Y-position Смещение по Y
Find Control (geocoding) Элемент поиска по адресу
Geolocation Control Элемент поиска текущего местоположения

Параметры отображения меток

Show placemarks in cluster Разрешить кластеризацию меток
Marker cluster Zoom Level Масштаб для кластера
Group placemarks in cluster by group property Группировать метки в кластер согласно принадлежности к группе
Disable zoom when click on cluster Отключить изменение масштаба при клике на кластере
Add cluster objects immediately Сразу добавлять объекты в кластер
Show Placemarks in Alphabetical Order Сортировать метки по алфавиту
Cluster Grid Size Размер сетки кластера
Min count of obects in cluster Минимальное количество объектов в кластере

Параметры отображения списка меток


Width Ширина списка
Height Высота списка
Position Местоположение
Style Стиль
Background Color Цвет фонв
Action by Click Действие при клике
Placemark List Content Содержимое списка
Appearance Внешний вид

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

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

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

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


Loading map objects dynamically Опция позволяет динамически загружать метки с помощью AJAX
  • No
  • JQuery
  • Mootools
Load type Тип загрузки меток, т.е. загружать их всех или по каким-то критериям
  • All
  • All (two steps: use map bounds, all the rest)
  • Use map bounds
Buffer size for placemarks Вы можете загружать метки частями
Loading content data dynamically Опция позволяет динамически загружать содержимое метки с помощью AJAX
  • No
  • JQuery
  • Mootools

Т.е. ваша страница содержит код создания меток, но содержимое всплывающих окон загружается динамически.
Если метки загружаются с помощью AJAX, то и их содержимое загружается также динамически.

Placemark Filter Фильтр меток
Allow to user enter markers Ввод маркеров пользователями
New Placemark State Статус для новой пользовательской метки.
New Contact State Статус для нового пользовательского контакта (если включена интеграция с контактами).
Show Icon Type Selector for New Placemark Возможность выбора иконки при создании пользовательских меток.
CSS Class Наименование класса для div секции карты
Additional CSS styles for loading Список файлов стилей CSS для загрузки при отображении карты, разделенных либо точкой с запятой, либо с новой строки

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

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

Интеграция

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

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

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

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



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


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

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

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


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

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

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

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

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


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

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

Preset Standard Icon Предопределенная иконка в API

Вы можете указать использовать иконку не из файла, а метку с определенным стилем в API См. список

Icon Content Содержимое иконки (если используются предопределенные в API иконки с поддержкой текста внутри)
Open baloon Сразу открыть всплывающее окно
Balloon Content Тип содержимого всплывающего окна
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 Дата окончания публикации метки
Access ACL уровень доступа к метки

Интеграция

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

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

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



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

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


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

/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, и у Вас есть возможность делать с ними что угодно.

На карте также есть выпадающий список 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 Group Icon на закладке "Maps" используется для отображения иконки группы в списке групп.

Display


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

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

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


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


Title Наименование группы
Description Примечание
Published Признак публикации, т.е. активности записи
Icon Type Иконка группы (можно использовать свои, т.к. механизм тот же)
Icon X-offset Отступ иконки по X
Icon Y-offset Отступ иконки по Y

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

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

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

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

Display


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

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

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

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


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


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

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

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

Display


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

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

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

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

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


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

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

например: 30.385787878185525,59.92335689062723;30.387547407299284,59.92374467628344;30.38804093375804,59.92375544804234
Сначала идет долгота, потом указывается широта. Такое следование было в API 1.0, оно и осталось для совместимости.

Object Type Тип объекта
  • Line - линия
  • Polygon - прямоугольник
  • Circle - круг
Geodesic line Геодезическая линия
Width Толщина линии
Color Цвет линии (в системе RGBA)

например: FF0000FF

Opacity Прозрачность
Fill Color Цвет заливки
Fill Opacity Прозрачность заливки
Fill Image URL URL изображения для заливки
Radius Радиус окружности в метрах
Map Title Наименование карты, на которой будет выводиться путь
Category Категория
Current coordinates Текущие координаты метки

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

Balloon Content Содержимое всплывающего информационного окна
Action by Click Выполнить действие при нажатии на метке
  • None - ничего не выполнять
  • Open Balloon - открыть всплывающее окно

Display


Пользовательские типы карт

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

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

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


Title Наименование пути
Description Примечание
Tile Width Ширина тайла
Tile Height Высота тайла
Get Tile URL function Функция получения тайлов, см. ниже
Brightness Яркость
Projection Проекция
Not Found Tile URL Функция получения тайла для отсутствующего основного тайла
Transparent layer Признак прозрачности слоя
Overlay Наложение тайлов другого типа карты
Published Признак публикации, т.е. активности записи
Category Категория

Пример функции получения тайлов

Два параметра, координаты и масштаб

function (tileNumber, zoom) {    
  return ['https://tile.openstreetmap.org', zoom, tileNumber[0], tileNumber[1]].join('/') + '.png';
}

Это аналог получения тайлов https://tile.openstreetmap.org/{z}/{x}/{y}.png

Display


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

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

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

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



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

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

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

Тип меню - это карта.

Он отображает заранее сконфигурированную карту. У вас есть возможность переопределить ряд параметров карты.

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

Если вы не измените другие поля - вы получите карту такую, как вы ее определили изначально.

Для списков вы должны вводить идентификаторы через точку с запятой в качестве разделителя

Map Title Карта для отображения
Zoom Масштаб карты
Width Ширина
Height Высота
Placemark List Список идентификаторов для отображения меток на карте (например, если они с разных карт).
Exclude Placemark List Список идентификаторов меток для исключения их отображения на карте
Placemark Group List Список идентификаторов групп для отображения меток на карте
Placemark Category List Список идентификаторов категорий для отображения меток на карте
Route List Список идентификаторов для отображения маршрутов на карте
Exclude Route List Список идентификаторов маршрутов для исключения их отображения на карте
Route Category List Список идентификаторов категорий для отображения маршрутов на карте
Path List Список идентификаторов для отображения путей на карте
Exclude Path List Список идентификаторов путей для исключения их отображения на карте
Path Group List Список идентификаторов групп для отображения путей на карте
Path Category List Список идентификаторов категорий для отображения путей на карте
Placemark for map center Новый центр карты, идентификатор метки, чьи координаты будут считаться центром карты. Метка должна быть задана широтой и долготой.
Placemark Filter Фильтр меток
Enable Support External Link to Placemark Включает опцию по созданию своего собственного списка меток. См. также Tutorials.


См. также

Плагин для компонента


Language: English  • русский