Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
A jQuery plugin for viewing Flickr Photostreams in a Fancybox gallery
JavaScript
Tag: 0.5.0

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
demo
src
CHANGELOG.md
MIT_LICENSE.txt
README.md
jquery.fancy-photoset.js
jquery.fancy-photoset.min.js

README.md

Fancy Photoset

The Fancy Photoset plugin utilizes the power of jQuery and Fancybox to dynamically create photo galleries from your Flickr Photosets.

Requirements

This plugin requires the latest version of the jQuery library. It has been tested on 1.4.2 but should work on 1.3.2+.

This plugin depends on the Fancybox plugin. It has been tested on version 1.3.1.

You will also need a Flickr account and a Flickr API Key to use this plugin.

Usage

The fancyPhotoset method is called on a jQuery selector and takes an options hash as the only argument. A Flickr API Key and Photoset ID are the only required options.

Typical usage:

<div id="gallery"></div>

<script type="text/javascript" charset="utf-8">
$(function() {
  // create a gallery with the default options
  $('#gallery').fancyPhotoset({apiKey: 'xxx', photosetId: 'xxx'});
});
</script>

The plugin supports multiple photoset galleries per page:

<div id="gallery1"></div>
<div id="gallery2"></div>

<script type="text/javascript" charset="utf-8">
$(function() {
  // create a gallery with custom options
  var options1 = {
    apiKey: 'xxx',
    photosetId: 'xxx',
    captions: true,
    small: 'thumbnail',
    large: 'medium'
  };

  var options2 = {
    apiKey: 'xxx',
    photosetId: 'yyy',
    captions: false,
    small: 'square',
    large: 'original'
  };

  $('#gallery1').fancyPhotoset(options1);

  $('#gallery2').fancyPhotoset(options2);
});
</script>

Options

  • apiKey - Your Flickr API Key.
  • photosetId - The ID of the photoset you want to load.
  • small - The smaller thumbnail version of the image to show. This corresponds to one of the following Flickr sizes: square, thumbnail, small, medium and original.
  • large - The larger version of the image link to and display in the Fancybox. This corresponds to one of the following Flickr sizes: square, thumbnail, small, medium and original.
  • captions - true or false: This will create a with the photo title if set to true.
  • firstOnly - true or false: Setting true will only display the first image in the photoset on the webpage. All images will still be available to the Fancybox gallery.
  • fancybox - These are standard Fancybox options that get passed through to the fancybox method.

Demo

See the demo.html file in the demo folder for an example of how to use the script. All you will need to run the demo is your API Key and a Photoset ID.

Version

The current version is 0.5.0

TODO

License

The Fancy Photoset plugin is licensed under the MIT (MIT_LICENSE.txt) license.

Copyright (c) 2010-2011 Phil Cohen

Something went wrong with that request. Please try again.