Flickr photos is a plugin that enables you to display thumbnail links of Flickr photos in your Movable Type blog. The new version, 0.75, has many more features than the previous version. Flickr Photos focuses on displaying lists of photos, in many possible ways.

New Features

This version has many new features, including:

• display photos from a specific photo set
• display photos from a specific group pool
• display photos of the contacts of a specific user
• display the favorite photos of a specific user
• display recent photos from all Flickr users
• display photos based on search text
• display recent interestingness photos
• display detailed information about each photo (description, date taken, date uploaded, owner name, owner location, number of comments, and tags)
• display photos within a specified date range
• sort photo displays in various ways
• caching features for photo list and photo details to speed rebuilds
• install Sidebar Manager widget setting, displays recent photos in your sidebar

Here are few examples:

• Flickr Photoblog
• Flickr Photo Gallery
• Flickr Photo Sidebar (scroll down, on the right side of the page)

Basic Usage

You can easily list thumbnails by Filckr user and/or by Flickr tags. You can also control the number of thumbnails displayed and the size of the thumbnails. Each thumbnail can link to a larger version of the image, or to the Flickr page for that photo.

Here is an example of the easiest way to use FlickrPhotos in your templates:

<MTFlickrPhotos username="John Smith">
<MTFlickrPhotoLink> <br />
<br />
</MTFlickrPhotos>

The above template code will display thumbnail links for the 10 most recent photos for Flickr user "John Smith". (Tip: when entering the value for your 'username', you should use the name that appears after "Logged in as" on the top of each Flick page when you are logged in. Your user name may contain spaces - if so, be sure to include those space as I have done with "John Smith" above).

Here another example that displays thumbnail links from any user tagged with "movabletype":

<MTFlickrPhotos tags="movabletype">
<MTFlickrPhotoLink> <br />
<br />
</MTFlickrPhotos>

Advanced Usage and FlickrPhotos Template Tags

FlickrPhotos includes the following template tags:

• MTFlickrPhotos is container tag for displaying photos. arguments include:
  • username - restricts photos to a specific Flickr user.
  • tags - retricts photos to those with the specified tags. Multiple tags can be specified, separated by comma.
  • tag_mode - specifies the method for displaying photos by the tags argument. If tag_mode is set to 'any', it will display photos with at least one on the tags specified in tags. If tag_mode is set to 'all', it will only display photos tagged with each and every one of the tags specified by tags. Optional (the default value is 'any').
  • search - retricts photos to those with the specified search text
  • lastn - determines the number of photos to display. Optional (default is 10 photos).
  • sort - method to sort the photos. This must be one of date-posted-asc, date-posted-desc, date-taken-asc, date-taken-desc, interestingness-desc, interestingness-asc, or relevance (with 'asc' meaning ascending and 'desc' meaning descending). The default sort method is 'date-posted-desc', which displays the mosting recently uploaded photo first.
  • min_upload_date - restricts photos to those with a minimum upload date. Date should be specified as YYYY-MM-DD.
  • max_upload_date - restricts photos to those with a maximum upload date. Date should be specified as YYYY-MM-DD.
  • min_taken_date - restricts photos to those with a minimum taken date. Date should be specified as YYYY-MM-DD.
  • max_taken_date - restricts photos to those with a maximum taken date. Date should be specified as YYYY-MM-DD.

  Note that each of the above arguments can be used together, including at least 'username' and/or 'tags'. Arguments listed below are 'special' and cannot be used with many of the arguments above:

  • group - restricts the photos to those of a specific group pool. The group argument requires the complete URL of the group page or group pool page. For example <MTFlickrPhotos group="http://www.flickr.com/groups/catchy/">. When using the special group argument, you can further filter the photos by user the lastn, tags, and username arguments - but not the others described above.
  
  
  • set - restricts the photos to those of a specific photoset. The set argument requires the complete URL of the photoset page. For example <MTFlickrPhotos set="http://www.flickr.com/photos/markcarey/sets/55064/">. When using the special set argument, you cannot use the other arguments described above.
  
  
  • contacts - restricts the photos to those of the contacts of a specific user. The contacts argument requires that you also specify a username. When using the special group argument, you can further filter the photos by user the lastn argument and with the following: just_friends shows only photos from those contacts marked as friends, single_photo displays one photo from each contact, and include_user will display photos include photos from the user specified. For example <MTFlickrPhotos contacts="1" username="John Smith" single_photo="1" include_user="1">
  
  
  • favorites - restricts the photos to those of the favorite photos of a specific user. The favorites argument requires that you also specify a username. When using the special favorites argument, you can further filter the photos by user the lastn argument. For example <MTFlickrPhotos favorites="1" username="John Smith">
  
  
  • everyone - display recent photos from all Flickr users. When using the special everyone argument, you can further filter the photos by user the lastn argument. For example <MTFlickrPhotos everyone="1" lastn="10">
  
  
  • interestingness - display recent interesting photos from all Flickr users. When using the special interestingness argument, you can further filter the photos by user the lastn argument. For example <MTFlickrPhotos interestingness="1" lastn="15">

• MTFlickrPhotoThumb outputs the URL to the thumbnail image. The size of thumbnail is determined by the FlickrPhotos plugin settings (see below), which can be overidden by an optional size argument. For size, you can specify "s" (small square), "t" (thubmnail), "m" (small), "med" (medium), "o" (original size) Example usage: <img src="<MTFlickrPhotoThumb size="t">">
• MTFlickrPhotoURL outputs the destination URL that can be used to link each thumbnail. This URL will be to either to the Flickr photo page or directly to a different size of the photo, as determined by the plugin settings. These settings can be overidden by an optional target argument specifying the size of the photo to link to (see choices above) or "page" to link to the Flickr photo page. Example usage: <a href="<MTFlickrPhotoURL target="page">">
• MTFlickrPhotoTitle outputs the Flickr title for the photo. This can be used as "alt" text for the thumbnails, and/or used a caption for each photo.
• MTFlickrPhotoLInk combined each of the above tags - it outputs a linked thumbnail, using the title as the 'alt' and 'title' for the link. The link will open in a new window. This tag is the easiest way to use FlickrPhotos, becuase you don't have to write any HTML for creating the link or displaying the image. This tags supports both of th optional arguments described above, size and target.
• MTFlickrPhotoDateUploaded outputs the date that the photo was uploaded.
• MTFlickrPhotoDateTaken outputs the date that the photo was taken.
• MTFlickrPhotoDescription outputs the description of the photo. For this tag to work, the "Get Photo Details" setting must be turned on (see details below).
• MTFlickrPhotoOwnerName outputs the username or real name of the owner of the photo. In order to display the real name, the "Get Photo Details" setting must be turned on (see details below).
• MTFlickrPhotoCommentsCount outputs the number of comments that have beeb made on the photo. For this tag to work, the "Get Photo Details" setting must be turned on (see details below).
• MTFlickrPhotoCommentsCount outputs the number of comments that have beeb made on the photo. For this tag to work, the "Get Photo Details" setting must be turned on (see details below).
• MTFlickrPhotoTags is a container tag that displays each of the tags assigned to the photo. For this tag to work, the "Get Photo Details" setting must be turned on (see details below).
• MTFlickrPhotoTagName displays the name of the tag. Must be used between <MTFlickrPhotoTags> and </MTFlickrPhotoTags> tags. For this tag to work, the "Get Photo Details" setting must be turned on (see details below).
• MTFlickrPhotoTagURL displays the URL to the Flickr page for the tag for the photo's owner. Must be used between <MTFlickrPhotoTags> and </MTFlickrPhotoTags> tags. For this tag to work, the "Get Photo Details" setting must be turned on (see details below).
• MTIfFlickrPhotoTags is a conditional tag - anything between the <MTIfFlickrPhotoTags>. and </MTIfFlickrPhotoTags> tags will only be displayed if the photo has one or more tags. For this tag to work, the "Get Photo Details" setting must be turned on (see details below). Here is an example of how these tags can be used to display the tags of a photo:

  <MTIfFlickrPhotoTags>
  Tags for this photo: <br /> <ul>
  <MTFlickrPhotoTags>
  <li><a href="<MTFlickrPhotoTagURL>"><MTFlickrPhotoTagName></a> </li>
  </MTFlickrPhotoTags>
  </ul>
  </MTIfFlickrPhotoTags>

FlickrPhotos Plugin Settings

The following settings can bet set on a per-blog basis. To access these settings, select the blog you want and then choose "Settings" from the menu. Then choose the "Plugins" tab. You should then see FlickrPhotos in the list of plugins - hit the settings link to display the settings. The settings are:

• Thumbnail Size: This setting determines the size of the thumbnail images. Choice are Square, Thumbnail, Small, Medium, and Orginal. These sizes correspond to the sizes used by Flickr. The default is Thumbnail. This setting can be overidden by using the size argument as described above.
• Link to: This setting determines where each thumbnail will link to. You can link directly to a different size of the photo (you can choose from the same sizes as above) OR you can link each photo to the Flickr page for that photo. The default is Flickr Page This setting can be overidden by using the target argument as described above..
• Number of Photos: The default numbers of photos to display. The default is 10. You can override this by using the 'lastn' argument (for example, <MTFlickrPhotos username="John Smith" lastn="15"> )
• Photo List Cache: The length of time to cache the list of photos. After the above time frame has passed, FlickPhotos will check with Flickr to see if there are any new photos. It is highly recommended that this setting be set to 1 hour or longer. Choosing 'none' may slow down your rebuilds considerably. You can override this setting on a case by case basis by specifying the number of seconds in the refresh argument (for example, to set the Photo List Cache to 1 hour you could use <MTFlickrPhotos username="John Smith" refresh="3600"> )
• Photo Info Cache: The length of time to cache the detailed information for each photo (title, tags, description, number of comments, etc.). After the above time frame has passed, FlickPhotos will check with Flickr to see if there have been any changes to the photo information. It is highly recommended that this
  setting be set to 1 week or longer. Choosing 'none' may slow down your rebuilds considerably. You can override this setting on a case by case basis by specifying the number of seconds in the refresh_details argument (for example, to set the Photo Info Cache to 2 weeks you could use <MTFlickrPhotos username="John Smith" refresh_details="1209600"> )
• Clear Cache Older Than: This setting will delete cache information about photo lists and photo details that are older than the time frame selected above. This is useful to remove data for older photos that you are no longer displaying, thus preventing your database from growing too large. It is recommended that this setting be set to 1 month or longer. Choosing 'Never' may cause your database to grow sigificantly larger, depending on how you use the plugin. IMPORTANT: With this setting, the cache will not be cleared automatically. To clear the cache you MUST return to this Plugin settings page. To prevent slow rebuilds, the cache-clearing function only runs when you access the Plugin settings page. Also note that this setting is global, meaning that it applies to photo cache data for all of your blogs.
• Get Photo Details: If set to "On", FlickrPhotos will ask Flickr for some details about each photo. Photo details includes the following: description (<MTFlickrPhotoDescription> ), number of comments
  (<MTFlickrPhotoCommentsCount> ), owner location (<MTFlickrPhotoOwnerLocation> ), and tags (<MTFlickrPhotoTags> ). If you are not displaying these tags on your pages, you can change this setting to "Off" to improve perfomance and speed rebuild times. You can override this setting on a case by case basis by using the "fetchdetails" argument (for example, <MTFlickrPhotos username="John Smith" fetchdetails="1"> )
• Install Sidebar Widget: Checking the box for this setting and entering a Flickr username will automatically install a Sidebar widget that displays 5 recent photos. You can then customize this by editing the "Sidebar: FlickrPhotos" template module, which will be created after checking this option. This setting works with the Sidebar Manager plugin: Learn more about Sidebar Manager.

Requirements:

• MT 3.2
• Flickr::API Perl Module (included in download for convenience)
• XML:: Parser::Lite (included for convenience)
• XML:: Parser::Lite::Tree (included for convenience)
• XML:: Parser::Lite::Tree::XPath (included for convenience)

Download Now

Download the plugin by clicking here.

Installation

1. Expand the zip file and upload the contents of the 'plugins' folder to the 'plugins' directory of your MT installation and the contents of the 'extlib' folder to the 'extlib' folder of your MT installation.
2. Adjust the plugin settings if desired (see above)
3. Start using the above template tags in your templates.

If you like this plugin, please consider making a donation:

This plugun is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 2.5. In other words, if you use this plugin, please display a "powered by Flickr Photos" link, such as the one below:

<a href="http://mt-hacks.com/flickrphotos.html" target="_blank">Powered by Flickr Photos</a>

As always, please let me know if you find any bugs, or if you have any suggestions or comments.