=== Show Fit File ===
Contributors:      stuarttevendale
Tags:              fit, gpx, tcx, Garmin, cycle
Requires at least: 5.8
Tested up to:      7.0
Stable tag:        1.2.7
Requires PHP:	   7.4
License:           GPL-2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

A plugin to display fit, gpx and tcx files.

== 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.

== Installation ==

This section describes how to install the plugin and get it working.

1. Upload complete 'showfitfile' folder to `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Upload a .fit file to your Media Library
4. Add the ShortCode or Block to your post
5. Done!

== 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 ==

1. Plugin Showing Map and Altitude Graph

== Frequently Asked Questions ==

= 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.

== Upgrade Notice ==

= 1.1.0 =
When upgrading blocks from V1.0.0, you'll need to import the .fit file again, if you want to display the profile graph or the ascent/descent figures.

== Changelog ==

= 1.2.7 =
* Fixes issue where the plugin may cause an error when uploading certain file types

= 1.2.6 =
* Fixes issue where altitude graph is not shown

= 1.2.5 =
* Fixes issue where ascent and descent figures appear on two separate lines for some WordPress themes

= 1.2.4 =
* Now shows Altitude data from enhanced_altitude message in .fit files

= 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 <trkpt> 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
