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

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

See an example of how it works at the upper right panel (sidebar) of the author’s page on this blog.

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 sign in to your DOPPLR account in order to get an API key (URL provided).

Usage

To use it, there are two possibilities:

  • If your theme supports widgets, and you have installed the widget plugin 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.

License

This plugin is released under the GPL.

This plugin is provided with absolutely no support or warranty.

Version History

  • October 9 2007 - v1.0
    • Initial release to the public.
  • October 14 2007 - v1.1
    • Use the Dopplr AuthSub process.
  • January 13 2008 - v1.2
    • Add new method future_trips_info.
    • Add new option to display cities local time.
    • Cache Dopplr query results (Thanks to Boris Anthony for this suggestion).

Frequently Asked Questions

  • Is this plugin the official DOPPLR blog badge?

    No. Visit the Dopplr badge for your blog post to find out how to get the official DOPPLR blog badge.

  • Which are the plugin prerequisites?
    • A DOPPLR account and an API Key.
    • WP-DOPPLR uses cURL function calls, so your PHP installation must be compiled with cURL support.
    • WP-DOPPLR must be installed in the wp plugin’s directory (no subdirectories allowed).
  • 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_local_time(): returns a text var with the local time at your current location.
    • wpdopplr_trips_info(): returns an array with all your trips.
    • wpdopplr_future_trips_info(): returns an array with all your future trips.