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
-
- to add styles, creaye a folder named myGmaps in your media manager
- in this folder, create another folder named styles
- keep in this folder your personal styles
- Name and content of style files
-
- file name must use the following pattern : my_style_styles.js where my_style is
the name you can change (it is only an identifier and will not be displayed on public maps).
-
file content must be a JSON array of this type :
[{featureType: '',elementType: '',stylers: [{hue: ''},{saturation: ''},{lightness: ''},// etc...]},{featureType: '',// etc...}]
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:
- in your media manager, create a folder named myGmaps
- in the myGmaps folder, create another folder named icons
- keep in this folder your custom icons
- 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:
- in your media manager, create a folder named myGmaps
- in the myGmaps folder, create another folder named kml_files
- keep in this folder your kml files
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.
- Publish: set the map elements online.
- Mark as pending: erase other publication status.
- Change category: directs you to the category list to choose a
new one for the map elements.
- Change author: allows you to change the map elements' author by
entering the new author's ID.
- Delete: suppress the map elements (this operation cannot be undone).
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