|
Welcome at the site with documentation and examples of the Plugin Googlemaps.
I hope this site will provide you the necessary information to solve problems or give ideas how to use the plugin in your site. Click read more for more general information of the installation and usage of the plugin.
If you've a problem or question please do the checklist first. If this doesn't solve it send me an email, with the url of the page with problem and version of the plugin.
If you like the plugin please give us a vote or review at Joomla extensions.
A donation is also very welcome (see sponsors)
Have fun with the plugin.
Cheers Mike
Download
Download the latest version at the project site.
Last version is 2.12n (stable/production). For Joomla 1.5.x take the file with J15 in the name, for example: plugin_googlemap_J15.2.12n.zip
License
The plugin is distributed under General Public License (see: http://www.gnu.org/copyleft/gpl.html). You may use it, copy it and modify it, but please respect my work and show my name as an author.
If you want to fork the plugin for Joomla, please send an email to inform me.
Install
To install the plugin go to Joomla menu Extensions submenu Install/Uninstall (1.5) or Installers submenu Mambots (1.0.x) in your administrator 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).
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.
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 must be entered here. You can obtain a key here.
If you're a first user then don't change the other parameters and first make sure the plugin works and the map shows (see next paragraph).
The defaults can be overruled by the parameters added to {mosmap} in the article, module or component.
An installation instruction can be found at goodwebpractices.com (thanks to Alex Ashman).
A french tutorial can be found at joomla.kiminox.net (thanks to Kim Yoong).
How to use the plugin in content
Create a new content article (not static) and place in the intro text: {mosmap}. Make sure the article is visible on the frontpage or as an item a menu. Have a look at the frontpage at this article to see the first map. The plugin doesn't work in the preview of the backend of Joomla.
Then have a look at the documentation and examples.
You can put the {mosmap} anywhere in a content article in Joomla: intro text or main text. If you want to show a map in a module of component (like contacts) then you need to hack Joomla (see Joomla 1.0.x and Joomla 1.5.x ).
The parameters entered with the mosmap will be used and overrules the defaults, set at the configuration of the plugin.
Usage: {mosmap parameter='value'|parameter='value'|...}
Example: {mosmap lat='52.052312'|lon='4.447141'|zoom='3'|text='sv DWO'|tooltip='DWO'|marker='1'}
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.
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 (use standard of your 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/infowindow. 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 |
| 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, center or none) |
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:
Problems
If you have problems with the plugin, please do the checklist first.
If this didn't help please send me an email. Please include:
- an url to the page with the map or where the problem shows.
- the version of Joomla
- the version of PHP
- the version of my plugin
- what checklist steps you did.
|
