Description
Show Fit File is a sports & fitness oriented plugin that allows you to add a map and summary exercise data from a fit, gpx or tcx file. The maps are generated using leafletJS with the map tiles provided by OpenStreetMap.
These files are produced by fitness, running and cycling computers, such as Garmin, Polar, Suunto, Wahoo and Hammerhead devices. The files can usually be downloaded either directly from the device, or via the manufacturer’s portal.
Both a Gutenberg Block and Shortcode (.fit files only) versions are present in this plugin.
Usage
Block
Add the Show Fit File block to your post
Click on the blue button below the map to upload your .fit , .gpx or .tcx file. After a couple of seconds, your file will then be displayed.
An altitude profile graph will be displayed under the map. This can be hidden using the block controls in the side bar.
Shortcode
Upload the .fit file to your Media Library, then simply create a map from the file by adding the following ShortCode to your post:
[showfitfile file=β2019-06-16-10-48-12.fitβ]
To change the units to Imperial (default is metric):
[showfitfile file=β2019-06-16-10-48-12.fitβ units = βimperialβ]
To change the route colour (default is βRedβ):
[showfitfile file=β2019-06-16-10-48-12.fitβ colour = βblueβ]
To allow scrolling and zooming of the map (default is βnoβ)
[showfitfile file=β2019-06-16-10-48-12.fitβ interactive = βyesβ]
Icon
The icon uses Map by Atif Arshad from the Noun Project https://thenounproject.com/browse/icons/term/map/
Screenshots
Blocks
This plugin provides 1 block.
- Show Fit File Display .fit, .gpx and .tcx file data on a map.
Installation
This section describes how to install the plugin and get it working.
- Upload complete βshowfitfileβ folder to
/wp-content/plugins/
directory - Activate the plugin through the βPluginsβ menu in WordPress
- Upload a .fit file to your Media Library
- Add the ShortCode or Block to your post
- Done!
FAQ
-
What’s the difference between moving time & duration?
-
Moving time is the time you actually spent moving during your session, while duration is the time from the start to the finish, including any stops or pauses. If you stop to take a photo or for a quick coffee, that time won’t be included in moving time.
It’s worth noting that, depending on the setup of your device, you may not see much difference between Moving Time and Duration, particularly if your device is set to auto-pause.
Reviews
Contributors & Developers
“Show Fit File” is open source software. The following people have contributed to this plugin.
Contributors“Show Fit File” has been translated into 2 locales. Thank you to the translators for their contributions.
Translate “Show Fit File” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.2.3
- Fixed crash in Shortcode if a file has no GPS data
1.2.2
- Fixed bug where altitude graph may not appear
1.2.1
- Now uses Garmin’s .fit importer
- Performance improvements
1.2.0
- Can now show lap positions from .fit files
- Improved position tracking from altitude graph
1.1.5
- Fix for WordPress 6.2
1.1.4
- Fixed issued reading gpx files that don’t have a timestamp in the elements
1.1.3
- Fixed bug introduced in 1.1.2 that included empty Lat/Long elements in .fit file decoding
1.1.2
- Position on map now correctly tracks mouse location on altitude graph
- Improved layout of Session Summary details table for ShortCode
1.1.1
- Map no longer redraws when post text is edited
- Ascent & Descent values are no longer lost when post is edited
1.1.0
- Can now display .gpx & .tcx files for block
- Adds Altitude graph for block
- Adds gesture scroll in block editor
- Shows ascent & descent in table about the map
- Has option of show either moving time or elapsed time
- Other bug fixes
1.0.0
- Introduces ShowFitFile Block
- Adds gesture scroll to Shortcode version