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 left of the ‘WP-DOPPLR’ row.
  4. Configure the plugin on your WP Admin > Settings > 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 options:

  • Add the WP-DOPPLR widget on your WP Admin > Appearance > 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 method local_time.
    • Add new option to display cities local time.
    • Cache Dopplr query results (Thanks to Boris Anthony for this suggestion).
  • November 5 2008 – v1.4
    • Add new method past_trips_info.
    • Add new option to display past and future trips.
    • Add new option to display start and finish trip dates.
    • Add new option to modify the date and time format.
    • Add new option to display city colours.
    • Add new option to display countries.
  • June 10 2009 – v1.5
    • Bug: Determine the correct wp-content directory.
  • September 14 2009 – v1.6
    • Bug: Determine the correct local date & time.
    • Add new option to specify cities links.
    • Add new option to specify cities colour type.
    • Add new option to dismiss the API key.
    • Add new option to clear the cache contents.
    • Enhance settings and widget menu.
    • Enhance installation process (subdirectories allowed).
    • Translatable strings (internationalization).

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 needs PHP version >= 5.1.0.
    • WP-DOPPLR uses cURL 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 badge.
    • 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_past_trips_info(): returns an array with all your past trips.
    • wpdopplr_future_trips_info(): returns an array with all your future trips.