GPX Viewer
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"]
You can set the default map type in the plugin's settings. Nevertheless, each GPX track can be displayed with an individual map layer:
[gpx="attachs/file.gpx" maptype="opentopo"]
See all available values for the “maptype” attribut in the select box of the plugin settings.
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.
Changelog
2022-06-06: Version 1.1
- Updated GPX Viewer library to version 6.16.
- Added plugin settings panel to the Admin Area.
- Added localization.
2022-05-07: Version 1.0.2
- Bugfix: Fixed invalid HTML output.
2020-12-19: Version 1.0.1
- Updated GPX Viewer library to version 6.10.1.
- Bugfix: initializePluginTags() has to be public static.
- Bugfix: Track was displayed with unwanted offset.
- CSS: A little more spacing between map and height profile in the GPX plugin.
2020-11-01: Version 1.0
- Initial plugin version.