ScrewTurn Plugin: Flickr

== Overview ==
This [[ScrewTurn Wiki]] plug-in will put a grid of thumbnail photos from a [http://flickr.com|flickr.com] PhotoSet you specify right into your page. This is version 1.0 and has very little options. I plan on updating it with the ability to supply parameters to configure per page (like how big of thumbnails, how many columns, HTML formatting, etc).

<font color=red><b>Note:</b></font> Due to the poor way that Flickr's API works, large photo sets can make page loading slow as several requests to Flickr must be made to get all the data. I must make one call to get a list of photos, then I must make another call for each photo to get its description. So if there are 40 photos in a set, that's 41 web requests I must make to Flickr. Unless Flickr updates their flickr.photosets.getphotos api, there's really not much I can do other than not retrieve the description of the photo (which in my usage of this plug-in on hossweb.com, I need).

==Download==
You can download the built plugin from the below link. Later once I add some features and clean up the code with better commenting, I will include the source code as well.
* [{UP}/ScrewTurn Plugin Flickr/FlickrPlugin.zip|FlickrPlugin.zip]

== Instructions ==
=====Installation=====
To install this (or any) plugin in your working STW, follow  [http://www.screwturn.eu/Provider.ashx#D_-_Installing_new_Providers_10|these instructions].

<font color=red>You will need to get an [http://www.flickr.com/services/api/keys/apply/|API Key] from Flickr to use this plugin!</font> After you install the plugin with the above instructions, you will need to put your API Key in the configuration string (above instructions explain this, but on the providers tab of the admin control panel for ScrewTurn Wiki, you can click the FlickrPlugin and then click the Configure button which will present a textbox for you to put your API Key in..

=====Usage=====
To use this plugin, simply enter in the below wiki markup into any of your wiki pages...<br>
{{{{ &#0123;PhotoSet:FlickPhotoSetID&#0125; }}}}

Example:<br>
{{{{ &#0123;PhotoSet:72157621907609381&#0125; }}}}

When the page is rendered to the user, everywhere you had the above text in the page, you will see a table of photos from the photoset ID you specified.

== Feedback ==
Feel free to use the "discuss" link near the top roght of this page to leave feedback or questions you have about this plugin.
Hossweb.com

Site Pages

Family & Home

Robotics

Vehicles

Misc

ScrewTurn Plugin: Flickr
