The Runkeeper plugin for WordPress lets you embed a preview of your activities in to posts using a custom field or shortcode.
Take a look at an Example of the plugin in action.
Version 2.0
The new version offers two options for adding maps in to posts:
- Create a custom field called “runkeeper” and paste in the “Share” link from your activity on Runkeeper
- Use the shortcode [[[runkeeper url=”example”]]] at any point in your post where you would like the map to appear, replacing “example” with the “Share” link from Runkeeper.
The new version also allows you to change the width, height and offset of the preview using the Settings page. Go to Settings > Runkeeper in the admin menu. The default values are: Width: 600px, Height: 400px, X: 300px, Y: 300px
Custom Fields in Posts
If you’ve not used custom fields in your posts before, it’s really simple.
When you add a new post, look down the page to the section called “Custom Fields”. Click “Enter New”, then add the “Name” “runkeeper” and the value is the address of the activity you want to embed. If you don’t have the Custom Fields section on the page, you may need to select it from the Screen Options menu in the top right.
Take a look at the example below.
Shortcodes
Shortcodes are tags enclosed in square brackets which can be entered anywhere in the post. When the post is displayed on the front end, the shortcode will be replaced with dynamic content, in this case a Runkeeper map.
An example shortcode for the Runkeeper plugin is:
[[[runkeeper url=”http://runkeeper.com/user/peterasmith/activity/25780715″]]]
Donate
If you like this plugin, why not donate to help keep this project going.
35 Comments
kandasa
August 26, 2012Last update made all my pages that worked fine before, to be empty where runkeeper should be. I even tried the new tagg [runkeeper url=”…”] with same result.
Peter
August 31, 2012Hello, sorry to hear that the plugin isn’t working for you. I’ve made a couple of updates, can you try updating the plugin to version 2.2 and let me know if that solves the problem? If not, can you send me a link to an example page on your site where the runkeeper plugin is used?
Thanks
Peter
Peter Sejersen
August 21, 2012Thanks for the plugin. I’m also looking for a way to re-size the frame. I have tried, but the content in the frame gets cut off in the right side, see http://www.youareborntorun.com/ai1ec_event/137/?instance_id=9
Peter
August 22, 2012Hi, I’ve recently updated the plugin. The new version supports customising the iFrame size and offset. Please try updating and let me know if you have any more problems.
Thanks for the interest.
Peter
Peter Sejersen
August 30, 2012Hi Peter,
Thanks for the effort and fast reply. I have just updated the plugin and inserted the new shortcode in a post: http://www.youareborntorun.com/ai1ec_event/riis-skoven-revisited/?instance_id=21
But it doesn’t work.
Any ideas for how to fix?
Peter
August 31, 2012I think I’ve spotted the problem. Looks like the plugin was relying on the jQuery library which your site wasn’t using. I’ve updated the plugin to version 2.2 which doesn’t require jQuery. Hopefully, if you update again, that might solve the problem. Thanks for letting me know.
Peter
Peter Sejersen
September 4, 2012Cool. That fixed the problem, but the iframe i still cut off for some reason. Any suggestions? http://www.youareborntorun.com/ai1ec_event/riis-skoven-revisited/?instance_id=21
Btw: Thanks so much for helping 🙂
Peter
September 4, 2012Hi, I’ve taken a look at your example post and I think I’ve spotted the problem.
There is a style attribute in your theme’s stylesheet that is setting
embed, iframe, object{ max-width:100%; }If you either remove that style, or add another style to override it:
#runkeeper iframe{ max-width:inherit; }That should do the trick.
Let me know if you manage to sort it out.
Thanks
Peter
Peter Sejersen
September 4, 2012It worked, thanks!
Anders
July 3, 2012This is awesome!
However…
I have created a custom field called “runkeeper” and inserted the “share”-link from runkeeper.com.
But my page renders the iframe a bit strange, have a look:
http://bloggen.hyden.nu/2012/07/03/skon-kvallspromenad/
Any idea?
Anders
May 16, 2012Great plugin, but is it possible to change the size of the frame? Now I have to slide left and right to see all the information.
Peter
August 22, 2012Hi, I’ve recently updated the plugin. The new version supports customising the iFrame size and offset. Please try updating and let me know if you have any more problems.
Thanks for the interest.
Peter
Michael
February 17, 2012Just a small note… may want to update lines 43 and 44 to use
[code] href="'.WP_CONTENT_URL.'/plugins[/code]
instead of
[code]href="'.get_bloginfo('wpurl').'/wp-content/plugins[/code]
as it doesn’t work if you’ve renamed the wp-content folder. There are a few security plugins that will rename that folder. By changing the code, the plugin will still work for those people. Thanks!
Peter
August 22, 2012Thanks for the tip,
I’ve included that in the new version. Please check it out and let me know if you have any problems.
jake
February 1, 2012Any way to configure the size of the iFrame? Mine is extending into my sidebar by about 50 pixels or so.
Peter
August 22, 2012Hi, I’ve recently updated the plugin. The new version supports customising the iFrame size and offset. Please try updating and let me know if you have any more problems.
Thanks for the interest.
Mario
September 20, 2011Hi Peter,
Thanks for the plugin, it does work for me. However with two serious limitations:
1. It produces a box underneath ALL posts, even those without a custom ‘runkeeper’ field. A big empty box obviously disturbs the blog design.
2. It does not allow to put more than one map in one post, right? Something like that would be really helpful… And maybe a few options to adjust the size of the preview box manually.
Thanks for your help!
Mario
Jacob
August 12, 2011Hey, thanks for a lovely plugin, although there is one thing that concerns me.
On my summary page (where I list all my posts one after another), the runkeeper iframe is added to ALL posts that are published earlier than (or below) the post with the actual data, although they have no data of course since I have no value in my custom field.
In other words, I need something that kills the runkeeper session or really checks if there is a value in a particular post to prevent it from not displaying data for every post.
Is this possible?
best regards / Jacob
G
July 1, 2011Thanks so much for your work on this plug-in. In the future, might there be a configuration option to select a size for the frame, or is this limited by the data returned from RunKeeper.com? Example post: http://www.nafzinger.com/2011/07/01/thursday-brookside-ride-in-kansas-city/
Josh Feldberg
June 24, 2011This is brilliant. It really does work. I’d love to be able to add photos to the map but I don’t think this is possible
Per Soderlund
May 24, 2011New problem: If I have two runkeeper activities on the same page, only the topmost is showing. If I look at single posts the other activity shows up. Trying to find the problem, help appreciated!
Per Soderlund
May 23, 2011Okay. Sorry. Noticed in the header that the plugin directory is supposed to be “runkeeper-plugin”, I had named it simply “runkeeper”. Working now. So never mind my previous posts.
Thanks for the plugin though.
Per Soderlund
May 23, 2011Hmmm…seems like my pasted code was censored? You can find it live at: http://moonwork.se/maratonmannen
Per Soderlund
May 23, 2011Hi!
This plugin is exactly what I was looking for, just too bad I can’t make it work.
Adding the custom field “runkeeper” just adds this to the post:
An empty “runkeeper” div with correct title… Nothing visible on the post.
And in the head section:
Any Ideas?
By the way, new to WP so please explain as for an ignorant idiot, maybe I understand 🙂
Running WP ver. 3.1.2, downloaded rukeeper plugin from
Jon
March 5, 2011Hi Peter
Cool plug-in. Thanks. I managed to enter a custom field in my post and it displays the runkeeper shared URL fine. However, it seems have confused some other custom fields that I have for tweet this. On my home page now, all posts are attempting to show the runkeeper url I entered on one post. any idea how I rectify this.
Many Thanks
Jon
Michael
February 21, 2011ack, spell checkers!
That’s supposed to be jQuery version 1.4.2
[code]
[/code]
Peter
February 21, 2011Hi Michael,
You’re quite right, I managed to break the plugin in the new release. Looks like the path to the JS and CSS files has changed.
I’m going to release another revision which should fix it.
Sorry about that, let me know if you get it working after the next update.
Best of luck with the 40 LBS from a chilly Leeds!
Peter
Peter
February 21, 2011By the way, the new version no longer requires jQuery, that should make it more compatible for other users too.
Michael
February 21, 2011Greetings Peter.
First off, thanks for the contribution to both the Runkeeper and WordPress community.
I’m not sure if it is from today’s update to 1.10, but although I have the plugin activated, custom field created, and appropriate link defined, I’ve received failure of the plug-in to publish the preview here on http://to185.com/runkeeper-is-my/
The plugin appears to be attempting its job, in that it loads the stylesheet for the plugin
jQuery is indeed being called (a .4.2)
and the div id runkeeper is as well being loaded in the post.
I did however find a comment following that indicating, or perhaps hinting at the fact that PHP 5 is involved.
The server has as php5 as its default versrion.
After overriding that and forcing php4 to load, I have errors loading the site at all, so perhaps the error is something PHP related?
Hope this rundown helps you, as I’d really like to see this in play on my site. 🙂
Thanks again for your efforts.
Warm regards from chilly southwest Ohio,
Michael
Jan
February 13, 2011Here’s a post where Runkeeper preview should appear, but doesn’t
http://www.laufsachen.net/2011/02/runkeeper-preview-unter-diesem-post/
I think the problem might be “jQuery”. To be honest: I don’t have a clue if I have included this in my WP blog and if not how I should do this…
Sorry to bother you with these newcomer issues…
Peter
February 15, 2011Yes, that sounds like you might be right. The plugin does need jQuery to be installed to function.
I believe there are WordPress plugins which will include jQuery on your site for you. Otherwise you can download the jQuery javaScript file and include it the the header template.
I’m planning on doing an update at some point which will allow it to function without jQuery but I haven’t gotten around to it yet. Let me know how you go.
Jan
January 29, 2011Did all you said – doesn’t work. 🙁
Peter
February 12, 2011I’m sorry it’s not working for you. I’ve not had any other reports of problems with this. Can you send me an example of a post which you have attached a runkeeper field to so that I can see what markup, if any is being generated? Which other plugins are you using?
Jan
January 17, 2011Hi,
I have worked with custom fields before. Do you have a short guideline how to use runkeeper plug-in? Do I first have to modify my template and if so how / where?
Thanks
Jan
Peter
January 23, 2011You actually don’t need to modify your template at all. The plugin will insert the code to display the Runkeeper overview into the post. Just create a new custom field called “runkeeper” and paste the share code into it. The plugin will insert the Runkeeper overview following the body of the post.