Template:Zh BaiduMap Description Placemark: Difference between revisions

From Documentation
Jump to navigation Jump to search
 
(8 intermediate revisions by the same user not shown)
Line 39: Line 39:
[[File:BDM-Placemark-Detail-PlacemarkDetails-2.png]]
[[File:BDM-Placemark-Detail-PlacemarkDetails-2.png]]


[[File:BDM-Placemark-Detail-PlacemarkDetails-3.png]]
[[File:BDM-Placemark-Detail-PlacemarkDetails-4.png]]


{|class="zhpropertytable"
{|class="zhpropertytable"
Line 58: Line 53:
|-
|-
|class="zhproperty"|User ordering index||class="zhdescription"|Use this field to manual sorting placemarks in placemark list
|class="zhproperty"|User ordering index||class="zhdescription"|Use this field to manual sorting placemarks in placemark list
|-
|class="zhproperty"|Rating||class="zhdescription"|Rating of placemark, it can be set only by rating system
|-
|class="zhproperty"|Show GPS information||class="zhdescription"|Show GPS information (coordinates) in infowin
|-
|-
|class="zhproperty"|Addition HTML text||class="zhdescription"|HTML text, that will be included in placemark popup content<br />
|class="zhproperty"|Addition HTML text||class="zhdescription"|HTML text, that will be included in placemark popup content<br />
<p class="zh-text-alert-fill">Be careful, if you enter email address, the other Joomla! plugin it changed, and there will be an error and map will not be shown.
<p class="zh-text-alert-fill">Be careful, if you enter email address, the other Joomla! plugin it changed, and there will be an error and map will not be shown.
</p>
</p>
|-
|class="zhproperty"|Placemark full description||class="zhdescription"|Placemark description (HTML text) in placemark detail view (single placemark page view)
|-
|class="zhproperty"|Hover HTML text||class="zhdescription"|Hover HTML text for placemark when enabled hovering feature
|}
|}


Line 84: Line 71:
* '''No''' - Do not show marker
* '''No''' - Do not show marker
* '''Simple''' - Marker without animation  
* '''Simple''' - Marker without animation  
* '''Simple: Bounce''' - Marker with animation (Bounce)
* '''Bounce''' - Marker with animation (Bounce)
* '''Simple: Elastic Bounce''' - Marker with animation (Elastic Bounce)
* '''Drop''' - Marker with animation (Drop)
* '''Icon File: Simple''' - Marker without animation
* '''Icon File: Bounce''' - Marker with animation (Bounce)
* '''Icon File: Elastic Bounce''' - Marker with animation (Elastic Bounce)
* '''Marker with label: Simple''' - Marker without animation and label
* '''Marker with label: Simple''' - Marker without animation and label
* '''Marker with label: Bounce''' - Marker with animation (Bounce) and label
* '''Marker with label: Bounce''' - Marker with animation (Bounce) and label
* '''Marker with label: Elastic Bounce''' - Marker with animation (Elastic Bounce)
* '''Marker with label: Drop''' - Marker with animation (Drop) and label
 
|-
|-
|class="zhproperty"|Icon Type||class="zhdescription"|Icon Type
|class="zhproperty"|Icon Type||class="zhdescription"|Icon Type
Line 99: Line 84:
|class="zhproperty"|Icon Y-offset||class="zhdescription"|Icon offset
|class="zhproperty"|Icon Y-offset||class="zhdescription"|Icon offset
|-
|-
|class="zhproperty"|Open Popup||class="zhdescription"|Execute action which described in '''Action by Click''' and '''Zoom by Click'''
|class="zhproperty"|Open InfoWin||class="zhdescription"|Execute action which described in '''Action by Click''' and '''Zoom by Click'''
|-
|-
|class="zhproperty"|Popup Content||class="zhdescription"|Content of Popup<br />
|class="zhproperty"|InfoWin Content||class="zhdescription"|Content of InfoWin<br />
* '''Title and Description'''
* '''Title and Description'''
* '''Title'''
* '''Title'''
Line 110: Line 95:
|-
|-
|class="zhproperty"|Action by Click||class="zhdescription"|Action by Click on this placemark<br />
|class="zhproperty"|Action by Click||class="zhdescription"|Action by Click on this placemark<br />
* '''Open Popup'''
* '''Open InfoWin'''
* '''Open Link in the same page''' - link, that entered in URL Site field
* '''Open Link in the same page''' - link, that entered in URL Site field
* '''Open Link in new page'''
* '''Open Link in new page'''
* '''Open Popup with Tabs'''
* '''Open Contact in the same page'''
* '''Open Contact in new page'''
* '''Open Article in the same page'''
* '''Open Article in new page'''
* '''Open Details in the same page'''
* '''Open Details in new page'''
* '''None'''
* '''None'''
|-
|-
Line 126: Line 104:
* '''Do not change''' - zoom is not changed
* '''Do not change''' - zoom is not changed
|-
|-
|class="zhproperty"|URL Site||class="zhdescription"|Site URL to display in placemark popup content
|class="zhproperty"|URL Site||class="zhdescription"|Site URL to display in placemark InfoWin content
|-
|-
|class="zhproperty"|Site Name||class="zhdescription"|Site Name to display instead of URL
|class="zhproperty"|Site Name||class="zhdescription"|Site Name to display instead of URL
Line 149: Line 127:


[[File:BDM-Placemark-Detail-MarkerWithLabel-2.png]]
[[File:BDM-Placemark-Detail-MarkerWithLabel-2.png]]
[[File:BDM-Placemark-Detail-MarkerWithLabel-3.png]]




Line 161: Line 142:
|class="zhproperty"|Label Style||class="zhdescription"|Label CSS style. Note: If the attribute name of css contains a hyphen, the hyphen should be removed and capitalized.<br />For example, the <b>background color</b> property should be written as <b>backgroundColor</b>
|class="zhproperty"|Label Style||class="zhdescription"|Label CSS style. Note: If the attribute name of css contains a hyphen, the hyphen should be removed and capitalized.<br />For example, the <b>background color</b> property should be written as <b>backgroundColor</b>
|}
|}


=== Integration ===
=== Integration ===
Line 175: Line 155:
{|class="zhpropertytable"
{|class="zhpropertytable"
|-
|-
|class="zhproperty"|Prepare Content||class="zhdescription"|Run other plugins for popup content
|class="zhproperty"|Prepare Content||class="zhdescription"|Run other plugins for InfoWin content
|-
|-
|class="zhproperty"|Show open Google Maps||class="zhdescription"|Show link or toolbar button, which opens Google Maps
|class="zhproperty"|Show Tags||class="zhdescription"|Show tags in InfoWin content
* '''No'''
* '''Button (show direction), open link in new page'''
* '''Button (show direction), open link in the same page'''
* '''Link (show direction), open link in new page'''
* '''Link (show direction), open link in the same page'''
* '''Button (show marker for title), open link in new page'''
* '''Button (show marker for title), open link in the same page'''
* '''Link (show marker for title), open link in new page'''
* '''Link (show marker for title), open link in the same page'''
* '''Button (show marker for coordinates), open link in new page'''
* '''Button (show marker for coordinates), open link in the same page'''
* '''Link (show marker for coordinates), open link in new page'''
* '''Link (show marker for coordinates), open link in the same page'''
|-
|class="zhproperty"|Show Tags||class="zhdescription"|Show tags in popup content
* '''No'''
* '''No'''
* '''Placemark'''
* '''Placemark'''
Line 218: Line 183:
* '''No prompts'''
* '''No prompts'''
|-
|-
|class="zhproperty"|Contact Button in Popup toolbar||class="zhdescription"|Show Contact Button in Popup toolbar
|class="zhproperty"|Contact Button in InfoWin toolbar||class="zhdescription"|Show Contact Button in InfoWin toolbar
|-
|-
|class="zhproperty"|Alternative Contact URL||class="zhdescription"|You can alternative URL to show contact page (instead of standard joomla's call)
|class="zhproperty"|Alternative Contact URL||class="zhdescription"|You can alternative URL to show contact page (instead of standard joomla's call)
|-
|-
|class="zhproperty"|Placemark details Button in Popup toolbar||class="zhdescription"|Show Placemark Button in Popup toolbar
|class="zhproperty"|Placemark details Button in InfoWin toolbar||class="zhdescription"|Show Placemark Button in InfoWin toolbar
|-
|-
|class="zhproperty"|Alternative Details URL||class="zhdescription"|You can alternative URL to show details page (instead of standard call detail placemark view)
|class="zhproperty"|Alternative Details URL||class="zhdescription"|You can alternative URL to show details page (instead of standard call detail placemark view)
|-
|class="zhproperty"|Placemark Details for standard call||class="zhdescription"|You can override default details attributes for detail view
By default placemark detail page is opened without enabling additional loading bootstrap library and styles, without thumbnail and image gallery, without Additional HTML text and full text description.
You can change default behavior by passing parameters, separated by comma (,)
* '''load bootstrap'''
* '''load bootstrap styles'''
* '''thumbnail'''
* '''image gallery'''
* '''addition html text'''
* '''full description'''
For example, if you enter '''image gallery,addition html text,full description''' into field, the detail view for placemark will be with two additional description (short "Addition HTML text" and full "Placemark full description"), and image gallery will be displayed too
|-
|-
|class="zhproperty"|Article||class="zhdescription"|Article which associate with placemark
|class="zhproperty"|Article||class="zhdescription"|Article which associate with placemark
|-
|-
|class="zhproperty"|Article Button in Popup toolbar||class="zhdescription"|Show Article Button in Popup toolbar
|class="zhproperty"|Article Button in InfoWin toolbar||class="zhdescription"|Show Article Button in InfoWin toolbar
|-
|-
|class="zhproperty"|Alternative Article URL||class="zhdescription"|You can alternative URL to show article page (instead of standard joomla's call)
|class="zhproperty"|Alternative Article URL||class="zhdescription"|You can alternative URL to show article page (instead of standard joomla's call)

Latest revision as of 14:19, 19 December 2019

Creating Placemark

We turn to the menu "Placemarks".


Enter the number of markers bound to a specific map.

Coordinates it is convenient to choose by dragging the marker (the value is automatically substituted in the form fields ) or by clicking the mouse on the desired location.


Placemark properties

Title Placemark Title
Description Description
Tags Tags
Latitude Latitude
Longitude Longitude
Address Text address of your placemark
Map Title Title of the map, where marker would be displayed

Placemark Details



Published Published
Group Group
Protected from user correction Protected placemark from user correction, when you activate creating users placemark
Include in Placemark List Include placemark in Placemark List
Category The category that this placemark is assigned to
User ordering index Use this field to manual sorting placemarks in placemark list
Addition HTML text HTML text, that will be included in placemark popup content

Be careful, if you enter email address, the other Joomla! plugin it changed, and there will be an error and map will not be shown.

Appearance properties


Marker Marker Type
  • No - Do not show marker
  • Simple - Marker without animation
  • Bounce - Marker with animation (Bounce)
  • Drop - Marker with animation (Drop)
  • Marker with label: Simple - Marker without animation and label
  • Marker with label: Bounce - Marker with animation (Bounce) and label
  • Marker with label: Drop - Marker with animation (Drop) and label
Icon Type Icon Type
Icon X-offset Icon offset
Icon Y-offset Icon offset
Open InfoWin Execute action which described in Action by Click and Zoom by Click
InfoWin Content Content of InfoWin
  • Title and Description
  • Title
  • Description
  • Title and Article (by iframe)
  • Article (by iframe)
  • None
Action by Click Action by Click on this placemark
  • Open InfoWin
  • Open Link in the same page - link, that entered in URL Site field
  • Open Link in new page
  • None
Zoom by Click Zoom by Click on this placemark

You can change zoom when you click on marker

  • Do not change - zoom is not changed
URL Site Site URL to display in placemark InfoWin content
Site Name Site Name to display instead of URL
URL Image Image URL to display in placemark
URL Image Thumbnail Image URL to display in placemark list
Start Publishing Placemark start publishing date
Finish Publishing Placemark finish publishing date
Date of creation Placemark creation date
Access ACL access level to view this placemark

Marker with Label




Label X-offset Label offset
Label Y-offset Label offset
Label content HTML label content
Label Style Label CSS style. Note: If the attribute name of css contains a hyphen, the hyphen should be removed and capitalized.
For example, the background color property should be written as backgroundColor

Integration



Prepare Content Run other plugins for InfoWin content
Show Tags Show tags in InfoWin content
  • No
  • Placemark
  • Contact
Tag Style User which associate with placemark
  • Simple
  • Advanced
  • External
User User which associate with placemark
Show user prompts Type of view user information
  • No
  • Text
  • Icon
  • No prompts
Contact Contact which associate with placemark
Show contact prompts Type of view contact information
  • No
  • Text
  • Icon
  • No prompts
Contact Button in InfoWin toolbar Show Contact Button in InfoWin toolbar
Alternative Contact URL You can alternative URL to show contact page (instead of standard joomla's call)
Placemark details Button in InfoWin toolbar Show Placemark Button in InfoWin toolbar
Alternative Details URL You can alternative URL to show details page (instead of standard call detail placemark view)
Article Article which associate with placemark
Article Button in InfoWin toolbar Show Article Button in InfoWin toolbar
Alternative Article URL You can alternative URL to show article page (instead of standard joomla's call)
iframe tag Article CSS You can apply CSS style for iframe tag (when use article in infowin content)

Hidden Attributes for Customization



For your convenience you can also change the labels of the fields by joomla overrides


COM_ZHBAIDUMAP_MAPMARKER_DETAIL_ATTRIBUTE1_LABEL 

COM_ZHBAIDUMAP_MAPMARKER_DETAIL_ATTRIBUTE2_LABEL 

… 

COM_ZHBAIDUMAP_MAPMARKER_DETAIL_ATTRIBUTE9_LABEL

For example, you can enter some data into this fields.

In table columns have names

attribute1

attribute2
...

attribute9


You can use this fields, for example, for integration with other systems or etc.

Display

Placemark Customization

Copy your marker images (format PNG) in the directory

/administrator/components/com_zhbaidumap/assets/icons/

Component will automatically pick up the picture when choosing the type of marker.

The only requirement - the file name use English letters and can't contain any special character; the file extension have to be a .png ie in lower case, because names of images stored in a database without the extension, and it is appended in the output.

Don't forget about Compatibility Mode for Resource Files

Grouping

The marker may be included in one group, for this to specify a marker belonging to the group. If the field of markers grouping is set (field value Group Control is different from No), then starts an additional feature: a list of active groups (the location is determined by this same field, with the first four (left, top, right, bottom) correspond to the table form of representation, while the two latter (Group-Map, Map-Group) - based on the div, and you have the opportunity to do anything with them.

The map also has a drop-down list Group CSS - which implements the following functionality:

  • the first two styles - predefined
  • the third - you can override it in your CSS file template
  • while in three cases, just have three different names of objects, respectively, we can change the styles they like.


The following names

for the div-tag ID takes the value

  • BDMapsMenu-advanced
  • BDMapsMenu-simple
  • BDMapsMenu-external

for ul-tag

  • zhbdm-menu-advanced
  • zhbdm-menu-simple
  • zhbdm-menu-external

Accordingly, styles, prescribes for them. Field Show Group Icon is used to display icons in the list of groups.