=== Runners Log ===
Contributors: frold
Donate link: http://www.liljefred.dk
Tags: plugin, sport, training, running, activity log, fitness, stats, statistics, garmin
Requires at least: 2.7
Tested up to: 2.9
Stable tag: 1.0.7

This plugin lets you convert your blog to a training log with an advance statistics and graphs.

== Description ==
This plugin lets you convert your blog to a training log with an advance statistics and graphs.
Based on 4 custom fields:

*   Meters
*   Time
*   Pulsavg
*   GarminConnectLink

it lets you calculate your speed, time per km, and lets you have charts of your total distance and minutes per month.

== Installation ==

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

1. Copy all files to `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Place `<?php runners_log_basic(); ?>` in your templates to have basic statistics. It gives you data like: 
    * Meters: 9270
    * Time: 01:00:00
    * Km/hour: 9.27
    * Min/km: 06:28 minutes
    * Puls average: 162
    * Garmin Connect Link: http://connect.garmin.com/activity/21097094
    * Total meters run in 2009: 171610 in km: 171.61
4. Place `<?php runners_log_graph(); ?>` in your templates to have graph based statistics. It gives you a chart of your total distance and hours per month.
5. You only want to have the chart and stats to show up in the category where the sports data is then see FAQ.
6. Every time you post an activity in your Sport or Traing Category add the custom fields: `Meters` and `Time`. Its optional to put in `Pulsavg` and `GarminConnectLink` for your cours.
7. `Time` needed to be formated as HH:MM:SS eg. like `00:37:20` for 37min and 20 seconds.
8. Runners Log let you use the following tags in your template:
    * `<?php runners_log_basic(); ?>`
	* `<?php runners_log_graph(); ?>`
	* `<?php runners_log_pie_hours(); ?>`
	* `<?php runners_log_pie_km(); ?>`
	* `<?php runners_log_bar_km(); ?>`
	* `<?php runners_log_bar_hours(); ?>`
	* `<?php runners_log_graphmini_km(); ?>`
	* `<?php runners_log_graphmini_hours(); ?>`

== Frequently Asked Questions ==

= I only want my graphs to show up in a special category =
If you only want your graphs to show up in the category "training" with the category ID = 6 then use it like this eg in single.php:

    * `<?php if ( in_category('6') ): ?>`
    * `<?php runners_log_basic(); ?>`
	* `<?php runners_log_graph(); ?>`
	* `<?php runners_log_pie_hours(); ?>`
	* `<?php runners_log_pie_km(); ?>`
	* `<?php runners_log_bar_km(); ?>`
	* `<?php runners_log_bar_hours(); ?>`
	* `<?php runners_log_graphmini_km(); ?>`
	* `<?php runners_log_graphmini_hours(); ?>`
	* `<?php endif; ?>`
	
= I only want my graphs to show up in a special page =
If you only want your graphs to show up in the page with the name "Training Stats" then use it like this eg. in page.php:
BE WARE: <?php runners_log_basic(); ?> only works in categories

    * `<?php if (is_page('Training Stats')) { ?>`
	* `<?php runners_log_graph(); ?>`
	* `<?php runners_log_pie_hours(); ?>`
	* `<?php runners_log_pie_km(); ?>`
	* `<?php runners_log_bar_km(); ?>`
	* `<?php runners_log_bar_hours(); ?>`
	* `<?php runners_log_graphmini_km(); ?>`
	* `<?php runners_log_graphmini_hours(); ?>`
	* `<?php } ?>`

= What does this plugin require =
Runners Log is using pChart and therefore is using the GD library to create pictures. 
You must compile the GD library with the freetype extension when installing PHP on a linux server. 
On windows operating system you must add the GD extension in your php.ini file. GD support is a mandatory prerequisite and cannot be overriden. 
You can use the following tutorial http://www.e-gineer.com/v1/instructions/install-gd13-for-php-with-apache-on-linux.htm if you don't know how to install it on a linux server.

= Why is my server load high? =
If you have a very visited blog and using this plugin it could cause high server load as this plugin doesn't use cache for rendering the graphs.
If that's a problem either uninstall this plugin, help making it work with cache :D or wait for a later release.

== Screenshots ==

1. show you how your custom fields should look like
2. an example of using `<?php runners_log_basic(); ?>`
3. an example of using `<?php runners_log_graph(); ?>`
4. an example of using `<?php runners_log_pie_hours(); ?>`
5. an example of using `<?php runners_log_pie_km(); ?>`
6. an example of using `<?php runners_log_bar_km(); ?>`
7. an example of using `<?php runners_log_bar_hours(); ?>`
8. an example of using `<?php runners_log_graphmini_km(); ?>`
9. an example of using `<?php runners_log_graphmini_hours(); ?>`

== Changelog ==

= 1.0.0 =
* Initial Release

= 1.0.1 =
* Fixing Screenshots

= 1.0.2 =
* Fixing Screenshots again

= 1.0.3 =
* Fixing if ( category ID = 6 ) { and moved it to templates. This way its easier to upgrade Runners Log

= 1.0.4 =
* More info to readme.txt

= 1.0.5 =
* Optimazing code
* Added 2010 to runners_log_basic()

= 1.0.6 =
* Added the number of run per year and avg per run like: Km in 2009: 693.7 km based on 122 runs with an avg of 5.69 km
* New runners_log_basic() screenshot
* In runners_log_bar_hours() runhours is rounded to 2 instead of 4 decimals

= 1.0.7 =
* The jared^ release

== Upgrade Notice ==

= 1.0.0 =
This was the initial release Januar 1st 2010

= 1.0.5 =
This was release Januar 2nd 2010

= 1.0.6 =
This was release Januar 3rd 2010


== Screenshots explanation ==

	* screenshot-1.png show you how your custom fields should look like
	* screenshot-2.png an example of using `<?php runners_log_basic(); ?>`
	* screenshot-3.png an example of using `<?php runners_log_graph(); ?>`
	* screenshot-4.png an example of using `<?php runners_log_pie_hours(); ?>`
	* screenshot-5.png an example of using `<?php runners_log_pie_km(); ?>`
	* screenshot-6.png an example of using `<?php runners_log_bar_km(); ?>`
	* screenshot-7.png an example of using `<?php runners_log_bar_hours(); ?>`
	* screenshot-8.png an example of using `<?php runners_log_graphmini_km(); ?>`
	* screenshot-9.png an example of using `<?php runners_log_graphmini_hours(); ?>`

== To Do ==

	* enable cache
	* more graphs 
	* add miles support