Zh GoogleMap Plugin/ru

From Documentation
Jump to navigation Jump to search

Назначение

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

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


Установка

Установите плагин через Extension Manager. Сделайте его активным.


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

Вывод карты

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

{zhgooglemap:MMM}

где

  • MMM - (обязательный) идентификатор карты. Он выведен в списке карт.


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

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

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

где

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



Пример 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-group:NNN;MMM;Zoom;MapType;Width;Height;Center}

где

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

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

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

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

где

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

Когда карта выводится по категории, то все объекты на карте (метки, маршруты, пути) также ограничиваются данной категорией

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

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

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

где

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

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

administrator/components/com_zhgooglemap/assets/lightbox/

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


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


Пример 1:

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

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

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

Ограничения

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

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


См. также

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


Language: English  • русский