This is a plugin for Wordpress that allows you to embed a flickr integrated
simpleviewer into your Wordpress site. In additional, you are able to specific a path
to a standard SimpleViewer XML configuration file to display images from a local gallery.

Release Notes

Version 3.0:

• Complete overhaul of the code base.
• Upgraded to version 1.8.5 of SimpleViewer flash application.
• Upgraded to swfobject 2.0. This should solve some flash upgrade request issues.
• Added ability to set xmldatapath directly for displaying local galleries.
• Options added/removed to work with new version of SimpleViewer.
• Updated Admin page to have integrated look and feel with Wordpress 2.5+.
• HTML output now standards compliant for both page/post output and admin pages.

Version 2.5.3:

• Updated and tested with Wordpress 2.5.

Version 2.5.2:

• Added background transparency attribute to plugin. Thanks to David Pitman for the code update.

Version 2.5.1:

• Fixed bug with setting some attributes to 0 (thumbnailrows and thumbnailcolumns for example).
• Altered image calls to Flickr to increase speed. Setting image size to ‘Medium’ is faster.

Version 2.5:

• Added TinyMCE quick tag button for SimpleFlickr to the Wordpress editor.
• Added ability to alter the image link text displayed for a given photo.
• Added ability to set the size of the images that are returned from flickr. (Including Original size)
• Added ability to set the privacy filter for what images are returned from flickr.

Version 2.1:

• Fixed flash detection and express install by updating to Unobtrusive Flash Objects (UFO) script.

Version 2.0.1:

• Fixed title to allow and save blank titles.
• Fixed ‘View flickr photo page..’ links when showing group pools.

Version 2.0:

• Revamped Data calls to use phpFlickr library (version 2.1.0).
• Combined code into one class and php page.
• Removed use of flickrviewer.
• Upgraded to SWFObject 1.5 and added express install feature.
• Added user authentication so private photos can now be displayed.
• Added ability to display photos from a given group.
• Added ability to display recent user photos.
• Added ability to show/hide image caption and image link in simpleviewer.
• Fixed thumbnailrow and thumbnailcolumn zero settings so they work now.

Version 1.2.2:

• Fixed compatibility with ‘All in One SEO Pack’ Plugin.
• Fixed plugin directory name dependency. Directory can now be named anything.
• Added simpleFlickr tag version to plugin. Now SIMPLEFLICKR, simpleflickr, and simpleFlickr available.
• Added group option. Now can display a selection photos from a group. The ‘group’ attribute takes precedence over ’set’ attribute.

Version 1.2.1:

• Modified flickrviewer to use check for curl or fopen and use either if available
• Updated instructions to explain the installation in more detail

Version 1.2:

• Modified flickrviewer to use curl instead of fopen

Version 1.1:

• Added default parameters to options configuration page

Version 1.0:

• Initial release tested only on version 2.1 of Wordpress
• Using version 1.8 of SimpleViewer
• Using a modified version 1.1 of Flickrviewer

Like this plugin?

 

Download

current version: SimpleFlickr Plugin 3.0
old version: SimpleFlickr Plugin 2.5.3

Demo

Click Here to see a demo.

Upgrading

The easiest way to upgrade to version 2.0 from previous versions is to deactivate the plugin in wordpress and delete the plugin folder from your web server. Once the new plugin files have been uploaded and you have activated the plugin in wordpress then you have authorized the new plugin with flickr before you can use the plugin. It is also suggested to update your options to resave the values in the database to make sure you have all the latest option values saved.

Installation

1. Extract all the contents of the plugin archive into your ‘wp-content/plugins/simpleFlickr’ directory.
2. Go to your wordpress admin pages and click on ‘Plugins’ and activate the plugin called ’simpleFlickr’.
3. Go to your wordpress admin and click on ‘Options’ then ’simpleFlickr’.
4. Following the instructions to authorize the plugin with flickr. (You only do this once initially.)
5. Set your configuration option values and click ‘update options’ to save.
6. Add simpleflickr tag to your page or post with the set or group attribute defined. (Please see Usage section for more details.)

Usage

After the plugin has been installed, activated, and the configuration options have been set you will be able to add a simpleviewer object to your content by adding a simpleflickr tag to your page or post. Please see the examples below for tag details.

Here is an example to show a set:

<simpleflickr set="72157594408754918" />

Here is an example to show a group:

<simpleflickr group="47755705@N00" />

Here is an example to show user’s recent photos:

<simpleflickr showrecent="true" />

Here is an example with all custom options:

<simpleflickr width="100%" height="800" bgcolor="#FFFFFF" quality="best"
navposition="bottom" title="Testing Demo" set="YOUR_SET_NUMBER" maximagewidth="500"
maximageheight="300" textcolor="0x333333" framecolor="0xD5E6EB"framewidth="10"
stagepadding="40" thumbnailcolumns="3" thumbnailrows="3"enablerightclickopen="false" />

The following are the attributes available for the tag:

Flickr Options
The following options are related to how the plugin accesses and retrieves images from flickr.

• Photo Count (count)
  The number of images to be displayed. The maximum number the flickr API allows is 500. For unlimited set to ‘0′. Default is ‘0′.
• Show Recent Photos (showrecent)
  Determines the user’s recent photos are displayed by default. This option takes precedences over the ’set’ and ‘group’ options. So, if this is set to true then your recent photos will be displayed even if you have added the ’set’ or ‘group’ attribute to the tag. Default is ‘false’.
• Image Size (imagesize)
  You must provide the size of the image displayed in the simpleviewer flash object. Can be ‘Square’, ‘Thumbnail’, ‘Small’, ‘Medium’, ‘Large’, ‘Original’. Default is ‘Medium’.
• Privacy Filter (privacyfilter)
  Determines what photos are displayed based on the level of privacy selected. Values can be ‘Public photos’, ‘Private photos visible to friends’, ‘Private photos visible to family’, ‘Private photos visible to friends & family’, ‘Completely private photos’. Default is ‘Public photos’.

Flash Object Options
The following options are general options related to the flash object displayed by this plugin.

• Width (width)
  Specifies the width of the movie in either pixels or percentage of browser window. Default is ‘480′.
• Height (height)
  Specifies the height of the movie in either pixels or percentage of browser window. Default is ‘680′.
• Quality (quality)
  Specifies the quality of the simpleviewer flash object. Can be ‘low’, ‘high’, ‘autolow’, ‘autohigh’, ‘best’. Default is ‘best’.
• Background Color (bgcolor)
  Specifies the background color (hexidecimal color value e.g #FF00FF) of the movie. This attribute does not affect the background color of the HTML page. Default is #FFFFFF. Is ignored if Window Mode is set to ‘transparent’.
• Window Mode (wmode)
  Sets the Window Mode property of the Flash movie for transparency, layering, and positioning in the browser. Can be ‘window’, ‘opaque’, ‘transparent’. Default is ‘window’. Overrides Background Color if set to ‘transparent’.

SimpleViewer Options
This plugin uses the SimpleViewer flash application for displaying images from Flickr. SimpleViewer can be customized by setting the following options. Please visit the SimpleViewer Options Page for more details.

• Max Image Width (maximagewidth)
  Width of the widest image in the gallery. Used to determine the best layout for your gallery (pixels). Default is ‘480′.
• Max Image Height (maximageheight)
  Height of tallest image in the gallery. Used to determine the best layout for your gallery (pixels). Default is ‘680′.
• Text Color (textcolor)
  Color of title and caption text (hexidecimal color e.g. 0xFF00FF). Default is ‘0xFFFFFF’.
• Frame Color (framecolor)
  Color of image frame, navigation buttons and thumbnail frame (hexidecimal color value e.g. 0xFF00FF). Default is ‘0xFFFFFF’.
• Frame Width (framewidth)
  Width of image frame (pixels). Default is ‘20′.
• Stage Padding (stagepadding)
  Width of padding around gallery edge (pixels). To have the image flush to the edge of the swf, set this to ‘0′. Default is ‘40′.
• Nav Padding (navpadding)
  Distance between image and thumbnails (pixels). Default is ‘40′.
• Thumbnail Columns (thumbnailcolumns)
  Number of thumbnail columns. To disable thumbnails completely set this value to ‘0′. Default is ‘3′.
• Thumbnail Rows (thumbnailrows)
  Number of thumbnail rows. To disable thumbnails completely set this value to ‘0′. Default is ‘3′.
• Nav Position (navposition)
  Position of thumbnails relative to image. Can be ‘top’, ‘bottom’, ‘left’ or ‘right’. Default is ‘left’.
• Vertical Alignment (valign)
  Vertical placment of the image and thumbnails within the SWF. Can be ‘center’, ‘top’ or ‘bottom’. Default is ‘center’.
  For large format galleries this is best set to ‘center’. For small format galleries setting this to ‘top’ or ‘bottom’ can help get the image flush to the edge of the swf.
• Horizontal Alignment (halign)
  Horizontal placement of the image and thumbnails within the SWF. Can be ‘center’, ‘left’ or ‘right’. Default is ‘center’.
  For large format galleries this is best set to ‘center’. For small format galleries setting this to ‘left’ or ‘right’ can help get the image flush to the edge of the swf.
• Title (title)
  Text to display as gallery Title. Default is blank.
• Enable Right Click Open (enablerightclickopen)
  Whether to display a ‘Open In new Window…’ dialog when right-clicking on an image. Can be ‘true’ or ‘false’. Default is ‘true’.
• Background Image Path (backgroundimagepath)
  Relative or absolute path to a JPG or SWF to load as the gallery background. Default is blank.
  Relative paths are relative to the HTML document that contains SimpleViewer. For example: ‘images/bkgnd.jpg’.
• First Image Index (firstimageindex)
  Index of image to display when gallery loads. Images are numbered beginning at zero. You can use this option to display a specific number based on the URL. Default is ‘0′.
• Open Image Text (langopenimage)
  The text displayed for the right-click ‘Open Image in New Window’ menu option. Can be used to translate SimpleViewer into a non-English language. Default is ‘Open Image in New Window’.
• About Text (langabout)
  The text displayed for the right-click ‘About’ menu option. Can be used to translate SimpleViewer into a non-English language. Default is ‘About’.
• Preloader Color (preloadercolor)
  Preloader color (hexidecimal color value). Default is ‘0xFFFFFF’.

Additional Options
The following are additional options to control how SimpleViewer displays images within this plugin.

• Show Image Caption (showimagecaption)
  Specifies if the image caption is displayed. Can be ‘true’ or ‘false’. Default is ‘true’.
• Image Caption Link (imagecaptionlink)
  Specifies if the image caption text is a link to the flickr image page. Can be ‘true’ or ‘false’. Default is ‘true’.
• Image Caption Style (imagecaptionstyle)
  Specifies the font style for the image caption text if displayed. Can be ‘bold’, ‘italic’, ‘underline’, or ‘none’. Default is ‘none’.

Alternate SimpleViewer Options
The following is an alternate option for using SimpleViewer within this plugin. If you provide a path to a standard SimpleViewer XML configuration file then this plugin will display the gallery and all settings specified in that file. This option overrides all other Simpleviewer options set for this plugin.

• XML Configuration File Path (xmldatapath)
  Relative or absolute URL of the gallery XML file. Relative paths are relative to the HTML page that contains the swf. Default is blank.

Copyright & Disclaimer:
Copyright (c) 2007-2008 by Josh Gerdes

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Special Thanks
Special thanks to the developers and community around this great piece of software:

SimpleViewer by Airtight - http://www.airtightinteractive.com/simpleviewer/

 
Need Support?
 
Please DO NOT post issues, bugs, feature requests, or ask for installation help in the comments section on this page. I will not approve those types of comments on this page. Instead, please visit my support forum which I created specifically to help with those types of problems.

For help visit the Support Forum (http://forums.joshgerdes.com).