This is an old revision of the document!
Table of Contents
This plugin adds Jürgen Berkemeier's free JavaScript library GPX Viewer to FlatPress.
It adds a BBCode tag “gpx” to include your uploaded GPX file into your blog entry or static page.
Important: The GPX Viewer library is free for non-commercial use. If you want to use it in a commercial environment, please contact its author Jürgen Berkemeier.
Author of the FlatPress plugin is Arvid Zimmermann.
Download
Usage
Upload a GPX file to your FlatPress instance. Then simply insert into your static page or blog entry:
[gpx="attachs/file.gpx"]
HTML+CSS
The plugin's output consists of two parts: The map itself and a height profile plot. The map is displayed as <html>
</html>, the height profile plot as <html>
</html>. Those two are packed together in a <html>
</html>.
<div class="gpx">
<div class="gpxmap"></div>
<div class="gpxheightprofile"></div>
</div>
You find the default CSS defintions for these classes in res/gpxplugin.css.
Customization
The GPX Viewer library allows to change appearance of the map and height profile (such as colors and other behaviour) via JavaScript control variables. The file res/costumsettings.js contains a few of them to start with; you find them all on the GPX Viewer documentation page.
License
- GPX Viewer library by Jürgen Berkemeier: CC BY-NC-SA 4.0. If you want to use it for commercial purposes, please contact the author.
- GPX Viewer uses the Leaflet API by Vladimir Agafonkin, which is licensed under BSD 2-Clause “Simplified” License.
- The GPX data is shown on OpenStreetMap map material, licensed under ODbL.
- The FlatPress plugin code around all this by Arvid Zimmermann is licensed under GPLv3.