=== Plugin Name ===
Contributors: frodenas
Tags: dopplr, travel, badge, sidebar, widget
Requires at least: 1.5 or higher
Tested up to: 2.3
Stable tag: 1.0

WP-DOPPLR is a Wordpress plugin that displays your DOPPLR information on your blog.

== Description ==

WP-DOPPLR is a Wordpress plugin that displays your [DOPPLR](http://www.dopplr.com/) information on your blog.

It can be used as a widget or directly as a PHP call in the theme.

== Installation ==

1. Download WP-DOPPLR.
2. Decompress and upload the contents of the archive into /wp-content/plugins/.
3. Activate the plugin on your WP Admin > Plugins page by clicking 'Activate' at the end of the 'WP-DOPPLR' row.
4. Configure the plugin on your WP Admin > Options > WP-DOPPLR page. You must get and enter a DOPPLR API key (URL provided).
5. To use it, there are two possibilities:
* If your theme supports widgets, and you have installed the [widget plugin](http://wordpress.org/extend/plugins/widgets/) or you are using Wordpress 2.2 or higher, add the WP-DOPPLR widget on your WP Admin > Presentation > Widgets page.
* Add <?php wpdopplr_badge() ?> at the place in the theme you want the DOPPLR information to appear.

== Frequently Asked Questions ==

= Is this plugin the official DOPPLR blog badge? =

No. Visit the [Dopplr badge for your blog](http://blog.dopplr.com/index.php/2007/10/08/dopplr-badge-for-your-blog/) post to find out how to get the official DOPPLR blog badge.

= Which are the plugin prerequisites? =

* A [DOPPLR](http://www.dopplr.com/) account and an API Key.
* WP-DOPPLR uses [cURL](http://curl.haxx.se/) function calls, so your PHP installation must be compiled with cURL support.

= Can I modify the widget look & feel? =

The DOPPLR widget information is in a <div class="wpdopplr"> ... </div>. So to modify the look & feel more precisely, just set the css properties of .wpdopplr.

= Can I customise the information that it is displayed? =

If you are using the widget, you can not customize the information that it is displayed.

If you are calling the plugin directly in you theme, you can use these PHP functions:

* wpdopplr_badge(): prints your current status and all your future trips.
* wpdopplr_traveller_info(): returns a text var with your current status.
* wpdopplr_trips_info(): returns an array with all your future trips.

== Contributors/Changelog ==

	Version Date       Changes
	1.0     2007/10/09 Initial release

== Screenshots ==

1. WP-DOPPLR Options Panel
2. Widget activation