flickrRSS Plugin Readme

This plugin allows you to display a flickr style badge (for a tag, user or group pool) on your WordPress site. It uses MagpieRSS to parse the RSS feed and display the images. This is my first attempt at a WordPress plugin, so you may run into some problems I hadn't considered. If you use the image cache, you'll need to remove old images manually.

Installation

  1. Put flickrrss.php in your plugins directory
  2. If you want to cache images, create a directory and make it writable
  3. Activate the plugin
  4. Configure your settings via the panel in Presentation
  5. Add <?php get_flickrrss(); ?> somewhere in your templates

Upgrading

If you're upgrading from flickrRSS 2.3, your installation will break, and you'll have to reconfigure the options panel (now found under the Presentation tab).

If you did something weird like including plugin hooks directly in your posts, you might have some work to do. I've changed how the parameters work, so it'll break the old references.

FAQ

  1. Can I get random images from my stream?
    Nope, it's a limitation of using the RSS feed (it only displays the last 10 photos)
  2. Can I get images from sets?
    Sorry, Flickr doesn't provide rss feeds for sets.
  3. Upgrading from 2.3?
    You'll need to reconfigure the options panel, and if you used parameters, it will probably break.

Advanced

The plugin also supports a number of parameters, allowing you to have multiple instances across your site.

  1. $num_items - how many photos you want to appear
  2. $type - specify user, public or group photosream
  3. $tags - a comma separated list of tags (with no spaces)
  4. $imagesize - square, thumbnail, medium or large
  5. $before_image - html appearing before each photo
  6. $after_image - html appearing after each photo
  7. $userid - specify a user id (or group name)

Example 1

<?php get_flickrrss(10, "public", "kittens,puppies"); ?>

This would show the 10 most recent public photos tagged with kittens or puppies.

Example 2

<?php get_flickrrss(5, "group", "", "thumbnail", "<li>", "</li>", "central"); ?>

This would show the 5 most recent thumbnail sized photos from the Flickr central group, and each photo would be wrapped in list tags.

Feedback and Support

Visit the Eightface forum for help getting the plugin working and styling the photos. I'll do my best to respond, but sometimes I'm slow.

If you're having huge issues, you can try contacting me directly.

Plugin History

Latest Release: August 24, 2006