=== XML Google Maps ===
Contributors: dschuesae
Tags: google maps, google, maps, gpx, kml, kmz, tracks, routes
Requires at least: 2.1
Tested up to: 2.5
Stable tag: 1.3
Donate link: http://www.matusz.ch/donate_xmlgooglemapswpplugin.htm

Converts links to kml, kmz and gpx files to a google map!

== Description ==

Add your own KML, KMZ or GPX files to your web page. Links to these files will be converted automatically to a Google Maps map.

Simply upload your gpx, kml or kmz file in your blog entry upload form. Make an a-link to the file. Save the entry and here it is - as simple as possible.

To extend or correct the map there are some parameters too:<br>
Include Parameters within the &lt;a&gt; and &lt;/a&gt; tag (&lt;a href=&quot;gpx, kml or kmz url&quot;&gt;Title [Parameters]&lt;/a&gt;) and make sure that the whole url is on the same line.
<ul>
<li>maptype:<br/>Defines view type of Google Maps &gt; (G_HYBRID_MAP, G_SATELLITE_MAP, G_NORMAL_MAP, G_PHYSICAL_MAP)</li>
<li>maxlat, maxlon, minlat, minlon: Manually set center and zoom of your world View</li>
<li>urldisplaymode: none (no link), showvars (include parameters), title (default)</li>
<li>width, height: dimension of a single map can be changed</li>
<li>zoom: Zoom Value of Google Maps to override the default or calculated zoom level (max. is around 20)</li>
<li>deltazoom: Adds or subtracts zoom level to calculated or default zoom level! (Only works for maps without parameter "zoom")</li>
<li>panzoomcontrol: large, small, zoom, hide</li>
<li>overviewmapcontrol: hide, show</li>
<li>scalecontrol: hide, show</li>
<li>maptypecontrol: hide, show (Normal Buttons), hierarchical (Hierarchical Buttons and Checkboxes)</li>
<li>align: left, center, right</li>
<li>mapnormal, maphybrid, mapsat, mapphysical: Shows or Hides the specific Map Type Control Button</li>
<li>dragging: enabled, disabled</li>
<li>googlebar: enabled, disabled</li>
<li>continuouszoom: enabled, disabled</li>
<li>doubleclickzoom: enabled, disabled</li>
<li>scrollwheelzoom: enabled, disabled</li>
<li>gpxinterval:<br/>Shows only every xth Track- or Routepoint</li>
<li>gpxcolor:<br/>Color of GPX Tracks and Routes!</li>
<li>gpxlinewidth:<br/>Width of GPX Tracks and Routes!</li>
<li>gpxlineopacity: Opacity of GPX Tracks and Routes!</li>
<li>gpxview: all, trk (tracks only), rte (routes only), wpt (waypoints only)</li>
<li>gpxelevation: show (only works for gpx tracks with elevation information), hide</li>
<li>gpxelevationcolor: line color of elevation chart</li>
<li>gpxelevationlinewidth: line width of elevation chart</li>
<li>gpxelevationheight: height of elevation chart</li>
<li>gpxelevationmeasurement: metric or imperial</li>
</ul>

Examples:
<ul>
<li><a href="http://www.matusz.ch/blog/2007/08/30/ferien-bretagne-und-vendee-2-tag/" target="_blank">GPX File with Parameters</a></li>
<li><a href="http://www.matusz.ch/blog/2007/04/11/skating-auf-der-thuner-allmend/" target="_blank">KML File</a></li>
<li><a href="http://www.matusz.ch/blog/projekte/xml-google-maps-wordpress-plugin/beispiele/" target="_blank">More Samples...</a></li>
</ul>

<a href="http://www.matusz.ch/blog/projekte/xml-google-maps-wordpress-plugin/" target="_blank">Deutsche Anleitung</a>!

== Installation ==
<ul>
<li>Download the Plugin ZIP File</li>
<li>Upload the Folder xml-google-maps to your wordpress plugin folder</li>
<li>Activate the plugin</li>
<li>Create a Google Maps API Key <a href="http://www.google.com/apis/maps/signup.html" target="_blank">here</a></li>
<li>Enter the Google Key in the Option Pane</li>
<li>Set the size of your Google Map in the Option Pane</li>
<li>Developed a better algo for resolving the url to a local path (GPX and KML parsing).</li>
</ul>

For Updates:
<ul>
<li>Deactivate the plugin!</li>
<li>Continue with the installation steps!</li>
</ul>

== Frequently Asked Questions ==
= Link don't get converted to map =
The whole a-Tag has to be on the same line in HTML Source

= Cannot change visibilty of one Map Type Control Button =
If you set this button to your default view, then this button has to be visible. But you can hide the whole Map Type Control in the top right corner.

== Screenshots ==
1. Normal Map
2. KML map marker with image
3. Sample of GPX File with Elevation Graph 
4. Supports Google Bar in the bottom left Corner and Hierarchical Map Type Buttons on the top right corner

== Changes ==
Version 1.3
<ul>
<li>Also supports a-tags with single quoted attributes now</li>
<li>New algorithm for GPX Polyline encoding</li>
<li>Shows XML Google Maps WP Plugin Banner on Map</li>
<li>Supports new Map Type Physical</li>
<li>New Parameters to change the MapType Control Buttons: mapnormal, maphybrid, mapsat, mapphysical (show, hide)</li>
<li>Support added for the new Hierarchical Map Type Control. Set parameter overviewmapcontrol to hierarchical</li>
<li>New parameters (enabled/disabled) for customize the map behaviour: dragging, googlebar, continuouszoom, doubleclickzoom, scrollwheelzoom</li>
</ul>

Version 1.2.4
<ul>
<li>GPX Elevation line color names didn't work (green, red, ...). The plugin now converts the known html color names into hex.</li>
</ul>

Version 1.2.3
<ul>
<li>Changed algorithm to get local path of a gpx file</li>
</ul>

Version 1.2.2
<ul>
<li>Changed admin pages for new Wordpress Admin Styles</li>
</ul>

Version 1.2.1
<ul>
<li>Tested for Wordpress 2.5</li>
</ul>

Version 1.2
<ul>
<li>The plugin does now validate for XHTML 1.0 Transitional (thx to fishtoes2000)</li>
<li>Link to a on My Google Maps created map now also works with domains other than google.com (examples: google.de, google.ch, ... - thx to marius).</li>
<li>Did not free xml parser and so did not accept more than one gpx file on the same page!</li>
<li>Solved problem with the apos sign in the gpx comment, description or name tag</li>
<li>New property 'CSS Style for GPX Waypoints' added in the settings section of the plugin!</li>
</ul>

Version 1.1
<ul>
<li>New Parameter: gpxelevationmeasurement: metric/imperial</li>
<li>Improvements in displaying the chart</li>
<li>Bug with missing description for GPX Waypoints in map fixed!</li>
<li>New Parameter: zoom to ovveride the default or calculated zoomlevel</li>
<li>New Parameter: deltazoom to add or subtract zoom level to calculated or default zoom level! (Only works for maps without parameter "zoom")</li>
<li>Set property frameborder=0 to iframe. IE now shows the iframe without any frame!</li>
<li>Changed required_once(<file>) to required_once(dirname(__FILE__).<file>)</li>
</ul>

Version 1.0
<ul>
<li>New feature: Reads elevation information from the gpx tracks and displays the data in a chart!</li>
<li>New Parameter: gpxelevation: show( only works for gpx tracks with elevation information), hide</li>
<li>New Parameter: gpxelevationcolor: line color of elevation chart</li>
<li>New Parameter: gpxelevationlinewidth: line width of elevation chart</li>
<li>New Parameter: gpxelevationheight: height of elevation chart</li>
<li>Bug with parameter value showvars=title fixed.</li>
<li>Bug with Google Maps URL with encoded ampersand '&' -> '&amp;' in it fixed (Wordpress replaces every '&' to '&amp;' during saving a post).</li>
</ul>

Version 0.8
<ul>
<li>Using Maps without Links possible with: [xmlgm &lt;parameters&gt;]</li>
</ul>

Version 0.7
<ul>
<li>KML Files loading problem (script duration) solved!</li>
<li>Marker from GPX Files won't show</li>
<li>New Parameters: width and height for single map dimensions</li>
<li>KML only correctly loaded with MapType G_MAP_TYPE, now delayed loading of other MapTypes!</li>
<li>Support for KMZ Files added!</li>
<li>New Parameter: panzoomcontrol for defining the left top pan/zoom control!</li>
<li>New Parameter: overviewmapcontrol for showing a small overview map of the region!</li>
<li>New Parameter: scalecontrol for showing a Scale Control!</li>
<li>New Parameter: maptypecontrol for showing the Map Type Selection Buttons!</li>
<li>New Parameter: align for aligning the IFrame</li>
</ul>

Version 0.6
<ul>
<li>Default values for parameters can be set on the Option Pane</li>
<li>The plugin now uses Encoded Polylines for faster loading and smaller files</li>
<li>Changed Google Maps API Version from 2.x to 2 (stable)</li>
</ul>

Version 0.5
<ul>
<li>Option Pane for Google Maps API Key and Dimension of the showing Google Maps</li>
<li>GPX and KML files don&apos;t need to be added to wp_check_filetypes anymore</li>
</ul>

Version 0.4
<ul>
<li>Internet Explorer didn&apos;t show Overlay&apos;s</li>
<li>Performance optimazation for Polylines with man points</li>
</ul>

Version 0.3
<ul>
<li>Use of Parameters: maptype, gpxinterval, gpxcolor, gpxlinewidth, gpxlineopacity, gpxview, maxlat, maxlon, minlat, minlon and urldisplaymode</li>
<li>"My Maps - KML"-Links also get converted</li>
<li>Georg&apos;s Solution for show.php</li>
<li>Tracks and Routes get displayed</li>
</ul>

Version 0.2
<ul>
<li>Some minor bugs</li>
</ul>