Plugin / Run Log

Oren Izmirli



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


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


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


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.


1 reviews

Rating breakdown

Details Information



First Released

08 Jun, 2009

Total Downloads


Wordpress Version

3.8 or higher

Tested up to:


Require PHP Version:






The information provided in this THEME/PLUGIN DIRECTORY is made available for information purposes only, and intended to serve as a resource to enable visitors to select a relevant theme or plugin. wpSocket gives no warranty of any kind, express or implied with regard to the information, including without limitation any warranty that the particular theme or plugin that you select is qualified on your situation.

The information in the individual theme or plugin displayed in the Directory is provided by the owners and contributors themselves. wpSocket gives no warranty as to the accuracy of the information and will not be liable to you for any loss or damage suffered by you as a consequence of your reliance on the information.

Links to respective sites are offered to assist in accessing additional information. The links may be outdated or broken. Connect to outside sites at your own risk. The Theme/Plugin Directory does not endorse the content or accuracy of any listing or external website.

While information is made available, no guarantee is given that the details provided are correct, complete or up-to-date.

wpSocket is not related to the theme or plugin, and also not responsible and expressly disclaims all liability for, damages of any kind, arising out of the use, reference to, or reliance on, any information or business listed throughout our site.

Keep Leading Your Followers!
Share it for them.