Layout templates
Layout Template 1..6
The plugin comes with five different html templates that control in what order the map, download link and elevation diagram, as well as optional track information parsed from the track file.
These are just pieces of html code that will be put "around" the actual map, so you have maximum flexibility on how the map will be rendered by customizing those templates to your needs.
By default, the templates are taken from the plugin folder, but you can (and should!) use your own copies of the files:
Note: if you edit the files directly in the plugin directory, they will be overwritten with the next update of the plugin! So this is not a good idea. Better copy them over to your own front-end template directory and use the placeholder %TEMPLATEDIR%, or put them together with the GPX files (%GPXDIR%) where they will "survive" an update of the plugin (see below).
The following placeholders can be used for the filenames:
%PLUGINDIR% - /plugins/content/gpxtrackmap
%GPXDIR% - the GPX root directory
%TEMPLATEDIR% - the directory of the current front-end template
Parameter: tpl=[1|2|3|4|5]
Default template
Here you can select which one of the templates will be taken when you don't explicitly specify one.
Parameter: tpldefault (though it doesn't make much sense to use this as a parameter, better tpl=<n> like described above)
Available placeholders for Layout Templates
The templates can contain placeholders which the plugin will replace with the values parsed from your track file, if (and only if!) you have set the "Read track infos" option to Yes (parameter ti=1).
IMPORTANT NOTE: only the TRACKPOINTS and STARTTIME/ENDTIME/DURATION values are "100%" accurate. Especially the ELE-xxx values can be rather inaccurate, depending on a number of factors. Be sure to read the notes in "Cleaning up GPX files with GPSBabel" (esp. the section "Effects on track accuracy") for more details on this known technical limitation.
%TRACKPOINTS% - number of trackpoints (trkpt) found in the file
%DISTANCE-KM% - total length of the track in [km] kilometers
%DISTANCE-MI% - total length of the track in [mi] miles
%ELE-UP-M% - sum of positive altitude changes in [m] ("up-hill")
%ELE-DOWN-M% - sum of negative altitude changes in [m] ("down-hill")
%ELE-MIN-M% - minimum elevation (lowest altitude) found in the track, in [m] above sea level
%ELE-MAX-M% - maximum elevation (highest altitude) found in the track, in [m] above sea level
%ELE-DELTA-M% - difference between ELE-MIN and ELE-MAX in [m]
%ELE-UP-FT% - sum of positive altitude changes in [ft] ("up-hill")
%ELE-DOWN-FT% - sum of negative altitude changes in [ft] ("down-hill")
%ELE-MIN-FT% - minimum elevation (lowest altitude) found in the track, in [ft] above sea level
%ELE-MAX-FT% - maximum elevation (highest altitude) found in the track, in [ft] above sea level
%ELE-DELTA-FT% - difference between ELE-MIN and ELE-MAX in [ft]
%STARTTIME% - timestamp of the very first trackpoint
%ENDTIME% - timestamp of the very last trackpoint
%DURATION% - difference between STARTTIME and ENDTIME
%AVGSPEED-KMH% - average traveling speed in [km/h] = DISTANCE-KM / DURATION
%AVGSPEED-MPH% - average traveling speed in [mph] = DISTANCE-MI / DURATION
Note: A lot of new placholders are available since the V1.2 of the plugin. Until i find the time to document each one, please use Layout Template #6 - there you will a full and up-to-date list of all available placeholders!