Zh GoogleMap Plugin/ru

From Documentation
Jump to navigation Jump to search

Назначение

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

Более того, поскольку это плагин для содержимого (content), то Вы можете вставить код вызова в Custom HTML модуль и вывести карту как модуль. Рекомендуется ставить ширину=0 (что соответствует width: 100%), для того, чтобы карта автоматически заполняла ширину модуля и при изменении размеров (например, переменный размер шаблона), не происходило "вылезание" карты за размеры.


Установка

Установите плагин через Extension Manager.

Сделайте его активным.

Т.к. это плагин для компонента, то компонент должен быть установлен

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

Использование

Вывод карты

Для вывода карты в любом месте статьи вставьте следующий фрагмент

{zhgooglemap:MMM;Zoom;MapType;Width;Height}

где

  • MMM - (обязательный) идентификатор карты. Он выведен в списке карт.
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 0 до 18 для переопределения масштаба
    • do not change - не изменять масштаб карты
  • MapType - новый тип карты
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • NZTOPOMAP
    • OPENTOPOMAP
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты

Вывод на карте определенной метки

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

{zhgooglemap-marker:NNN;Center;Zoom;MapType;Width;Height;Action}

где

  • NNN - (обязательный) идентификатор маркера
  • Center - центр карты(map) или метка(placemark) является новым центром карты, допустимые значения:
    • map
    • placemark
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 0 до 18 для переопределения масштаба
    • do not change - не изменять масштаб карты
  • MapType - новый тип карты
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • NZTOPOMAP
    • OPENTOPOMAP
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты
  • Action - выполнить событие при загрузке карты, можно указывать через запятую
    • do not change - ничего не выполнять
    • click - выполнить событие нажатия на метки.
    • bounce - изменить анимацию метки.


Для случая выполнения события Вы должны установить Center=placemark


Пример 1:
{zhgooglemap-marker:5;placemark;10}


Пример 2:
{zhgooglemap-marker:1;map;do not change}


Пример 3:
{zhgooglemap-marker:4}
В этом случае

  • Center по умолчанию устанавливается в map
  • Zoom по умолчанию устанавливается в do not change



Пример 4:
{zhgooglemap-marker:1;;15}
В этом случае

  • Center по умолчанию устанавливается в map
  • Zoom устанавливается в 15


Вывод на карте определенного маршрута

Также у Вас есть возможность вызвать карту только с одним определенным маршрутом. Для этого необходимо вставить следующий вызов

{zhgooglemap-route:NNN;Center;Zoom;MapType;Width;Height}

где

  • NNN - (обязательный) идентификатор маршрута
  • Center - центр карты(map) (пока не используется) является новым центром карты, допустимые значения:
    • map
    • do not change - не изменять центр карты
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 0 до 18 для переопределения масштаба
    • do not change - не изменять масштаб карты
  • MapType - новый тип карты
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • NZTOPOMAP
    • OPENTOPOMAP
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты



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

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

{zhgooglemap-path:NNN;Center;Zoom;MapType;Width;Height}

где

  • NNN - (обязательный) идентификатор пути
  • Center - центр карты(map) (пока не используется) является новым центром карты, допустимые значения:
    • map
    • do not change - не изменять центр карты
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 0 до 18 для переопределения масштаба
    • do not change - не изменять масштаб карты
  • MapType - новый тип карты
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • NZTOPOMAP
    • OPENTOPOMAP
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты

Вывод на карте списка меток

Вы имеете возможность вызвать карту с маркерами из разных карт (указав их списком). Для этого необходимо вставить следующий вызов

{zhgooglemap-markerlist:PlacemarkList;MMM;Zoom;MapType;Width;Height;Center;Action}

где

  • PlacemarkList - (обязательный) список идентификаторов меток, разделенных запятой
  • MMM - (обязательный) идентификатор карты
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 0 до 18 для переопределения масштаба
    • do not change - не изменять масштаб карты
  • MapType - новый тип карты
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • NZTOPOMAP
    • OPENTOPOMAP
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты
  • Center - новый центр карты
    • идентификатор метки, чьи координаты будут считаться центром карты. Метка должна быть задана широтой и долготой
    • do not change - не изменять центр карты
  • Action - выполнить событие при загрузке карты, можно указывать через запятую
    • do not change - ничего не выполнять
    • click - выполнить событие нажатия на метке центрирования карты.
    • bounce - изменить анимацию метки центрирования карты.

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

Пример 1:

{zhgooglemap-markerlist:1,2,5;10}
В этом случае Вы увидите метки с ID=1, с ID=2 и с ID=5 на карте с ID=10

Вывод на карте меток определенной группы

Вы имеете возможность вызвать карту с маркерами из разных карт (указав группу маркеров). Для этого необходимо вставить следующий вызов

{zhgooglemap-group:GroupList;MMM;Zoom;MapType;Width;Height;Center;Action;ObjectTypeList}

где

  • GroupList - (обязательный) список идентификаторов групп, разделенных через запятую
  • MMM - (обязательный) идентификатор карты
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 0 до 18 для переопределения масштаба
    • do not change - не изменять масштаб карты
  • MapType - новый тип карты
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • NZTOPOMAP
    • OPENTOPOMAP
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты
  • Center - новый центр карты
    • идентификатор метки, чьи координаты будут считаться центром карты. Метка должна быть задана широтой и долготой
    • do not change - не изменять центр карты
  • Action - выполнить событие при загрузке карты, можно указывать через запятую
    • do not change - ничего не выполнять
    • click - выполнить событие нажатия на метке центрирования карты.
    • bounce - изменить анимацию метки центрирования карты.
  • ObjectTypeList - типы объектов карты, которые относятся к данным группам и будут отображаться. Можно вводить через запятую
    • placemark - обрабатываются метки. Это значение по умолчанию
    • path - обрабатываются пути
    • all - обрабатываются все объекты


Например, указав значение для ObjectTypeList как path Вы получите пути, относящиеся к данным группам. Значение all аналогично placemark,path

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

Вывод на карте определенной категории меток

У вас есть возможность вызвать карту с маркерами из разных карт (указав категорию маркеров). Для этого необходимо вставить следующий вызов

{zhgooglemap-category:CategoryList;MMM;Zoom;MapType;Width;Height;Center;Action;ObjectTypeList}

где

  • CategoryList - (обязательный) список идентификаторов категорий маркеров, разделенных через запятую
  • MMM - (обязательный) идентификатор карты
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 0 до 18 для переопределения масштаба
    • do not change - не изменять масштаб карты
  • MapType - новый тип карты
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • NZTOPOMAP
    • OPENTOPOMAP
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты
  • Center - новый центр карты
    • идентификатор метки, чьи координаты будут считаться центром карты. Метка должна быть задана широтой и долготой
    • do not change - не изменять центр карты
  • Action - выполнить событие при загрузке карты
    • do not change - ничего не выполнять
    • click - выполнить событие нажатия на метке центрирования
  • ObjectTypeList - типы объектов карты, которые относятся к данным категориям и будут отображаться. Можно вводить через запятую
    • placemark - обрабатываются метки. Это значение по умолчанию
    • path - обрабатываются пути
    • route - обрабатываются маршруты
    • all - обрабатываются все объекты


Например, указав значение для ObjectTypeList как path Вы получите пути, относящиеся к данным категориям.

Значение all аналогично placemark,path,route

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

Вывод карты в Lightbox

Сделана возможность вызова карты в отдельном окне, для этого необходимо указать следующий код

{zhgooglemap-lightbox:MMM;Title;Width;Height;Image;PlacemarkList}

где

  • MMM – (обязательный) идентификатор карты
  • Title – текст линка
  • Width – ширина lightbox-окна
  • Height – высотаof lightbox-окна.
  • Image - изображение, которое может быть выведено

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

administrator/components/com_zhgooglemap/assets/lightbox/

или

components/com_zhgooglemap/assets/lightbox/

в зависимости от установленного свойства компонента "Compatible Mode for Resource Files"

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


Существуют ограничения – нельзя использовать в наименовании символы
< > / \


Карта выводится как компонент (т.е. все функции именно компонента, не плагина). Т.е. плагин осуществляет вызов компонента. Есть особенность – при этом стили шаблона не подгружаются.


Пример 1:

{zhgooglemap-lightbox:2;;800;500;ZhukLogo.png}

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

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

Ограничения

Плагин не работает в контактах, так как у контактов тип отличен от "content"
Но у Вас есть возможность создать статью, отформатировав ее как контакт, даже красивее, и включить в нее карту
Или в этом случае использовать модуль

Т.к. это плагин для компонента, то компонент должен быть установлен

Существуют ограничения – нельзя использовать в наименовании символы
< > / \

См. также

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

Модуль для компонента


Language: English  • русский