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

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" используется для отображения иконки группы в списке групп.

@@ Line 3: / Line 3: @@
 Переходим на закладку "Placemarks"
-[[File:YM-Placemark-List.JPG]]
+[[File:YM-Placemark-List.png]]
 Вводим необходимое количество меток с привязкой к конкретной карте. Координаты удобно выбирать путем перетаскивания метки (значения автоматически подставляются в поля формы) или кликая мышкой на необходимом месте.
@@ Line 11: / Line 11: @@
 === Свойства метки ===
-[[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"
@@ Line 19: / Line 25: @@
 |class="zhproperty"|Description||class="zhdescription"|Примечание
 |-
-|class="zhproperty"|Addition HTML text||class="zhdescription"|Дополнительный текст в формате HTML
+|class="zhproperty"|Addition HTML text||class="zhdescription"|Дополнительный текст в формате HTML<br />
+<p class="zh-text-alert-fill">Будьте внимательны, если вы вводите email адрес, то другой плагин Joomla! его изменит, и в результате возникнет ошибка и карта не будет выведена. В этом случае вы можете скопировать код, который создался в результате работы плагина и вставить его в HTML текст, и в этом случае плагин его не поменяет.
+</p>
 |-
 |class="zhproperty"|Published||class="zhdescription"|Признак публикации, т.е. активности записи
@@ Line 28: / Line 36: @@
 |-
 |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
+|-
+|class="zhproperty"|Icon Y-offset||class="zhdescription"|Отступ иконки по Y<br />
+<p class="zh-text-tip">Если установить оба поля (Icon X-offset и Icon Y-offset) равными нулю, то стиль иконки формируется без указания отступов согласно значениям по умолчанию а API</p>
+|-
+|class="zhproperty"|Preset Standard Icon||class="zhdescription"|Предопределенная иконка в API<br />
+Вы можете указать использовать иконку не из файла, а метку с определенным стилем в API
+[https://tech.yandex.ru/maps/doc/jsapi/2.0/ref/reference/option.presetStorage-docpage/ См. список]
+|-
+|class="zhproperty"|Icon Content||class="zhdescription"|Содержимое иконки (если используются предопределенные в API иконки с поддержкой текста внутри)
 |-
 |class="zhproperty"|Open baloon||class="zhdescription"|Сразу открыть всплывающее окно
@@ Line 35: / Line 74: @@
 |class="zhproperty"|Balloon Content||class="zhdescription"|Тип содержимого всплывающего окна
 |-
-|class="zhproperty"|Show Icon with Text||class="zhdescription"|Показать метку как иконку с текстом
+|class="zhproperty"|Action by Click||class="zhdescription"|Выполнить действие при нажатии на метке<br />
+* '''None''' - ничего не выполнять
+* '''Open Balloon''' - открыть всплывающее окно
+* '''Open Link in new page''' - открыть ссылку на новой странице
+* '''Open Link'''
+|-
+|class="zhproperty"|Zoom by Click||class="zhdescription"|Изменить масштаб при нажатии на метке<br />
+* '''Do not change''' - не изменять
+* '''1'''...'''17''' - новое значение масштаба
 |-
 |class="zhproperty"|URL Site||class="zhdescription"|URL адрес сайта
@@ Line 43: / Line 90: @@
 |class="zhproperty"|URL Image||class="zhdescription"|URL адрес изображения, которое можно вывести во всплывающем окне
 |-
-|class="zhproperty"|Placemark Group||class="zhdescription"|Группа, к которой относится метка
+|class="zhproperty"|Start Publishing||class="zhdescription"|Дата начала публикации метки
 |-
-|class="zhproperty"|Category||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'''
+|}
 === Дополнительные поля для пользовательской кастомизации ===
@@ Line 55: / Line 125: @@
-[[File:YM-Placemark-Detail-HiddenFields.JPG]]
+[[File:YM-Placemark-Detail-HiddenFields-1.png]]
+[[File:YM-Placemark-Detail-HiddenFields-2.png]]
 Эти поля никак не обрабатываются, соответственно, Вы можете использовать их на свое усмотрение.
@@ Line 68: / Line 141: @@
 </code>
-или
+для английского варианта административной панели, или для русского
 <code>
@@ Line 84: / Line 157: @@
 COM_ZHYANDEXMAP_MAPMARKER_DETAIL_ATTRIBUTE9_LABEL
 === Кастомизация меток ===
@@ Line 101: / Line 172: @@
-== Группировка меток ==
+=== Группировка меток ===
 Метка может входить в одну из групп, для этого на метке указываете принадлежность к группе.
@@ Line 107: / Line 178: @@
 Если на карте установлен признак использования группировки меток (значение поля Placemark Control отлично от No), то начинает работать дополнительная функциональность: появляется список активных групп (местоположение определяется этим же полем, причем первые четыре (left, top, right, bottom) соответствуют табличной форме представления, а два последний (Group-Map, Map-Group) – строится на div, и у Вас есть возможность делать с ними что угодно.
-На карте также есть выпадающий список Placemark Group CSS – который реализует следующую функциональность:
+На карте также есть выпадающий список Group CSS – который реализует следующую функциональность:
 * первые два стиля – предопределенные, и находятся в файле в папке
@@ Line 133: / Line 204: @@
 Соответственно, стили прописываем для них.
-Поле Show Placemark Group Icon на закладке "Maps" используется для отображения иконки группы в списке групп.
+Поле Show Group Icon на закладке "Maps" используется для отображения иконки группы в списке групп.
+=== Display ===
+[[File:YM-Placemark-Detail-Display.png]]