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


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


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


 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


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


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


(Note: the Waypoint options have moved to their own parameter section "Waypoints" since V1.2)