Yandex Maps Markers for ZOO

Getting started

This is a detailed documentation on Yandex Map Markers element for ZOO. The element have widely settings and easy configurable structure and might highlight catalogue or website based on Joomla! and ZOO.

Installation

Yandex Map Markers element for ZOO can be installed as typical Joomla! extension via Extension manager. Go to Back-end > Extension Manager > Upload package file tab > Upload & Install Joomla extension.

When the package is successfully installed, you have to go to ZOO administration panel and set up the element.

Configuration

Open ZOO start page in Joomla! back-end and open Apps manager (click on configuration icon):

http://your_site.com/administrator/index.php?option=com_zoo&controller=manager

Then select your App (i.e. Blog) where you’d like to add Map element.

http://your_site.com/administrator/index.php?option=com_zoo&controller=manager&task=types&group=blog

In the left side you’ll see a first column called Name. Make sure which name you’d like to configure the element for. Let it be an Article. Move cursor on this name and above it you’ll see Edit elements link. Click on it.

http://your_site.com/administrator/index.php?option=com_zoo&controller=manager&group=blog&task=editelements&cid%5B%5D=article

Now the element manager is appeared. At the right side you’ll find Element Library and group called NorrNext. Click on Yandex Map Markers item there and the new element just been added and appeared in left side. Let’s examine its settings.

Yandex Map Markers element params:

  • Repeatable - [No / Yes] - Если вам нужно более одной точки то - Yes
  • Map Language - [English / Russian / Ukrainian / Turkish] - Поддерживаемые языки
  • API Key - [sting] - Ваш ключ Yandex Map
  • Debug - [No / Yes] - специальный режим загрузки js карты (для профессионалов)
  • Map Height (px) - Высота карты в пикселях
  • Map Wight (px) - Ширина карты в пикселях. Если вам необходимо сделать карту на всю ширину установите значение 0 - это эквивалентно 100%
  • Defaul Map Zoom - установленное значение приближения карты
  • Map Max Zoom - максимальное значение приближения карты
  • Map Min Zoom - минимальное значение приближения карты
  • Map Default Type - [Map / Satellite / Hybrid / Public Map / Public Map Hybrid] - установленный по-умолчанию тип карты [2]
  • Map Draggable - [No / Yes] - возможность перетаскивания карты мышкой
  • Map Double Click Zoom - [No / Yes] - увеличение карты двойным кликом левой клавиши мыши
  • Map Scroll Zoom - [No / Yes] - масштабирование карты используя колесико мыши (scroll)
  • Map MultiTouch Zoom - [No / Yes] - масштабирование карты мультисенсорным касанием
  • Right Mouse Button Magnifier - [No / Yes] - масштабирование карты при выделении области правой кнопкой мыши
  • Left Mouse Button Magnifier - [No / Yes] - масштабирование карты при выделении области левой кнопкой мыши
  • Map Control Panel:
  • Medium Map Default Set - Набор элементов управления, предназначенный для стандартных (от 300 до 1000 пикселей в ширину) карт.
  • Small Map Default Set - Набор элементов управления, предназначенный для маленьких (менее 300 пикселей в ширину) карт.
  • Large Map Default Set - Набор элементов управления, предназначенный для больших (более 1000 пикселей в ширину) карт.
  • Custom Control Panel - Ваш выборочный набор элементов управления. Далее идут параметры которые вы можете включить или выключить, а также настроить их вид.
  • Geolocation - [No / Yes] - Позволяет определить местоположение пользователя путём вызова стандартной геолокационной функции браузера и/или по ip-адресу пользователя
  • Search - [No / Yes] - Поиск географических объектов по названию, адресу или географическим координатам.
  • Size Control Panel Search - [Small / Medium (Default) / Large] - Варианты представления элемента Search.
  • Route Editor - [No / Yes] - Редактор маршрута.
  • Traffic - [No / Yes] - Отображение пробок на карте. У этого элемента есть два представления: подробное (для карт больших размеров) - с расширенной информацией и возможностью посмотреть статистику и прогноз - и компактное (для небольших карт) - только кнопка включения и выключения дорожной информации.
  • Size Control Panel Traffic - [Small / Medium (Default) / Large] - Варианты представления элемента Traffic.
  • Type Selector - [No / Yes] - Переключатель отображаемого типа карты.
  • Size Control Panel Type Selector - [Small / Medium (Default) / Large] - Варианты представления элемента Type Selector.
  • Fullscreen - [No / Yes] - Кнопка переключения полноэкранного режима. При нажатии на эту кнопку карта будет развёрнута на всё окно браузера.
  • Zoom - [No / Yes] - Изменение коэффициента масштабирования.
  • Size Control Panel Zoom - [Small / Medium (Default) / Large] - Варианты представления элемента Zoom.
  • Ruler - [No / Yes] - Отображает на карте масштабный отрезок и кнопку включения поведения "Линейка". Позволяет измерить расстояние между объектами.

Добавление Точек

Eсли вы указали в общих настройках Repeatable, то вы сможете добавить более одной точки(маркера) на карту.

Точка(маркер) на карте имеет параметры:

  • Draggable - [No / Yes] - Можно ли перетакскивать маркер [1]
  • Participation in the itinerary - Участие маркера в маршруте. Если вы хотите использовать точку как часть маршрута, установите галочку.
  • Name Route - это не обязательное поле. Однако может быть очень полезным если вам необходимо создать два и более независимых маршрутов. В таком случае вы просто даете имя маршруту и используете это имя чтобы сгруппировать точки участвующии в этом маршруте.
  • Если вы не укажете имя маршрута, то оно присвоется автоматически одинаковое для всех таких точек, участвующих в маршруте, это объеденит их всех в один маршрут.
  • Type Icon - [Icon / Dot Icon / Circle Icon / Circle Dot Icon] - варианты формы иконки.
  • Color Icon - цвет для иконки. Вы можете использовать те же самые обозначения, которые приняты в CSS (rgb, hsl, hex)
  • Tooltip - это всплывающая подсказка, при наведении на иконку. Использовать HTML теги в ней не получится.
  • Balloon - Описание при клике на иконку маркера. В ней вы можете использовать HTMl теги.

Coordinates determination on the map (in Russian)

!ВАЖНО Ограничения:

Хотя мы и предусмотрели настройки построения строки запроса API, некоторые ограничения использования:

  • Вы не сможете использовать две и более карт на странице с разными параметрами Map Language, API Key, Debug, так как это противоречит принципам работы карты. Однако вы имеете возможность изменять перечисленные параметры на двух разных страницах. Если вы используете две и более карты на одной странице то параметры Map Language, API Key, Debug должны быть одинаковыми для всех карт.
  • 2. Мы не рекомендуем строить больше десяти маршрутов на одной карте.
  • 3. Прочесть условия лицензионного соглашения.