Zh GoogleMap Plugin: Difference between revisions

From Documentation
Jump to navigation Jump to search
Line 118: Line 118:
You can show the map with markers from different maps by marker category. To do this, insert the following call  
You can show the map with markers from different maps by marker category. To do this, insert the following call  
<pre>
<pre>
{zhgooglemap-category:NNN;MMM;Zoom;MapType;Width;Height}
{zhgooglemap-category:NNN;MMM;Zoom;MapType;Width;Height;Center}
</pre>
</pre>
where  
where  
Line 139: Line 139:
** height value in pixels
** height value in pixels
** '''do not change''' - do not change map height
** '''do not change''' - do not change map height
* Center - set center of map
** placemark ID for center map by it
** '''do not change''' - do not change map center


<p class="text-alert">
<p class="text-alert">
When you show map by category, all objects on map (placemarks, routes, paths) is filtered by this category.
When you show map by category, all objects on map (placemarks, routes, paths) is filtered by this category.
</p>
</p>


=== Show Map in Lightbox ===
=== Show Map in Lightbox ===

Revision as of 13:12, 17 January 2012

Purpose

Plugin for component is created for inserting maps into articles.

Moreover, since it is a plugin for the content (type is content), then you can insert code to call in the Custom HTML module and display the map as a module. It is recommended to put width=0 (which corresponds to the width: 100%), in order to map automatically fills the width of the module, and is resized (eg, a variable template size) and did not occur map oversizing.


Installation

Install the plugin in Extension Manager. Make it active.


Using

Show Map

To show the map in an article, insert the following code

{zhgooglemap:MMM}

where

  • MMM - (required) map ID. It is displayed in a map list.


Show Map by Placemark

Also, you can show the map with only one specific marker. To do this, insert the following call

{zhgooglemap-marker:NNN;Center;Zoom;MapType;Width;Height}

where

  • NNN - (required) placemark ID
  • Center - map center or placemark is new center of map, valid values:
    • map
    • placemark
  • Zoom - new zoom of map, valid values
    • values from 0 to 18 to override zoom
    • do not change - do not change map zoom
  • MapType - new map type
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • do not change - do not change map type
  • Width - new map width
    • width value in pixels
    • do not change - do not change map width
  • Height - new map height
    • height value in pixels
    • do not change - do not change map height



Example 1:
{zhgooglemap-marker:5;placemark;10}


Example 2:
{zhgooglemap-marker:1;map;do not change}


Example 3:
{zhgooglemap-marker:4}
In this case

  • Center by default set to map
  • Zoom by default is set to do not change



Example 4:
{zhgooglemap-marker:1;;15}
In this case

  • Center by default set to map
  • Zoom is set 15

Show map by Placemark Group

To show the map with markers from different maps with markers, which have a definite group) by the following call

{zhgooglemap-group:NNN;MMM;Zoom;MapType;Width;Height}

where

  • NNN - (required) marker group ID
  • MMM - (required) map ID
  • Zoom - new zoom of map, valid values
    • values from 0 to 18 to override zoom
    • do not change - do not change map zoom
  • MapType - new map type
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • do not change - do not change map type
  • Width - new map width
    • width value in pixels
    • do not change - do not change map width
  • Height - new map height
    • height value in pixels
    • do not change - do not change map height


Show Map by Category

You can show the map with markers from different maps by marker category. To do this, insert the following call

{zhgooglemap-category:NNN;MMM;Zoom;MapType;Width;Height;Center}

where

  • NNN - (required) marker category ID
  • MMM - (required) map ID
  • Zoom - new zoom of map, valid values
    • values from 0 to 18 to override zoom
    • do not change - do not change map zoom
  • MapType - new map type
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • do not change - do not change map type
  • Width - new map width
    • width value in pixels
    • do not change - do not change map width
  • Height - new map height
    • height value in pixels
    • do not change - do not change map height
  • Center - set center of map
    • placemark ID for center map by it
    • do not change - do not change map center


When you show map by category, all objects on map (placemarks, routes, paths) is filtered by this category.

Show Map in Lightbox

To show the map in lightbox, insert the following code

{zhgooglemap-lightbox:MMM;Title;Width;Height;Image}

where

  • MMM – (required) map id
  • Title – title on link
  • Width – width of lightbox-window
  • Height – height of lightbox-window.
  • Image - filename of image, which can be displayed.

Images you have to store in component asset folder, and specify only filename and extension

administrator/components/com_zhgooglemap/assets/lightbox/

It is restriction to use some symbols. You must not use in title this symbols
< > / \


Map is displaying as component, not as plugin. I.e. the plugin calls the component. There is one specialty. CSS from template not loaded.



Example 1:

{zhgooglemap-lightbox:2;;800;500;ZhukLogo.png}

  • In this case link title is not displayed, just only image.


If you don't set title and image - there is default text is displayed as title.

Restrictions

Plugin does not work in contacts, because of a contact has type, that differs from "content"
But you have opportunity write article like contact page, as you like, and include map

It is plugin for component, therefore component have to be installed

See also

Detail component description


Language: [[::Zh GoogleMap Plugin|English]]  • [[::Zh GoogleMap Plugin/ru|русский]]