Presentation

Insert Gmap maps in your blog
This plugin allows you to create and edit a new type of posts, the map elements. These elements will be used to insert maps in your posts or in any of your theme's template files.
Attach a map to a post
To insert a map in a post, you must create first the elements that will be included in it.
Once your elements created, go to the post editing page. Under the field Personal notes, unfold the zone Google Map:, and click on Add a map.. The map is added to your post. Then click on Add elements to compoose your map.

Configuration

Activation
Plugin must be activated to work on the blog. Desactivation does not delete maps or maps elements, but merely stops their display.
API key
Plugin uses by default a shared Google Maps API key. It is recommended to replace this key by your own domain's key. You will need to creat a key on this page: Google Developers Console > Google Maps JavaScript API. Once generated, paste you key into the field and save.
Default options for maps
Click on the marker and drag or search for an address to set default map center. Zoom and map style will also be saved. These options will be used when creating a new map.

Maps styles

You may style your maps by adding configuration files from your media manager.

Styles path
Name and content of style files

You may get lots of styles from Snazzy Maps.

Personal icons and kml files

Custom icons
You may choose the icon for a point of interest by cliking on it. Only a few default icons are included, but it is very easy to add your own:
Custom Kml files
You may use any valid URL to include a Kml file. However, you may also use kml files from your media manager. It is very easy to add them:

Map element types

All elements are editable, see help in element editing page.

Point of interest
Only one marker is on the map. It will be displayed with a title attribute containing element title. On the public side, a click on the marker will display this element's content in the infowindow. On this page, a clic allows to change the element icon.
Polyline
Several markers are on the map to form a polyline. The polyline will be displayed on the map. On the public side, a click on the line will display this element's content in the infowindow. On this page, a clic allows to change the element diplay options.
Polygon
Several markers are on the map to form a polygon. The polygon will be displayed on the map. On the public side, a click on the polygon will display this element's content in the infowindow. On this page, a clic allows to change the element diplay options.
Rectangle
A rectangle is displayed on the map. On the public side, a click on the rectangle will display this element's content in the infowindow. On this page, a clic allows to change the element diplay options.
Circle
A circle is displayed on the map. On the public side, a click on the circle will display this element's content in the infowindow. On this page, a clic allows to change the element diplay options.
Included kml file
Map displays objects from a kml file. They are not editable. This type of element cannot have a description.
GeoRSS feed
Map displays objects from a GeoRSS feed. They are not editable. This type of element cannot have a description.
Directions
Map displays a route between two points, and a side panel with driving directions. You may use only one directions element on the same map.

Filters for the map elements list

Author
Allows you to filter by author.
Category
Filter by category.
Status
  • Pending: elements whose publication status has not yet been decided.
  • Scheduled: elements will be online at day and hour specified in the field Published on.
  • Offline: elements are offline.
  • Published: element are online.
Month
Filter on a specific month and year.
Map element type
Filter on the different map elements types.
Order by
Defines the list order, either on the date, the title, the author, or the status.
Sort
Choose whether the list will be sorted in ascending or descending order.
Map elements per page
Number of map elements that will be displayed on each page of the resulting set.

Selected map elements actions

If your user permission level allows it, you can perform batch operations on the map elements you select in the list.

Display map in a template

You can display a map in your templates. Use the following code: {{tpl:myGmaps id="home" center="47.389982,0.688877" zoom="12" style="roadmap" width="80%" height="200px" elements="2,4" category="4"}}

id
Specify a unique id. If none specified, an id will be generated for each view.
center
Indicate the geographical center of your map (Ex: Tours, France - Latitude : 47.389982, Longitude : 0.688877)
zoom
Between 0 and 19 (0 to see the world)
style
Choice: roadmap, satellite, hybrid, terrain, OpenStreetMap et neutral_blue. You may call your own style (see above)
width, height
width or height, in CSS sizes (px, em, %, etc.)
elements
Map elements ids, separated by commas
category
Category ids, separated by commas