FlickrViewer 1.2.3

FlickrViewer is a free PHP script which allows SimpleViewer 1.8 to get its data from the oh-so-popular Flickr. You can see a working demo on http://dustinsenos.com/photos/

Requirements

• SimpleViewer 1.8
• Hosting which supports PHP 4+
• Flickr API Key
• Write access if you want to use caching

Download

• FlickrViewer 1.2.3 (zip file - 8kb)
• SimpleViewer 1.8

Technical

• Caches results to increase performance and decrease the load on your Flickr API key
• Supports most SimpleViewer XML options
• Fetches data via fopen or curl to support most hosts
• Original FlickrViewer source by Mark Sweeting

Installation

1. Apply for a Flickr API key at http://www.flickr.com/services/api/misc.api_keys.html write down / save the API key to a file. You will need this later
2. Browse to the Flickr Set that you want FlickrViewer to display. Make note of the url of the set. We are interested in the last digits: http://www.flickr.com/photos/dustin_senos/sets/72157600076504544/ write down / save these numbers with your API Key
3. Download both FlickrViewer & SimpleViewer 1.8
4. Unzip the files to your local machine
5. Open flickrViewer.php in your text editing software. I suggest TextMate (OS X) or Programmers Notepad 2 (Windows) however any text editing software will work
6. Look for the variable $apikey in flickrViewer.php and add the API key that you saved from Flickr earlier
7. Scroll down to the $setid variable and add the set id you saved earlier
8. Continue scrolling down in flickrViewer.php and read the info about the various options. Edit these as you see fit, you can always come back to them later
9. Open index.htm which was located in the FlickrViewer zip file in your text editing software. Change the title, description and keywords to match your site content
10. Connect to your server with your FTP software of choice. I recommend Transmit 3 (OS X) or SmartFTP (Windows)
11. First upload the files from SimpleViewer 1.8. Then upload the FlickrViewer files, say yes to any overwrites
12. Create a folder called 'tmp' in the same directory you uploaded FlickrViewer & SimpleViewer to. Set its permissions to Read/Write
13. Check it out!
14. If there are issues, try setting $debug to true. Changing $ttl to 0 and $usecurl to true

Support

For the fastest response check out the FlickrViewer forum on SourceForge. Or you can email me at dustin@dustinsenos.com. I read all emails, but might take a bit to respond. Hold tight.

Warning

FlickrViewer HAS NOT been excessively tested. Use at your own risk.

Updates

June 27th 2007

Fixed caching issue and updated XHTML & CSS. Zip also includes updated swfObject 1.5

June 10th 2007

Updated to allow the option of using either curl or fopen to fetch the data from Flickr.

November 20th 2007

Updated $thumbnailColumns, thanks Corey!

Sites using FlickrViewer

• Haobam Martin Photography