Show Fit File Plugin
A plugin to display fit, gpx and tcx files.
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/
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!
Screenshots
Plugin Showing Map and Altitude Graph
FAQ
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.
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