Plugin / Run Log

Description

The plugin add running diary capabilities to WordPress, so you can log and display your running [and other sporting] activities in posts. Share runs, total mileage (or kilometers), total time spent running, etc. Track your shoes usage, and/or other sporting gear. Link and group your activities by goals.

Features

• Add custom post type for logging a running activity.
• Log distance and duration (elevation gain and calories) for each run in custom fields of run-log posts.
• Calculate pace/speed automatically.
• Display the above data in the post automatically.
• Widget and shortcode for displaying totals – distance, time, elevation gain, calories (and average pace/speed for shortcode).
• Option to choose light or dark style theme, to blend with your theme.
• Quick embed your STRAVA/Garmin Connect/endomondo activity in the post (displaying data and map from your account).
• Add custom taxonomies for gear (like shoes) and goals (like “sub 4 marathon”) that could be connected to run-log posts (and regular posts). You may trak distance run with shoes usage by this (as well as other gear).

Localization

Support RTL languages sites.

The metric system of measurement is used by default – Kilometer (km) for distance, minutes per kilometer (min/km) for pace, kilometers per hour (km/h) for speed [and meters (m) for elevation].
You can change these to statute/imperial by updating plugin’s “Distance unit” option to mi (Mile).

Translations

• Hebrew – full translations.
• English – default. Not my mother tongue, so may have some wording and spelling mistakes. Do tell me how to correct them if you find any.

Usage

[After activating the plugin]

To log a new run you can follow these steps:

1. On the admin menu there will be a new sub-menu: “Run Log” – from it’s options, select “Add New” (or click on “Run” from the “New” sub-menu of the top menu).
2. Enter a title for this run (as post title), write your run description (e.g. type of run, location, how you fealt, etc.) in the body. You can add media (photos, videos) if you want, as you would do with a normal post.
3. Under the main editing area (body) you should see the “Run Log Parameters” box. There you enter the distance and duration of the run.
4. [Optional] You may add the elevation gain and/or calories for that activety (at “Run Log Parameters” box).
5. [Optional] You may add the gear you used in this run on the “Gears” box (like shoes and track shoes mileage by this).
6. [Optional] You may add the goal, that this run is part of the road to it, on the “Goals” box (so you’ll be able to see all of them in one page, as well as the total distance/time).
7. [Optional] You may add your “STRAVA”, “Garmin Connect” or “endomondo” activity ID, to embed your activity’s data and map from your account (instead of the regular plugin’s display).
8. Publish.

If you want to configure run log data (distance, duration, pace/speed), you can do this on the “Run Log Options”, accessible via the “Run Log” admin sub-menu. There you can select between top/bottom display position, Kilometer/Miles units, and pace/speed.

To display your totals

Use [oirl_total] Shortcode with (or without) these optional attributes:

• only: distance/time/elevation/calories;
• year: a 4-digit year – display totals for this year only;
• month: 1 or 2 digits for month (may have leading zero) – display totals for this year only (mast be used in conjunction with ‘year’ attribute);
• hide_pace: yes/no – if ‘yes’ will not show the average pace/speed;
• days_display: true/false – display days in total time if more then 24 hours.

Examples:

• All-time distance + time + average pace/speed:
  • [oirl_total]
• 2015 totals without average pace/speed (display distance + time):
  • [oirl_total year="2015" hide_pace="yes"]
• January 2016 totals (distance + time + average pace/speed):
  • [oirl_total year="2016" month="1"]
• All-time distance:
  • [oirl_total only="distance"]
• All-time duration (displaying days if more then 24 hours):
  • [oirl_total only="time" days_display="yes"]
• Total elevation gain for 2016:
  • [oirl_total only="elevation" year="2016"]

Credits

The plugin icon was Designed by Freepik.

To Do:

• Add option to display elevation and calories on run-log posts.
• Add hart rate(?).
• Add how you felt scale(?).
• More quick embed sources (polar, suunto, runkeeper, runtastic, etc).
• Add API support to retrieve data automatically form: Strava, Garmin Connect, Sunto Movescount, Runkeepr, etc.

Uninstall

This plugin doesn’t add/change the data-base structurer, so no worry about that. Yet, it does store plugin configuration options in the ‘options’ table. These options will be removed if plugin is uninstall (deleted) trough the plugins admin screen.
Data stored by this plugin for posts (in postmeta table) will be kept.