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

From Documentation
Jump to navigation Jump to search
mNo edit summary
 
(32 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"|Тип метки
|-
|class="zhproperty"|Icon Type||class="zhdescription"|Иконка
|-
|class="zhproperty"|Icon X-offset||class="zhdescription"|Отступ иконки по X
|-
|-
|Map Title||Наименование карты, на которой будет выводиться метка
|class="zhproperty"|Icon Y-offset||class="zhdescription"|Отступ иконки по Y<br />
<p class="zh-text-tip">Если установить оба поля (Icon X-offset и Icon Y-offset) равными нулю, то стиль иконки формируется без указания отступов согласно значениям по умолчанию а API</p>
|-
|-
|Title||Наименование
|class="zhproperty"|Preset Standard Icon||class="zhdescription"|Предопределенная иконка в API<br />
Вы можете указать использовать иконку не из файла, а метку с определенным стилем в API
[https://tech.yandex.ru/maps/doc/jsapi/2.0/ref/reference/option.presetStorage-docpage/ См. список]
|-
|-
|Description||Примечание
|class="zhproperty"|Icon Content||class="zhdescription"|Содержимое иконки (если используются предопределенные в API иконки с поддержкой текста внутри)
|-
|-
|Published||Признак публикации, т.е. активности записи
|class="zhproperty"|Open baloon||class="zhdescription"|Сразу открыть всплывающее окно
|-
|-
|Icon Type||Иконка
|class="zhproperty"|Balloon Content||class="zhdescription"|Тип содержимого всплывающего окна
|-
|-
|Latitude||Широта
|class="zhproperty"|Action by Click||class="zhdescription"|Выполнить действие при нажатии на метке<br />
* '''None''' - ничего не выполнять
* '''Open Balloon''' - открыть всплывающее окно
* '''Open Link in new page''' - открыть ссылку на новой странице
* '''Open Link'''
|-
|-
|Longitude||Долгота
|class="zhproperty"|Zoom by Click||class="zhdescription"|Изменить масштаб при нажатии на метке<br />
* '''Do not change''' - не изменять
* '''1'''...'''17''' - новое значение масштаба
|-
|-
|Open baloon||Сразу открыть всплывающее окно
|class="zhproperty"|URL Site||class="zhdescription"|URL адрес сайта
|-
|-
|URL Site||URL адрес сайта
|class="zhproperty"|Site Name||class="zhdescription"|Наименование сайта, если хочется вместо URL видеть красивое название
|-
|-
|Site Name||Наименование сайта, если хочется вместо URL видеть красивое название
|class="zhproperty"|URL Image||class="zhdescription"|URL адрес изображения, которое можно вывести во всплывающем окне
|-
|-
|URL Image||URL адрес изображения, которое можно вывести во всплывающем окне
|class="zhproperty"|Start Publishing||class="zhdescription"|Дата начала публикации метки
|-
|-
|Placemark Group||Группа, к которой относится метка
|class="zhproperty"|Finish Publishing||class="zhdescription"|Дата окончания публикации метки
|-
|-
|Category||Категория
|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>
Компонент автоматически подхватит изображения при выборе типа метки.


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




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


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


* первые два стиля – предопределенные, и находятся в файле в папке  
* первые два стиля – предопределенные, и находятся в файле в папке  
Line 111: 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