Joomla!Extension: ModuleMap (mod_GoogleMap)
Compatible with Joomla 1.5 ONLY
Created by Benjamin Hättasch
Mail me to Benjamin.Haettasch@googlemail.com
Released under the GNU General Public License 2.0
Home: http://joomlacode.org/gf/project/mod_googlemap/
Installation Instructions:
(If you use the Delivery-Package:) Extract the mod_GoogleMap Installer archive out of this archive, but don't unpack it.
In the Joomla! administration area, go to:
Extensions > Install/Uninstall. In the upload box,
Then select the archive mod_GoogleMap on your HD and click "Upload and Install."
After installation, enable the Module from:
Extensions > Moduele Manager > ModuleMap
Before you can use the module, you will have to change the settings of the Module.
Settings:
Attention: This Setting is important, without this, your module won't work:
GoogleMaps API Key: You will need your own free key to use the Google Maps API on your website.
Visit "http://code.google.com/apis/maps/signup.html"
to get your own Key. You have to accept the conditions given by Google. After registering copy your Key into the text-area.
Now the Map should work, using the other default settings. But such a map wouldn't make any sense. So you should reset the next Values, to get your own map.
First option block: Dimensions of the map
With this you can set the height and the width of the map.
Second option block: Place at the map
You can set Latitude and Longitude: These are the Geocodes, the coordinates of the place. You can get them by copy them from the maps URL or with a Geocode request. A better option will be included in the next version.
Secondary you can set the zooming level. You should play a little bit with this to find the best level. (Or you can copy it from the Google Maps URL, too.)
Third option block: Map-specifics
First you can choose the type of the map. There are three possible types:
a. Normal Map
b. Satelite Map
Secondary you can add control elements to the map. The options are:
a. None – No control elements
b. Little Bars – Some little bars for zooming and navigating at the left side. Should be used on little maps.
c. Map-Type – Buttons to choose the type of the map
d. Little Bars + Map-Type
e. Large Bars (The map should have a height of min. 275 px)
f. Large Bars + Map-Type
Fourth option block: Speech bubble
Fifth option block: Map-properties
There are a few of possible map-properties, wich you can enable or disable by using this parameters:
a. Display a link to reset the map right under the map
b. Enable or Disable Draging of the map
c. Enable or Disable Zooming by Mousewheel
d. Enable or Disable Google Bar, a little search field for the map, displayed in the corner at the left button.
Special Functions
The visitors of your page can easily change the place that is shown in the map, by clicking on a special link. This link can you put into all of your articles. When somebody clicks on it, the map will change.
The link has to be like this:
javascript:ShowMap(myLatitude, myLongitude, Zoom)
If you install the 'Plugin for ModuleMap', you will be able to write {ShowMap} into your articles. This will not embed a map but create a ShowMap-Link like in the beforing paragraph. The parameters should be like the following:
{Show Map x=<Param X>&y=<Param Y>&zoom=<Zoom Level}<Link-Text>{/ShowMap}
It's not necessary to keep this order by using the paragraphs, but make shure that you used all of them, because otherwise it won't work.
Attention: In this early version of the plugin it is only possible to embed one of this objects into each article. If you use more then one, all will look the same.
Notes:
This version - 0.5 - is temporary the final version. But I have some more ideas to get made. I surely will produce another version in future, based on a new core system. And I will update the old one, if anybody reports problems on using it to me. Feel free to do so. And feel free to ask me for new features.
Enjoy using it.