Technical - Welcome

Welcome

Written by Mike Reumer

Friday, 21 March 2008

Download

Download the latest version at the project site. Last version is 2.10i.

Install

For Joomla 1.5 you need to set the legacy plugin on. After installation you can set legacy off!

To install the plugin go to Joomla menu Extensions submenu Install/Uninstall (1.5) or Installers submenu Mambots (1.0.x) in your administration console. Upload and install the plugin. Then go to Joomla menu Extension submenu Plugin Manager and publish the Plugin Google Maps (1.5) or menu Mambots submenu site Mambots (1.0.x).

After publishing the plugin go to the parameters of the plugin by clicking on the name of the plugin. Here you can set the defaults of the parameters. The key for Googlemaps can be entered here. You can obtain a key here.

For Joomla 1.5 always publish the plugin. With the plugin parameter Published (right side) you can set if the mostag must be removed or that the mostag is replace with the Googlemap.

An instruction can be found at goodwebpractices.com (thanks to Alex Ashman).

How to use the plugin in content

First have a look at the documentation and examples.

You can put the {'mosmap} with parameters anywhere in content in Joomla: intro text or main text. The parameters entered with the mosmap will be used above the defaults, set at the configuration of the plugin.

Check the html of the content item so there are no < br> or & nbsp; between { } or in the html a return.
The plugin works for one line! It can be once, twice or more to display multiple, inline maps on a single content page for different locations and configurations.

Usage: {mosmap parameter='value'|parameter='value'|...}

Example: {mosmap lat='52.052312'|lon='4.447141'|zoom='3'|text='sv DWO'|tooltip='DWO'|marker='1'}

You can change any of the parameters:

width, height	to whatever you want although if its too small, you won't see very much. You must put the units behind the number like 100% or 400px
lon, lat	for the coordinates or address to search for the coordinates (should consist of street number, zipcode town, country)
zoom	can be anything as specified in the Google Maps API.
zoomType	can be Small or Large, this controls the type of zoom function displayed or None so there is no zoomcontrol.
zoomNew	can be 1 for continues zoom and doubleclick and zoom or 0 for click to center (default 0)
zoomWheel	can be 1 for mousewheel zoom and 0 for no mousewheel zoom (default 0)
mapType	can be Normal (default), Satellite or Hybrid.
showMaptype	is 0 for no Maptype controls and 1 shows Maptype controls (default 1)
Overview	is 0 for no overview window in bottom right corner and 1 shows the overview and 2 for overview enabled but close initially (default 0)
text	is for the marker, that will show on the map with a balloon. If you don't want to see the text, just set text=" and it will not display, the text is the data displayed above the location pin. Usually it would be used to display an address or hyperlink. A hyperlink is possible use the format: < a href=linkAddress target=linkTarget title=linkTitle>linkName< /a>. Don't use (double) quotes!
marker	is for opening the infowindow (1 default) or close the infowindow (0) initially.
dir	for adding get directions form for a route at maps.google.com to the coordinates.
tooltip	is for the marker to have a tooltip when the mouse is on the marker (don't use HTML)
address	is for a address to search for the coordinates (lon/lat has to be empty)
gotoaddr	for a searchfield and button so the user can search a address on the map (default 0)
kml	for a url to a kmlfile to load as a overlay on the map for multiple markers or a route
align	is for placement of the map in the content (left, right or center)
lang	is for the language of the maps.

Multi markers

It's not possible to add multiple locations or addresses to one map with my plugin. Maybe in the next release.

An alternative is to use a kml-file see documentation, for a form see explanation and examples: