This plugin hasn’t been tested with the latest three major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.



Fidgetr is a WordPress widget that displays the latest photos from your Flickr photostream in an attractive manner. It features support for its own themes along with very simple setup and compatibility with most WordPress themes. Check the changelog to see what’s new!

Fidgetr requires PHP 5.0 or newer as well as WordPress 2.8 or newer.

Catch new releases and other information about my plugins by following @reaperhulk on Twitter.

Theme Development FAQ

How do I make a theme?

Check out the basic.theme.php file in the themes directory to see a very basic example of how to parse the JSON structure that fidgetr outputs. You can also write PHP.

How do I make new themes show up in the configuration dropdown?

Simply create a file called yourname.theme.php with your data. If you have a CSS/JS supplement add those support files in a directory theme_includes/yourname/

Please note that in Fidgetr javascript files have a very strict naming structure to allow proper queueing via WP and reduce conflicts with other plugins. Your file must be named handle-ver-deps.js. Do not use – or _ in the handle as they are delimiters. Additionally, ver must be numeric. Multiple deps can be provided via underscore. Examples: slimbox-2.01-jquery.js , somelib-1.0-jquery_jquery-ui-core.js. Be sure to name your scripts correctly to avoid conflicts with other wordpress plugins.


Copyright 2010 Paul Kehrer

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA


  • The default theme before a mouseover.
  • The configuration panel for the widget.


  1. Upload fidgetr/ into wp-content/plugins/
  2. Activate the plugin via the ‘Plugins’ menu.
  3. Add/configure the widget via the ‘Widgets’ option under Themes.

To add themes to your Fidgetr install, copy the theme file to fidgetr/themes/ and any support files to fidgetr/themes/theme_files/theme_name

You can also invoke Fidgetr via $fidgetr->fidgetr_images()


Fidgetr won’t accept my username or email

Some users can’t locate their NSID via search due to privacy settings or age restrictions.. As of 1.2 Fidgetr allows you to specify your actual NSID in the username field. You can obtain it here: It’s on the right under “your user id”

Comments don’t appear in my theme/show up underneath other content! (iNove and others)

Typically this means you need to go into the CSS file for your theme (usually style.css) and remove the “overflow:hidden” line from the #sidebar section.

This widget looks terrible with Theme XXXXX!

Drop me a comment on the Fidgetr page and I’ll see if there’s a way to fix it without causing issues with other themes.


There are no reviews for this plugin.

Contributors and Developers

“Fidgetr” is open source software. The following people have contributed to this plugin.


Translate “Fidgetr” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Change Log


  • Fixed randomized array truncation. Oops. Thanks to everyone who reported.


  • Fixed links back to flickr for non-photo pools. Previous fix introduced yet another problem, woo.


  • Improved CSS for crossfade and default themes
  • Fixed links back to Flickr when using group pools.
  • Updated French translation (credit: Sebastien Violet)


  • Expanded randomization. (fetches 250 now)
  • You can now specify NSIDs of photo pools in addition to regular users.


  • Added option to randomize the images chosen from a photoset or latest images. This will pick randomly from the first 100 photos in the chosen set. Works with all themes.
  • Crossfade theme now attempts to center its images within the sidebar.
  • Changed the Flickr NSID regex to be more reliable. Credit Jeff Wishnie for the bug report.
  • Fixed includes to handle HTTPS properly.
  • Another AJAX username check fix (using to live bind events when adding new widgets in the admin panel)


  • Fixed AJAX username check
  • Compatible with WP 3.0!


  • Added french localization (credit: Sebastien Violet). More translations are welcome, please contact me if you’d like to help!
  • Corrected some HTML validation problems and other small coding style fixes (credit: Sebastien Violet)


  • Slimbox (lightbox) option for all themes. Check it on a per widget basis to have users go to a larger version inside Slimbox instead of being taken to the Flickr page.
  • Centered default theme when sidebar is larger than the images and other small CSS fixes.
  • Several improvements for Opera 10.5 pre-alpha (shadows, rounded corners)


  • The CSS change caused some trouble for many users. This should fix it (added the old rules in addition to the new + slightly more specificity)


  • Improve CSS specificity for all themes. This should improve the look of the widget in many cases.
  • Changed some JS load timing (faster when other page elements hang)
  • Upgraded slimbox to 2.03
  • Further simplified flickrApi class to solely use Snoopy (removed curl)


  • Improve title behavior when default theme shrinks/grows (white-space:nowrap)
  • Other small CSS fixes


  • Completely forgot to actually include the function and hook that did the photoset AJAX
  • Modified the flickrApi class to use Snoopy for data fetching. This should broaden compatibility.


  • Changing user updates available photosets via AJAX in the widget admin.
  • Refactored some functions.
  • Tested with WP 2.9.


  • Fidgetr now uses the multi-widget API. This was a very large rewrite so please let me know if you run into bugs you didn’t see in previous versions. Layout bugs are the most likely (especially in multi-widget scenarios).
  • Improved/fixed some more encoding behavior related to json_encode (and dramatically improved the behavior of the non-native function for those on older PHP5 installs)
  • Added timeout to prevent Flickr outages from hanging your blog. This may require additional error handling in the future.
  • Upgraded grid to slimbox 2.02
  • There would be more bullet points but the first one covers changes to nearly every file in the entire widget so what more can I say!


  • Better UTF-8 fix. Re-enabled native json_encode and removed an erroneous stripslashes. This should allow UTF-8 through, but also parse newlines in comments without a JSON parse failure.


  • UTF-8 fix. Disabled native json_encode until I can investigate why it’s hex encoding chars it shouldn’t be…


  • Tested against the latest WP
  • URL updates


  1. A few UI fixes. WP 2.8 compatibility flag.
  2. Fixed a JS problem with the AJAX username check exposed by 2.8.

View complete changelog.