Zh YandexMap Plugin/ru

From Documentation
Jump to navigation Jump to search

Назначение

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


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


Установка

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

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

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

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

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

Вывод карты

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

{zhyandexmap:MMM;Hidden Container Text}

где

  • MMM - (обязательный) идентификатор карты. Он выведен в списке карт.
  • Hidden Container Text - наименование скрытого контейнера, если вы хотите выводить карту из скрытого контейнера (по ссылке), и кликнув на ссылку показать карту

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

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

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

{zhyandexmap-marker:NNN;Center;Zoom;MapType;Width;Height;Hidden Container Text}

где

  • NNN - (обязательный) идентификатор маркера
  • Center - центр карты(map) или метка(placemark) является новым центром карты, допустимые значения:
    • map
    • placemark
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 1 до 17 для переопределения масштаба
    • do not change - не изменять масштаб карты
    • max available - максимально возможный для данного типа карты
  • MapType - новый тип карты
    • MAP
    • SATELLITE
    • HYBRID
    • PMAP
    • PHYBRID
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты
  • Hidden Container Text - наименование скрытого контейнера, если вы хотите выводить карту из скрытого контейнера (по ссылке), и кликнув на ссылку показать карту


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



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


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


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

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



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

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



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

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

{zhyandexmap-markerlist:PlacemarkList;MMM;Zoom;MapType;Width;Height;Hidden Container Text;Center}

где

  • PlacemarkList - (обязательный) список идентификаторов меток, разделенных запятой
  • MMM - (обязательный) идентификатор карты
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 1 до 17 для переопределения масштаба
    • do not change - не изменять масштаб карты
    • max available - максимально возможный для данного типа карты
  • MapType - новый тип карты
    • MAP
    • SATELLITE
    • HYBRID
    • PMAP
    • PHYBRID
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты
  • Hidden Container Text - наименование скрытого контейнера, если вы хотите выводить карту из скрытого контейнера (по ссылке), и кликнув на ссылку показать карту
  • Center - новый центр карты
    • идентификатор метки, чьи координаты будут считаться центром карты. Метка должна быть задана широтой и долготой
    • do not change - не изменять центр карты


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


Пример 1:

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

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

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

{zhyandexmap-group:PlacemarkGroupList;MMM;Zoom;MapType;Width;Height;Hidden Container Text;Center}

где

  • PlacemarkGroupList - (обязательный) список идентификаторов групп меток, разделенных запятой
  • MMM - (обязательный) идентификатор карты
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 1 до 17 для переопределения масштаба
    • do not change - не изменять масштаб карты
    • max available - максимально возможный для данного типа карты
  • MapType - новый тип карты
    • MAP
    • SATELLITE
    • HYBRID
    • PMAP
    • PHYBRID
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты
  • Hidden Container Text - наименование скрытого контейнера, если вы хотите выводить карту из скрытого контейнера (по ссылке), и кликнув на ссылку показать карту
  • Center - новый центр карты
    • идентификатор метки, чьи координаты будут считаться центром карты. Метка должна быть задана широтой и долготой
    • do not change - не изменять центр карты


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

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

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

{zhyandexmap-category:NNN;MMM;Zoom;MapType;Width;Height;Hidden Container Text;Center}

где

  • PlacemarkCategoryList - (обязательный) список идентификаторов категории меток, разделенных запятой
  • MMM - (обязательный) идентификатор карты
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 1 до 17 для переопределения масштаба
    • do not change - не изменять масштаб карты
    • max available - максимально возможный для данного типа карты
  • MapType - новый тип карты
    • MAP
    • SATELLITE
    • HYBRID
    • PMAP
    • PHYBRID
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты
  • Hidden Container Text - наименование скрытого контейнера, если вы хотите выводить карту из скрытого контейнера (по ссылке), и кликнув на ссылку показать карту
  • Center - новый центр карты
    • идентификатор метки, чьи координаты будут считаться центром карты. Метка должна быть задана широтой и долготой
    • do not change - не изменять центр карты


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

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

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

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

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

где

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

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

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


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


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


Пример 1:

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

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

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

Ограничения

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

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

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

См. также

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


Language: English  • русский