Flickr photos is a plugin that enables you to display thumbnail links of Flickr photos in your Movable Type blog. Flickr Photos focuses on displaying lists of photos, in many possible ways.
The new version, 0.80, has a few bug fixes and a few new features. The majority of these improvements were contributed by Annoying Old Guy, of Solid Wall of Code. Thanks, AOG!
New Features and Bug Fixes
Bug Fixes and Tuning:
-bug fix for MTFlickrPhotoTagURL, should now create correct links
-adjusted HTML in MTFlickrPhotoLink to be xhtml valid
-added a fix to an upgrade problem from v0.5 - if you receive errors after upgrading from v0.5, loading the plugin settings page should now fix it
-code optimizations to improve perfomance
-fixed a bug that was clearing configuration settings
-moved Expressions.pm to correct location to avoid conflicts
Features (details below):
-new tags for photo height and width
-added class elements to the FlickrPhotoLink tag for customization via CSS
-support for setting size and link arguments in MTFlickrPhotos container tag
-support for Plugin Manager (untested, as I was unsuccessful in installing Plugin Manager on my server, use with caution, feedback appreciated)
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 Flickr 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:
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
FlickrPhotos.zip
else :
?>
Membership required, please sign-in or register:
endif;
?>
Installation
- 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.
- Adjust the plugin settings if desired (see above)
- 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>
Update: Included with this plugin is the MT Plugin Network plugin. MT Plugin Network helps keep you up to date about new and updated plugins from MT Hacks and other plugin providers, by displaying a list of recent plugin announcements with the MT admin area. Click here to learn more.
As always, please let me know if you find any bugs, or if you have any suggestions or comments.