Template:Zh GoogleMap Description Placemark: Difference between revisions

From Documentation
Jump to navigation Jump to search
 
(11 intermediate revisions by the same user not shown)
Line 54: Line 54:
|class="zhproperty"|Published||class="zhdescription"|Published
|class="zhproperty"|Published||class="zhdescription"|Published
|-
|-
|class="zhproperty"|Placemark Group||class="zhdescription"|Placemark Group
|class="zhproperty"|Group||class="zhdescription"|Group
|-
|-
|class="zhproperty"|Protected from user correction||class="zhdescription"|Protected placemark from user correction, when you activate creating users placemark
|class="zhproperty"|Protected from user correction||class="zhdescription"|Protected placemark from user correction, when you activate creating users placemark
Line 68: Line 68:
|class="zhproperty"|Show GPS information||class="zhdescription"|Show GPS information (coordinates) in infowin
|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<br />
|class="zhproperty"|Addition HTML text||class="zhdescription"|HTML text, that will be included in placemark InfoWin 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. In this way, you can copy code, that produced by plugin and paste into HTML text, and in this case plugin will not change it.
<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>
|-
|-
Line 111: Line 111:
* '''Title'''
* '''Title'''
* '''Description'''
* '''Description'''
* '''Title and Article (by iframe)'''
* '''Article (by iframe)'''
* '''None'''
* '''None'''
|-
|-
Line 133: Line 135:
|class="zhproperty"|Street View Style||class="zhdescription"|Additional Street View properties, which would be applied. This properties you can create on separate component tab
|class="zhproperty"|Street View Style||class="zhdescription"|Additional Street View properties, which would be applied. This properties you can create on separate component tab
|-
|-
|class="zhproperty"|URL Site||class="zhdescription"|Site URL to display in placemark
|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 251: Line 253:
|-
|-
|class="zhproperty"|Placemark Details for standard call||class="zhdescription"|You can override default details attributes for detail 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"|Contact which associate with placemark
|class="zhproperty"|Article||class="zhdescription"|Article which associate with placemark
|-
|-
|class="zhproperty"|Article Button in InfoWin toolbar||class="zhdescription"|Show ArticleButton in InfoWin toolbar
|class="zhproperty"|Article Button in InfoWin toolbar||class="zhdescription"|Show Article Button in InfoWin toolbar
|-
|-
|class="zhproperty"|Alternative ArticleURL||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)
|-
|class="zhproperty"|iframe tag Article CSS||class="zhdescription"|You can apply CSS style for iframe tag (when use article in infowin content)
|}
|}


Line 318: Line 336:
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.
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.


=== Placemark Grouping ===
Don't forget about [[Zh_GoogleMap_Description#CompatibilityModeRSFAnchor|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 Placemark 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 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 Placemark Group CSS - which implements the following functionality:  
The map also has a drop-down list Group CSS - which implements the following functionality:  
* the first two styles - predefined
* the first two styles - predefined
* the third - you can override it in your css-file template
* 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.
* while in three cases, just have three different names of objects, respectively, we can change the styles they like.


Line 340: Line 360:
* zhgm-menu-external
* zhgm-menu-external


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

Latest revision as of 12:21, 5 December 2019

Creating Placemark

We turn to the tab "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.

On the other hand you can use Autocomplete field above map to find your place.

Or enter text address into Autocomplete field and press Find button to find place by geocoding.


Placemark properties

Title Placemark Title
Description Description
Tags Tags
Latitude Latitude
Longitude Longitude
Address Text address of your placemark. You can load your data into this field, if you don't have lat/lng data. In this case address will be automatically geocoded and markers are displayed. And in backend marker will be shown too. But if you move marker (change position by dragging or clicking somewhere else), new positions will be stored as lat/lng.

Displaying markers by lat/lng is more quick because there is no need time for geocoding

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
Rating Rating of placemark, it can be set only by rating system
Show GPS information Show GPS information (coordinates) in infowin
Addition HTML text HTML text, that will be included in placemark InfoWin 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.

Placemark full description Placemark description (HTML text) in placemark detail view (single placemark page view)
Hover HTML text Hover HTML text for placemark when enabled hovering feature

Appearance properties

Icon Type Icon Type
Icon X-offset Icon offset
Icon Y-offset Icon offset
Marker Marker Type
  • No - Do not show marker
  • Drop - Marker with animation (Drop)
  • Bounce - Marker with animation (Bounce)
  • Simple - Marker without animation
  • Infographics Icon: Drop - Marker with animation (Drop) and dynamic icon
  • Infographics Icon: Bounce - Marker with animation (Bounce) and dynamic icon
  • Infographics Icon: Simple - Marker without animation and dynamic icon
  • Marker with label: Drop - Marker with animation (Drop) and label
  • Marker with label: Bounce - Marker with animation (Bounce) and label
  • Marker with label: Simple - Marker without animation and label
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 - link, that entered in URL Site field
  • Open Link in new page
  • Open InfoBubble
  • Open Street View - open street view for placemark position (if feature enabled in map details)
  • 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
Street View in InfoWin toolbar Enable ability in infowin show button to show Street View
View Area Width for Street View View Area Width for div section in infowin
View Area Height for Street View View Area Height for div section in infowin
Street View Style Additional Street View properties, which would be applied. This properties you can create on separate component tab
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
Infographics Type Dynamic Icon Type

Example: chst=d_fnote&chld=thought|1|0088FF|h|Why+am+I+here?
See about Infographics (Dynamic Icons)

Infographics Icon width Dynamic Icon width
Infographics Icon height Dynamic Icon height

Marker with Label

Label Class Label CSS Class
Label in background Label in background
Label X-offset Label offset
Label Y-offset Label offset
Label content HTML label content

InfoBubble Tabs

About InfoBubble you can read there InfoBubble example

It is not created by component, there is only using this code. If it works not correctly - check in example, and if there not works - you should ask in google maps forum (component only calls JavaScript code)


Style Style for InfoBubble
Add InfoWin content Add InfoWin content into InfoBubble
  • No
  • as first tab - add infowin content before all visible tabs
  • as last tab - add infowin content after all visible tabs
  • replace content - add infowin content as infobubble content, without any tab


Title Tab Title
Image You can use image to build image gallery in single placemark view
HTML Text Tab text

Integration

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)
Placemark Details for standard call 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

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

It is for you own customization. You can enter any values in this fields, and use what you want in you code. You can rename prompt in language file


For your convenience you can also change the labels of the fields in file

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

lines

COM_ZHGOOGLEMAP_MAPMARKER_DETAIL_ATTRIBUTE1_LABEL 

COM_ZHGOOGLEMAP_MAPMARKER_DETAIL_ATTRIBUTE2_LABEL 

… 

COM_ZHGOOGLEMAP_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_zhgooglemap/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

  • GMapsMenu-advanced
  • GMapsMenu-simple
  • GMapsMenu-external

for ul-tag

  • zhgm-menu-advanced
  • zhgm-menu-simple
  • zhgm-menu-external

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