/*

 * jQuery Flickr - jQuery plug-in

 * Version 1.0, Released 2008.04.17

 * Added to Mike Forsyth for Falconry Images (2010)

 * Copyright (c) 2008 Daniel MacDonald (www.projectatomic.com)

 * Dual licensed GPL http://www.gnu.org/licenses/gpl.html 

 * and MIT http://www.opensource.org/licenses/mit-license.php

 */

(function($) {

$.fn.flickr = function(o){

var s = {

    api_key: null,              // [string]    required, see http://www.flickr.com/services/api/misc.api_keys.html

    type: null,                 // [string]    allowed values: 'photoset', 'search', default: 'flickr.photos.getRecent'

    photoset_id: null,          // [string]    required, for type=='photoset'  

    text: null,			            // [string]    for type=='search' free text search

    user_id: null,              // [string]    for type=='search' search by user id

    group_id: null,             // [string]    for type=='search' search by group id

    tags: null,                 // [string]    for type=='search' comma separated list

    tag_mode: 'any',            // [string]    for type=='search' allowed values: 'any' (OR), 'all' (AND)

    sort: 'date-posted-asc',    // [string]    for type=='search' allowed values: 'date-posted-asc', 'date-posted-desc', 'date-taken-asc', 'date-taken-desc', 'interestingness-desc', 'interestingness-asc', 'relevance'

    thumb_size: 's',            // [string]    allowed values: 's' (75x75), 't' (100x?), 'm' (240x?)

    size: null,                 // [string]    allowed values: 'm' (240x?), 'b' (1024x?), 'o' (original), default: (500x?)

    per_page: 100,              // [integer]   allowed values: max of 500

    page: 1,     	              // [integer]   see paging notes

    attr: '',                   // [string]    optional, attributes applied to thumbnail <a> tag

    api_url: null,              // [string]    optional, custom url that returns flickr JSON or JSON-P 'photos' or 'photoset'

    params: '',                 // [string]    optional, custom arguments, see http://www.flickr.com/services/api/flickr.photos.search.html

    api_callback: '?',          // [string]    optional, custom callback in flickr JSON-P response

    callback: null              // [function]  optional, callback function applied to entire <ul>



    // PAGING NOTES: jQuery Flickr plug-in does not provide paging functionality, but does provide hooks for a custom paging routine

    // within the <ul> created by the plug-in, there are two hidden <input> tags, 

    // input:eq(0): current page, input:eq(1): total number of pages, input:eq(2): images per page, input:eq(3): total number of images

    

    // SEARCH NOTES: when setting type to 'search' at least one search parameter  must also be passed text, user_id, group_id, or tags

    

    // SIZE NOTES: photos must allow viewing original size for size 'o' to function, if not, default size is shown

  };

  if(o) $.extend(s, o);

  return this.each(function(){

    // create unordered list to contain flickr images

		var list = $('<ul>').appendTo(this);

    var url = $.flickr.format(s);

		$.getJSON(url, function(r){

      if (r.stat != "ok"){

        for (i in r){

	        $('<li>').text(i+': '+ r[i]).appendTo(list);

        };

      } else {

        if (s.type == 'photoset') r.photos = r.photoset;

        // add hooks to access paging data

        list.append('<input type="hidden" value="'+r.photos.page+'" />');

        list.append('<input type="hidden" value="'+r.photos.pages+'" />');

        list.append('<input type="hidden" value="'+r.photos.perpage+'" />');

        list.append('<input type="hidden" value="'+r.photos.total+'" />');

        for (var i=0; i<r.photos.photo.length; i++){

          var photo = r.photos.photo[i];

          // format thumbnail url

          var t = 'http://farm'+photo['farm']+'.static.flickr.com/'+photo['server']+'/'+photo['id']+'_'+photo['secret']+'_'+s.thumb_size+'.jpg';

          //format image url

          var h = 'http://farm'+photo['farm']+'.static.flickr.com/'+photo['server']+'/'+photo['id']+'_';

          switch (s.size){

            case 'm':

              h += photo['secret'] + '_m.jpg';

              break;

            case 'b':

              h += photo['secret'] + '_b.jpg';

              break;

            case 'o':

              if (photo['originalsecret'] && photo['originalformat']) {

                h += photo['originalsecret'] + '_o.' + photo['originalformat'];

                break;

              };

            default:

              h += photo['secret'] + '.jpg';

          };

          list.append('<li><a href="'+h+'" '+s.attr+' title="'+photo['title']+'"><img src="'+t+'" alt="'+photo['title']+'" /></a><span class="caption">'+photo['title']+'</span> </li>');

        };

        if (s.callback) s.callback(list);

      };

		});

  });

};

// static function to format the flickr API url according to the plug-in settings 

$.flickr = {

    format: function(s){

        if (s.url) return s.url;

        var url = 'http://api.flickr.com/services/rest/?format=json&jsoncallback='+s.api_callback+'&api_key='+s.api_key;

        switch (s.type){

            case 'photoset':

                url += '&method=flickr.photosets.getPhotos&photoset_id=' + s.photoset_id;

                break;

            case 'search':

                url += '&method=flickr.photos.search&sort=' + s.sort;

                if (s.user_id) url += '&user_id=' + s.user_id;

                if (s.group_id) url += '&group_id=' + s.group_id;

                if (s.tags) url += '&tags=' + s.tags;

                if (s.tag_mode) url += '&tag_mode=' + s.tag_mode;

                if (s.text) url += '&text=' + s.text;

                break;

            default:

                url += '&method=flickr.photos.getRecent';

        };

        if (s.size == 'o') url += '&extras=original_format';

        url += '&per_page=' + s.per_page + '&page=' + s.page + s.params;

        return url;

    }

};

})(jQuery);