Zh OpenStreetMap Plugin Article Overview Map/ru: Difference between revisions

From Documentation
Jump to navigation Jump to search
(Created page with "== Назначение == Плагин для компонента предназначен для вставки карт в статьи, которые имеют атр...")
 
 
(4 intermediate revisions by the same user not shown)
Line 16: Line 16:
Плагин поддерживает функцию автообновления
Плагин поддерживает функцию автообновления
</p>
</p>
== Конфигурирование ==
Вы должны скогфигурировать плагин - пользовательские поля и другие настройки.
[[File:OSM Article Overview Plugin-1.png]]
[[File:OSM Article Overview Plugin-2.png]]
{|class="zhpropertytable"
|-
|class="zhproperty"|Map Title||class="zhdescription"|Карта по умолчанию, когда она не задана при вызове плагина
|-
|class="zhproperty"|Field Group||class="zhdescription"|Группа, которой принадлежат поля широты и долготы, а также другие поля
|-
|class="zhproperty"|Latitude||class="zhdescription"|Свойство для получения значения широты
|-
|class="zhproperty"|Longitude||class="zhdescription"|Свойство для получения значения долготы
|-
|class="zhproperty"|Icon Type||class="zhdescription"|Свойство для получения значения иконки
|-
|class="zhproperty"|Icon X-offset||class="zhdescription"|Свойство для получения значения отступа иконки по X
|-
|class="zhproperty"|Icon Y-offset||class="zhdescription"|Свойство для получения значения отступа иконки по X
|-
|class="zhproperty"|Marker||class="zhdescription"|Метка<br />
* '''No''' - Не выводить метку
* '''Simple''' - Метка без анимации
* '''Simple: Bounce''' - Метка с анимацией (Прыгает)
* '''Simple: Elastic Bounce''' - Метка с анимацией (Упруго Прыгает)
* '''Icon File: Simple''' - Метка без анимации
* '''Icon File: Bounce''' - Метка с анимацией (Прыгает)
* '''Icon File: Elastic Bounce''' - Метка с анимацией (Упруго Прыгает)
|-
|class="zhproperty"|Open Popup||class="zhdescription"|Выполняет действие, которое описано в '''Action by Click'''
|-
|class="zhproperty"|Popup Content||class="zhdescription"|Содержимое информационного окна<br />
* '''Title'''
* '''None'''
|-
|class="zhproperty"|Action by Click||class="zhdescription"|Действие при клике на метке<br />
* '''Open Popup'''
* '''Open Article in the same page'''
* '''Open Article in new page'''
* '''None'''
|-
|class="zhproperty"|Article Button in Popup toolbar||class="zhdescription"|Кнопка Статьи в тулбаре информационного окна
|-
|class="zhproperty"|Show GPS information||class="zhdescription"|Вывести GPS информацию (координаты) в информационном окне
|-
|class="zhproperty"|<b>Default values</b>||class="zhdescription"|Секция для значений по умолчанию, если нет данных
|-
|class="zhproperty"|Icon Type||class="zhdescription"|Иконка
|-
|class="zhproperty"|Icon X-offset||class="zhdescription"|Отступ иконки по X
|-
|class="zhproperty"|Icon Y-offset||class="zhdescription"|Отступ иконки по Y
|}


== Использование ==  
== Использование ==  
Line 26: Line 86:
</pre>
</pre>
где
где
* NNN - идентификатор карты, если не будет указан, берется значение по умолчанию
* Center - центр карты(map) или метка(placemark) является новым центром карты, допустимые значения:
** '''map'''
** '''placemark'''
* Zoom - новый масштаб карты, допустимые значения
** значение от '''0''' до '''25''' для переопределения масштаба
** '''do not change''' - не изменять масштаб карты
* MapType - новый тип карты
** OSM
** OPENTOPOMAP
** '''do not change''' - не изменять тип карты
* Width - новая ширина карты
** значение ширины в пикселях
** '''do not change''' - не изменять ширину карты
* Height - новая высота карты
** значение высоты в пикселях
** '''do not change''' - не изменять высоту карты
* Action - выполнить событие при загрузке карты, можно указывать через запятую
** '''do not change''' - ничего не выполнять
** '''click''' - выполнить событие нажатия на метки.
** '''bounce''' - изменить анимацию метки (прыгает).
** '''elastic bounce''' - изменить анимацию метки (упруго прыгает).
** '''exclusive bounce''' - изменить анимацию метки (прыгает только одна метка).
** '''exclusive elastic bounce''' - изменить анимацию метки (упруго прыгает только одна метка).
Для случая выполнения события Вы должны установить Center='''placemark'''
<br />
Примеры:
1. Вызов со всеми значениями по умолчанию
{zhosmmap-overview:}
В данном вызове при выводе карты будут использованы значения по умолчанию, определенные в плагине
2. Вызов с определенной картой
{zhosmmap-overview:10}
В этом случае карта с будет использована с ID=10.
3. Вызов с центрированием на метке статьи
{zhosmmap-overview:;placemark}
Как Вы можете увидеть, ID карты не указан
4. Установка масштаба карты и действия с меткой
{zhosmmap-overview:;placemark;14;;;;bounce}
=== Вывод карты с объектами, фильтр по списку статей ===
У Вас есть возможность вызвать карту со всеми объектами, и вывести статьи на карту указанием списка статей. Все атрибуты берутся из пользовательских полей статьи, если иконка не определена, берется значение по умолчанию. Для этого необходимо вставить следующий вызов
<pre>
{zhosmmap-overview-articlelist:ArticleList;NNN;Center;Zoom;MapType;Width;Height;Action}
</pre>
где
* ArticleList - (обязательный) список идентификаторов статей, разделенных запятой
* NNN - идентификатор карты, если не будет указан, берется значение по умолчанию
* Center - центр карты(map) или метка(placemark) является новым центром карты, допустимые значения:
** '''map'''
** '''placemark'''
* Zoom - новый масштаб карты, допустимые значения
** значение от '''0''' до '''25''' для переопределения масштаба
** '''do not change''' - не изменять масштаб карты
* MapType - новый тип карты
** OSM
** OPENTOPOMAP
** '''do not change''' - не изменять тип карты
* Width - новая ширина карты
** значение ширины в пикселях
** '''do not change''' - не изменять ширину карты
* Height - новая высота карты
** значение высоты в пикселях
** '''do not change''' - не изменять высоту карты
* Action - выполнить событие при загрузке карты, можно указывать через запятую
** '''do not change''' - ничего не выполнять
** '''click''' - выполнить событие нажатия на метки.
** '''bounce''' - изменить анимацию метки (прыгает).
** '''elastic bounce''' - изменить анимацию метки (упруго прыгает).
** '''exclusive bounce''' - изменить анимацию метки (прыгает только одна метка).
** '''exclusive elastic bounce''' - изменить анимацию метки (упруго прыгает только одна метка).
Для случая выполнения события Вы должны установить Center='''placemark'''
<br />
=== Вывод карты с объектами, фильтр по списку категорий статей ===
У Вас есть возможность вызвать карту со всеми объектами, и вывести статьи на карту указанием списка категорий статей. Все атрибуты берутся из пользовательских полей статьи, если иконка не определена, берется значение по умолчанию. Для этого необходимо вставить следующий вызов
<pre>
{zhosmmap-overview-category:CategoryList;NNN;Center;Zoom;MapType;Width;Height;Action}
</pre>
где
* CategoryList - (обязательный) список идентификаторов категорий статей, разделенных запятой
* NNN - идентификатор карты, если не будет указан, берется значение по умолчанию
* NNN - идентификатор карты, если не будет указан, берется значение по умолчанию
* Center - центр карты(map) или метка(placemark) является новым центром карты, допустимые значения:
* Center - центр карты(map) или метка(placemark) является новым центром карты, допустимые значения:

Latest revision as of 11:42, 30 July 2020

Назначение

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


Установка

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

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

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

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

Конфигурирование

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


Map Title Карта по умолчанию, когда она не задана при вызове плагина
Field Group Группа, которой принадлежат поля широты и долготы, а также другие поля
Latitude Свойство для получения значения широты
Longitude Свойство для получения значения долготы
Icon Type Свойство для получения значения иконки
Icon X-offset Свойство для получения значения отступа иконки по X
Icon Y-offset Свойство для получения значения отступа иконки по X
Marker Метка
  • No - Не выводить метку
  • Simple - Метка без анимации
  • Simple: Bounce - Метка с анимацией (Прыгает)
  • Simple: Elastic Bounce - Метка с анимацией (Упруго Прыгает)
  • Icon File: Simple - Метка без анимации
  • Icon File: Bounce - Метка с анимацией (Прыгает)
  • Icon File: Elastic Bounce - Метка с анимацией (Упруго Прыгает)
Open Popup Выполняет действие, которое описано в Action by Click
Popup Content Содержимое информационного окна
  • Title
  • None
Action by Click Действие при клике на метке
  • Open Popup
  • Open Article in the same page
  • Open Article in new page
  • None
Article Button in Popup toolbar Кнопка Статьи в тулбаре информационного окна
Show GPS information Вывести GPS информацию (координаты) в информационном окне
Default values Секция для значений по умолчанию, если нет данных
Icon Type Иконка
Icon X-offset Отступ иконки по X
Icon Y-offset Отступ иконки по Y

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

Вывод карты

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

{zhosmmap-overview:NNN;Center;Zoom;MapType;Width;Height;Action}

где

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

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

Примеры:

1. Вызов со всеми значениями по умолчанию

{zhosmmap-overview:}


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


2. Вызов с определенной картой

{zhosmmap-overview:10}


В этом случае карта с будет использована с ID=10.


3. Вызов с центрированием на метке статьи

{zhosmmap-overview:;placemark}


Как Вы можете увидеть, ID карты не указан


4. Установка масштаба карты и действия с меткой

{zhosmmap-overview:;placemark;14;;;;bounce}

Вывод карты с объектами, фильтр по списку статей

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

{zhosmmap-overview-articlelist:ArticleList;NNN;Center;Zoom;MapType;Width;Height;Action}

где

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

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

Вывод карты с объектами, фильтр по списку категорий статей

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

{zhosmmap-overview-category:CategoryList;NNN;Center;Zoom;MapType;Width;Height;Action}

где

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

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

Ограничения

Плагин не работает в контактах, так как у контактов тип отличен от "content"

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

См. также

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

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


Language: English  • русский
Retrieved from "https://wiki.zhuk.cc/index.php?title=Zh_OpenStreetMap_Plugin_Article_Overview_Map/ru&oldid=3929"