Differences

This shows you the differences between two versions of the page.

--- res:plugins:gpxviewer [2022/05/07 20:20] – Added v1.0.2 arvid
+++ res:plugins:gpxviewer [2024/03/24 13:24] (current) – updated to plugin version 1.2 arvid
@@ Line 8: / Line 8: @@
 ===== Download =====
-{{ :res:plugins:arvid:gpx1.0.2.zip |}}
+  * GPX Viewer v1.2: {{ :res:plugins:arvid:gpx1.2.zip |}}
+Unzip, and upload the contained folder ''gpx'' to your ''fp-plugins'' folder.
+Then go to your blog's Admin Area -> //Plugins//, and activate the GPX Viewer plugin.
 ===== Usage =====
+==== Simple usage ====
 Upload a GPX file to your FlatPress instance. Then simply insert into your static page or blog entry:
 <code>[gpx="attachs/file.gpx"]</code>
+==== Multiple tracks ====
+It is possible to display multiple tracks at once; simply note them comma-separated:
+<code>[gpx="attachs/file1.gpx, attachs/file2.gpx"]</code>
+==== All tracks ====
+If you'd like to display the tracks of ALL uploaded GPX files on one single map, use the wildcard descriptor "attachs/*.gpx":
+<code>[gpx="attachs/*.gpx"]</code>
+==== Individual map layer ====
+You can set the default map type in the plugin's settings. Nevertheless, each GPX track can be displayed with an individual map layer:
+<code>[gpx="attachs/file.gpx" maptype="opentopo"]</code>
+See all available values for the "maptype" attribut in the select box of the plugin settings.
+==== Hide height profile ====
+The height profile beneath the map is shown by default. You may wish to hide it for individual maps:
+<code>[gpx="attachs/file.gpx" heightprofile="false"]</code>
 ===== HTML+CSS =====
 The plugin's output consists of two parts: The map itself and a height profile plot.
-The map is displayed as <html><div class="gpxmap"></html>, the height profile plot as <html><div class="gpxheightprofile"></html>.
+The map is displayed as ''div class="gpxmap"'', the height profile plot as ''div class="gpxheightprofile"''. Those two are packed together in a ''div class="gpx"'':
-Those two are packed together in a <html><div class="gpx"></html>.
 <code><div class="gpx">
     <div class="gpxmap"></div>
@@ Line 35: / Line 55: @@
   * The FlatPress plugin code around all this by [[https://arvidzimmermann.de|Arvid Zimmermann]] is licensed under GPLv3.
-=== Changelog ===
+===== Development =====
-== 2022-05-07: Version 1.0.2 ==
+Feel free to send Pull Requests [[https://codeberg.org/azett/flatpress_gpx|on Codeberg]].
-  * Bugfix: Fixed invalid HTML output.
-== 2020-12-19: Version 1.0.1 ==
+===== Changelog =====
-  * Updated GPX Viewer library to version 6.10.1.
+See the detailed changelog [[https://codeberg.org/azett/flatpress_gpx/src/branch/main/CHANGELOG.md|on Codeberg]].
-  * 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.