Options: GPX Track settings
1. GPX track file root directory
This is the "starting point" where the plugin will find your GPX track files. You should set it up once, after installation of the plugin, and then stick to this setting (!)
If you change it later on, the plugin likely won't be able to find your GPX track files any more, so all you would see is blank ("light blue"), empty maps.
2. Default GPX track file
This is the file the plugin will show if you don't supply any filename in the invocation code, but simply write
{gpxtrackmap}{/gpxtrackmap}
into your article text. It's a rather useless option, to be honest - i just put it here under root directory, so you can see how the URL to your track file is assembled: <GPX root directory>/<track filename>
parameter name: This is the only parameter that does not have a name - you just have to write it down as the very first parameter in the invocation code.
Note: the code for the map will replace the %TRACKMAP% placeholder in the Layout Template, so if you use a customized template file, make sure it includes this placeholder.
3. Width of the map
You can enter an (integer) value for the map width here. You must supply a unit, either "px" or "%".
parameter name: mapwidth
examples:
mapwidth=100% - map will be as wide as it's container
mapwidth=500px - map will be exactly 500 pixels wide
4. Height of the map
Enter an (integer) value for the map height here, also in "px" or "%".
parameter name: mapheight
examples: see above
5. Zoom-Out
The map will display your track centered-in and zoomed-in to its "extents" (maximum west-east and north-south coordinates). If you only see parts of your track, this is likely because this is done using fixed (integer) zoom levels. If your track does not fit on the map, try to use zoomout=1 in the invocation code for that track.
Note that this parameter is actually a "delta-zoom": the OpenLayers API will first try to auto-zoom your track. If you have set the zoomout parameter to anything else than 0, the plugin will make the map zoom OUT or zoom IN after this auto-zoom, by as much levels as you set here. Positive numbers (0..10) will zoom OUT, while negative numbers (-1..-10) will zoom IN towards the geographic center of the track.
parameter name: zoomout
examples:
zoomout=1 - will zoom out the map by one level after auto-zooming
zoomout=9 - will zoom out 9 levels (which is A LOT), you will likely see the whole World map
zoomout=-9 - will zoom IN 9 levels - as close as it gets - to the geographic center of your track (note: not to it's start or end, but to its center !)
6. GPX track line width
This controls how wide the track line will be on the map. This value is in [pixels], you should NOT add "px" or "%" to it!
parameter name: trackwidth
examples:
trackwidth=3 - a rather thin line for the track
trackwidth=30 - a really thick line - if you zoom out on this track, it will not look very nice.
7. GPX track color
The color for the track line can be set here to any valid HTML color value: a color name (red,green...) or an RGB value like #FF0000
parameter name: trackcolor
examples:
trackcolor=#0FF - shows a yellow track
trackcolor=red - guess what? :-)
8. GPX track opacity
This is a value between 0.0 and 1.0 that controls how much you will see the map "shine through" your track line. A value of 0.0 will make your track completely transparent, which means, you will not see it at all (!). A value of 1.0 will make it completely "un-transparent", or fully opaque (transparency is just the opposite of opacity).
parameter name: trackopacity
parameter values: 0.0 to 1.0
( Note to German users: don't use a "," like in "0,1" - use "0.1" instead ! The comma "," is used to separate parameters.)
9. GPX track line style
Here you have some choices on how the track line will be drawn. Note that the Track Width (above) will influence how the different line styles will be drawn onto the map.
parameter name: tracklinestyle
parameter values:
0 : solid
1 : dots
2 : dashes
3 : dashes + dots
4 : long dashes
5 : long dashes + dots
10.
(Note: the Waypoint options have moved to their own parameter section "Waypoints" since V1.2)