Search Over 30,000 FREE Plugins from the Official WordPress Plugin Directory Repository

Run Log

Add running diary capabilities - log your sporting activity, track and display: distance, duration, gear (e.g. shoes), elevation gain, calories, etc.

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.


  • 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.
  • Shortcode for displaying totals - distance, time, elevation gain (and average pace/speed).
  • 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).


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


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


[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 (as well as elevation gain and calories - to be used in future version of the plugin).
  4. [Optional] You may add the gear you used in this run on the "Gears" box (like shoes - in future we may track shoes mileage by this).
  5. [Optional] You may add the goal, that this run is part of the road to it, on the "Gears" box (like shoes - in future we may track shoes mileage by this).
  6. [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).
  7. 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.


  • 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"]


The plugin icon was Designed by Freepik.

To Do:

  • Add elevation, calories, gear , and goal display.
  • Option to add data box to excerpt.
  • Add Widget to display accumulate data and more.
  • Add hart rate.
  • More quick embed sources.
  • Add API support to retrieve data automatically form: Strava, Garmin Connect, Sunto Movescount, Runkeepr, etc.


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.

Author Oren Izmirli
Contributors izem
Tags Endomondo, garmin, garmin connect, jogging, run, run diary, run log, running, running log, share runs, sport, strava, total distance, total duration, total time, training diary, training log
  1. run-log screenshot 1

    Run data display in the post.

  2. run-log screenshot 2

    The post edit screen - run-log parameters input box at the bottom.

  3. run-log screenshot 3

    Shortcode displaying 3 views: default, distance only, duration only.

  4. run-log screenshot 4

    The plugin options screen.

  5. run-log screenshot 5

    "Garmin Connect" embed.

  6. run-log screenshot 6

    Gears and Goals input boxes from the post edit screen.

  7. run-log screenshot 7

    endomondo embed.

  8. run-log screenshot 8

    STRAVA embed.

From the WordPress Plugin Directory:

  1. Navigate to the 'Add New' in the plugins dashboard
  2. Search for 'Run Log'
  3. Click 'Install Now' button
  4. Activate the plugin in the Plugin dashboard

From your computer via WordPress Dashboard:

  1. Download
  2. Navigate to the 'Add New' in the plugins dashboard
  3. Click on the 'Upload Plugin' button (top)
  4. Select from your computer
  5. Click 'Install Now' button
  6. Click on "Activate Plugin" link

From your computer via FTP or from your sever:

  1. Download to your computer (or to server)
  2. Extract the run-log directory from zip file
  3. Upload/Move the run-log directory under the wp-content/plugins/ directory of your WrdPress installation
  4. Activate the plugin in the Plugin dashboard


  • Fixed pages not displaying due to iorl_run_log_update_get_posts bug


  • Totals Shortcode supports year/month time periods.
  • Totals Shortcode supports elevation.
  • Added m to ft (Meters to Feet) and ft to m conversion.


  • STRAVA quick embed and totals Shortcode enhancements.


  • Shortcode for displaying totals (distance, time, pace/speed).
  • Enable STRAVA activity quick embed.
  • Option to choose light or dark style theme.
  • Better form input sanitizing with filter_input.


  • Quick embed admin-side enhancements.


  • Enable endomondo activity quick embed.


  • Code refactoring of plugin options as one hash record (instead of many records).
  • Update code to follow WordPress coding and inline documentation standards.


  • Support for deleting Garmin activity ID, and new screenshot.


  • Enable "Garmin Connect" quick embed.


  • Option not to display the run data on the post was added.
  • Option to display the run data on the excerpt was added.
  • Added plugin icon.


  • Move translation files under languages directory


  • Initial version

Can this plugin be used for cycling or other similar sport activities?

Yes, it should be usable for cycling as well, and maybe other similar sports.

Something doesn't look right

Check and update options on the "Run Log Options" page.

"Garmin Connect" quick embed doesn't work

Verify the activity ID is copied fully from activity's page address (the 10-digit number ate URL's end: Make sure your activity is Public - activity's privacy is set to "Everyone" (the lock icon, at the top right page corner, is open).

Version 1.5.3

Requires WordPress version: 3.8 or higher

Compatible up to: 4.7.2

Last Updated 07 Dec 2016

Date Added: 11 Jun 2016

Plugin Homepage


0 stars
0 ratings


Not Enough Data

Works: 0
Broken: 0