=== Plugin Name ===
Contributors: tfotherby
Tags: graph,chart,custom fields,google chart API,
Requires at least: 2.0
Tested up to: 2.7
Stable tag: 0.0.2

A function for listing and plotting your data against time using the Google charts API. 

== Description ==

After [working out how to plot time-based data using Google charts API](http://www.tomfotherby.com/blog/index.php/2009/01/how-to-plot-dates-in-google-charts-api/ "A post from  my blog"), I created a Wordpress plugin to plot values stored in a custom field against the published-on date of a Wordpress blog post.

== Installation ==

1. Download 'fotherplot.php' and then upload it to your wordpress plugins directory (e.g. /wp-content/plugins/)
1. Install the [phpexec.php](http://wordpress.org/extend/plugins/exec-php/ "The phpexec.php plugin") plugin so you can run PHP code from pages and posts.
1. Activate both plugins through the 'Plugins' menu in the Wordpress dashboard.
1. Decide what the name of the custom field that you want to plot is going to be. e.g. "Weight".
1. If no posts exist that use the custom field, create a few posts with different publish dates that use the custom field.
1. To plot the chart, in one of your pages or posts (or a new page) put the following:

<phpcode>
<?php plotDataAgainstTime("customFieldName"); ?>
</phpcode>

== Screenshots ==

1. This screenshot is an Example of the chart the plugin produces.

== Frequently Asked Questions ==

* None yet

== Usage Example ==

I use this plugin to keep a track of my weight. I have a private Wordpress journal with a custom field called "Weight (kgs)" and each week when I make my journal entry I fill in my weight in this custom field. I have page called "My Weight" which is empty except for the following:

<phpcode>
<?php plotDataAgainstTime("Weight (kgs)"); ?>
</phpcode>

The plugin outputs [a image](http://chart.apis.google.com/chart?&cht=lxy&chs=450x300&chma=10,10,10,10&chds=0,364,98.9,116.1&chg=0,5&chxt=y,x&chxl=0:|98.9|102.34|105.78|109.22|112.66|116.1|1:|20/Jan/08|11/Feb/08|17/Jul/08|18/Oct/08|10/Jan/09&chm=D,FF0000,0,-1,1|o,000000,0,-1,4|N,000000,0,-1,9&chd=t:0,8,15,22,50,79,180,224,263,273,290,350,357,364|103.4,102.9,102.3,100.9,99.3,98.9,103.4,110.5,112.9,109.7,110,116.1,113.4,110.67 "Generated from Google Charts API") and a list of the relevant data:

<ul>
<li>January 17, 2009: 110.67kgs</li>
<li>January 10, 2009: 113.4kgs</li>
<li>January 3, 2009: 116.1kgs</li>
<li>November 5, 2008: 110kgs</li>
<li>October 18, 2008: 109.7kgs</li>
<li>October 8, 2008: 112.9kgs</li>
<li>August 30, 2008: 110.5kgs</li>
<li>July 17, 2008: 103.4kgs</li>

<li>April 8, 2008: 98.9kgs</li>
<li>March 10, 2008: 99.3kgs</li>
<li>February 11, 2008: 100.9kgs</li>
<li>February 4, 2008: 102.3kgs</li>
<li>January 28, 2008: 102.9kgs</li>
<li>January 20, 2008: 103.4kgs</li>
</ul>