Template:Zh YandexMap Description Placemark/ru: Difference between revisions

From Documentation
Jump to navigation Jump to search
mNo edit summary
 
(29 intermediate revisions by the same user not shown)
Line 3: Line 3:
Переходим на закладку "Placemarks"
Переходим на закладку "Placemarks"


[[File:YM-Placemark-List.JPG]]
[[File:YM-Placemark-List.png]]


Вводим необходимое количество меток с привязкой к конкретной карте. Координаты удобно выбирать путем перетаскивания метки (значения автоматически подставляются в поля формы) или кликая мышкой на необходимом месте.
Вводим необходимое количество меток с привязкой к конкретной карте. Координаты удобно выбирать путем перетаскивания метки (значения автоматически подставляются в поля формы) или кликая мышкой на необходимом месте.




=== Элементы метки ===


[[File:YM-Placemark-Detail-PlacemarkDetails.JPG]]
=== Свойства метки ===


{|
[[File:YM-Placemark-Detail-PlacemarkDetails-1.png]]
 
[[File:YM-Placemark-Detail-PlacemarkDetails-2.png]]
 
[[File:YM-Placemark-Detail-PlacemarkDetails-3.png]]
 
[[File:YM-Placemark-Detail-PlacemarkDetails-4.png]]
 
{|class="zhpropertytable"
|-
|class="zhproperty"|Title||class="zhdescription"|Наименование
|-
|class="zhproperty"|Description||class="zhdescription"|Примечание
|-
|class="zhproperty"|Addition HTML text||class="zhdescription"|Дополнительный текст в формате HTML<br />
<p class="zh-text-alert-fill">Будьте внимательны, если вы вводите email адрес, то другой плагин Joomla! его изменит, и в результате возникнет ошибка и карта не будет выведена. В этом случае вы можете скопировать код, который создался в результате работы плагина и вставить его в HTML текст, и в этом случае плагин его не поменяет.
</p>
|-
|class="zhproperty"|Published||class="zhdescription"|Признак публикации, т.е. активности записи
|-
|class="zhproperty"|Latitude||class="zhdescription"|Широта
|-
|class="zhproperty"|Longitude||class="zhdescription"|Долгота
|-
|class="zhproperty"|Map Title||class="zhdescription"|Наименование карты, на которой будет выводиться метка
|-
|class="zhproperty"|Group||class="zhdescription"|Группа, к которой относится метка
|-
|class="zhproperty"|Protected from user correction||class="zhdescription"|Запрет на изменение пользовательской метки
|-
|class="zhproperty"|Include in Placemark List||class="zhdescription"|Включать метку в список меток
|-
|class="zhproperty"|Category||class="zhdescription"|Категория
|}
 
=== Внешний вид метки ===
 
[[File:YM-Placemark-Detail-AppearanceProperties-1.png]]
 
[[File:YM-Placemark-Detail-AppearanceProperties-2.png]]
 
 
{|class="zhpropertytable"
|-
|class="zhproperty"|Marker||class="zhdescription"|Тип метки
|-
|-
|Map Title||Наименование карты, на которой будет выводиться метка
|class="zhproperty"|Icon Type||class="zhdescription"|Иконка
|-
|-
|Title||Наименование
|class="zhproperty"|Icon X-offset||class="zhdescription"|Отступ иконки по X
|-
|-
|Description||Примечание
|class="zhproperty"|Icon Y-offset||class="zhdescription"|Отступ иконки по Y<br />
<p class="zh-text-tip">Если установить оба поля (Icon X-offset и Icon Y-offset) равными нулю, то стиль иконки формируется без указания отступов согласно значениям по умолчанию а API</p>
|-
|-
|Published||Признак публикации, т.е. активности записи
|class="zhproperty"|Preset Standard Icon||class="zhdescription"|Предопределенная иконка в API<br />
Вы можете указать использовать иконку не из файла, а метку с определенным стилем в API
[https://tech.yandex.ru/maps/doc/jsapi/2.0/ref/reference/option.presetStorage-docpage/ См. список]
|-
|-
|Icon Type||Иконка
|class="zhproperty"|Icon Content||class="zhdescription"|Содержимое иконки (если используются предопределенные в API иконки с поддержкой текста внутри)
|-
|-
|Latitude||Широта
|class="zhproperty"|Open baloon||class="zhdescription"|Сразу открыть всплывающее окно
|-
|-
|Longitude||Долгота
|class="zhproperty"|Balloon Content||class="zhdescription"|Тип содержимого всплывающего окна
|-
|-
|Open baloon||Сразу открыть всплывающее окно
|class="zhproperty"|Action by Click||class="zhdescription"|Выполнить действие при нажатии на метке<br />
* '''None''' - ничего не выполнять
* '''Open Balloon''' - открыть всплывающее окно
* '''Open Link in new page''' - открыть ссылку на новой странице
* '''Open Link'''
|-
|-
|URL Site||URL адрес сайта
|class="zhproperty"|Zoom by Click||class="zhdescription"|Изменить масштаб при нажатии на метке<br />
* '''Do not change''' - не изменять
* '''1'''...'''17''' - новое значение масштаба
|-
|-
|Site Name||Наименование сайта, если хочется вместо URL видеть красивое название
|class="zhproperty"|URL Site||class="zhdescription"|URL адрес сайта
|-
|-
|URL Image||URL адрес изображения, которое можно вывести во всплывающем окне
|class="zhproperty"|Site Name||class="zhdescription"|Наименование сайта, если хочется вместо URL видеть красивое название
|-
|-
|Placemark Group||Группа, к которой относится метка
|class="zhproperty"|URL Image||class="zhdescription"|URL адрес изображения, которое можно вывести во всплывающем окне
|-
|-
|Category||Категория
|class="zhproperty"|Start Publishing||class="zhdescription"|Дата начала публикации метки
|-
|class="zhproperty"|Finish Publishing||class="zhdescription"|Дата окончания публикации метки
|-
|class="zhproperty"|Access||class="zhdescription"|ACL уровень доступа к метки
|}
|}


=== Интеграция ===
[[File:YM-Placemark-Detail-Integration.png]]
{|class="zhpropertytable"
|-
|class="zhproperty"|Contact||class="zhdescription"|Контакт, ассоциированный с меткой
|-
|class="zhproperty"|Show contact||class="zhdescription"|Тип представления контактной информации<br />
* '''No'''
* '''Text'''
* '''Icon'''
* '''No prompts'''
|-
|class="zhproperty"|User||class="zhdescription"|Пользователь, ассоциированный с меткой
|-
|class="zhproperty"|Show user||class="zhdescription"|Тип представления контактной информации<br />
* '''No'''
* '''Text'''
* '''Icon'''
* '''No prompts'''
|}


=== Дополнительные поля для пользовательской кастомизации ===
=== Дополнительные поля для пользовательской кастомизации ===


[[File:YM-Placemark-Detail-HiddenFields.JPG]]
Если Вам дополнительно нужны поля, которые хотите заполнять через интерфейс, а затем их использовать в своих скриптах, то в разделе дополнительных полей для пользовательской кастомизации Вы можете определить в какое поле будет записываться нужная вам информация.
 
 
[[File:YM-Placemark-Detail-HiddenFields-1.png]]
 
[[File:YM-Placemark-Detail-HiddenFields-2.png]]


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


Эти поля никак не обрабатываются, соответственно, Вы можете использовать их на свое усмотрение.
Эти поля никак не обрабатываются, соответственно, Вы можете использовать их на свое усмотрение.


Это позволяет пользователю вводить какую-то дополнительную информацию по метке в одном месте со всей остальной информацией, и, при дополнительной правки вывода основной информации, настроить компонент (плагин) для вывода этой (дополнительной) информации.
Это позволяет пользователю вводить какую-то дополнительную информацию по метке в одном месте со всей остальной информацией, и при дополнительном исправлении вывода основной информации, настроить компонент (плагин) для вывода этой (дополнительной) информации.




Line 58: Line 140:
/administrator/language/en-GB/en-GB.com_zhyandexmap.ini  
/administrator/language/en-GB/en-GB.com_zhyandexmap.ini  
</code>
</code>
для английского варианта административной панели, или для русского
<code>
/administrator/language/ru-RU/ru-RU.com_zhyandexmap.ini
</code>


строки
строки
Line 68: Line 157:


COM_ZHYANDEXMAP_MAPMARKER_DETAIL_ATTRIBUTE9_LABEL
COM_ZHYANDEXMAP_MAPMARKER_DETAIL_ATTRIBUTE9_LABEL


=== Кастомизация меток ===
=== Кастомизация меток ===
Line 76: Line 163:


<code>
<code>
/administrator/components/com_zhyandexmap/assets/icons/
/administrator/components/com_zhyandexmap/assets/icons/
</code>
</code>


Line 85: Line 172:




== Группировка меток ==
=== Группировка меток ===


Метка может входить в одну из групп, для этого на метке указываете принадлежность к группе. Если на карте установлен признак использования группировки меток (значение поля Placemark Control отлично от No), то начинает работать дополнительная функциональность: появляется список активных групп (местоположение определяется этим же полем, причем первые четыре (left, top, right, bottom) соответствуют табличной форме представления, а два последний (Group-Map, Map-Group) – строится на div, и у Вас есть возможность делать с ними что угодно :)На карте также есть выпадающий список Placemark Group CSS – который реализует следующую функциональность:
Метка может входить в одну из групп, для этого на метке указываете принадлежность к группе.  
 
Если на карте установлен признак использования группировки меток (значение поля Placemark Control отлично от No), то начинает работать дополнительная функциональность: появляется список активных групп (местоположение определяется этим же полем, причем первые четыре (left, top, right, bottom) соответствуют табличной форме представления, а два последний (Group-Map, Map-Group) – строится на div, и у Вас есть возможность делать с ними что угодно.
 
На карте также есть выпадающий список Group CSS – который реализует следующую функциональность:


* первые два стиля – предопределенные, и находятся в файле в папке  
* первые два стиля – предопределенные, и находятся в файле в папке  
Line 113: Line 204:
Соответственно, стили прописываем для них.
Соответственно, стили прописываем для них.


Поле Show Placemark Group Icon используется для отображения иконки группы в списке групп.
Поле Show Group Icon на закладке "Maps" используется для отображения иконки группы в списке групп.
 
=== Display ===
 
[[File:YM-Placemark-Detail-Display.png]]

Latest revision as of 11:53, 10 October 2019

Создание меток

Переходим на закладку "Placemarks"

Вводим необходимое количество меток с привязкой к конкретной карте. Координаты удобно выбирать путем перетаскивания метки (значения автоматически подставляются в поля формы) или кликая мышкой на необходимом месте.


Свойства метки

Title Наименование
Description Примечание
Addition HTML text Дополнительный текст в формате HTML

Будьте внимательны, если вы вводите email адрес, то другой плагин Joomla! его изменит, и в результате возникнет ошибка и карта не будет выведена. В этом случае вы можете скопировать код, который создался в результате работы плагина и вставить его в HTML текст, и в этом случае плагин его не поменяет.

Published Признак публикации, т.е. активности записи
Latitude Широта
Longitude Долгота
Map Title Наименование карты, на которой будет выводиться метка
Group Группа, к которой относится метка
Protected from user correction Запрет на изменение пользовательской метки
Include in Placemark List Включать метку в список меток
Category Категория

Внешний вид метки


Marker Тип метки
Icon Type Иконка
Icon X-offset Отступ иконки по X
Icon Y-offset Отступ иконки по Y

Если установить оба поля (Icon X-offset и Icon Y-offset) равными нулю, то стиль иконки формируется без указания отступов согласно значениям по умолчанию а API

Preset Standard Icon Предопределенная иконка в API

Вы можете указать использовать иконку не из файла, а метку с определенным стилем в API См. список

Icon Content Содержимое иконки (если используются предопределенные в API иконки с поддержкой текста внутри)
Open baloon Сразу открыть всплывающее окно
Balloon Content Тип содержимого всплывающего окна
Action by Click Выполнить действие при нажатии на метке
  • None - ничего не выполнять
  • Open Balloon - открыть всплывающее окно
  • Open Link in new page - открыть ссылку на новой странице
  • Open Link
Zoom by Click Изменить масштаб при нажатии на метке
  • Do not change - не изменять
  • 1...17 - новое значение масштаба
URL Site URL адрес сайта
Site Name Наименование сайта, если хочется вместо URL видеть красивое название
URL Image URL адрес изображения, которое можно вывести во всплывающем окне
Start Publishing Дата начала публикации метки
Finish Publishing Дата окончания публикации метки
Access ACL уровень доступа к метки

Интеграция

Contact Контакт, ассоциированный с меткой
Show contact Тип представления контактной информации
  • No
  • Text
  • Icon
  • No prompts
User Пользователь, ассоциированный с меткой
Show user Тип представления контактной информации
  • No
  • Text
  • Icon
  • No prompts

Дополнительные поля для пользовательской кастомизации

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



Эти поля никак не обрабатываются, соответственно, Вы можете использовать их на свое усмотрение.

Это позволяет пользователю вводить какую-то дополнительную информацию по метке в одном месте со всей остальной информацией, и при дополнительном исправлении вывода основной информации, настроить компонент (плагин) для вывода этой (дополнительной) информации.


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

/administrator/language/en-GB/en-GB.com_zhyandexmap.ini

для английского варианта административной панели, или для русского

/administrator/language/ru-RU/ru-RU.com_zhyandexmap.ini


строки

COM_ZHYANDEXMAP_MAPMARKER_DETAIL_ATTRIBUTE1_LABEL

COM_ZHYANDEXMAP_MAPMARKER_DETAIL_ATTRIBUTE2_LABEL

...

COM_ZHYANDEXMAP_MAPMARKER_DETAIL_ATTRIBUTE9_LABEL

Кастомизация меток

Скопируйте свои изображения меток (в формате PNG) в каталог

/administrator/components/com_zhyandexmap/assets/icons/

Компонент автоматически подхватит изображения при выборе типа метки.

Единственное требование – чтобы расширение файла было .png т.е. в нижнем регистре, т.к. наименования изображений хранятся в БД без расширения, и оно дописывается при выводе.


Группировка меток

Метка может входить в одну из групп, для этого на метке указываете принадлежность к группе.

Если на карте установлен признак использования группировки меток (значение поля Placemark Control отлично от No), то начинает работать дополнительная функциональность: появляется список активных групп (местоположение определяется этим же полем, причем первые четыре (left, top, right, bottom) соответствуют табличной форме представления, а два последний (Group-Map, Map-Group) – строится на div, и у Вас есть возможность делать с ними что угодно.

На карте также есть выпадающий список Group CSS – который реализует следующую функциональность:

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

/administrator/components/com_zhyandexmap/assets/css/markergroups.css

  • третий – Вы его можете переопределить в своем css-файле шаблона


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

Наименования следующие

для div-тега идентификатор принимает значения

  • YMapsMenu-advanced
  • YMapsMenu-simple
  • YMapsMenu-external

для ul-тега

  • zhym-menu-advanced
  • zhym-menu-simple
  • zhym-menu-external


Соответственно, стили прописываем для них.

Поле Show Group Icon на закладке "Maps" используется для отображения иконки группы в списке групп.

Display