Conflickr

Name Conflickr Plugin Vendor Midori.hu (Website) Authors Aron Gombas Homepage http://confluence.atlassian.com/display/CONFEXT/Conflickr Issue Management http://developer.atlassian.com/jira/browse/FLKR Continuous Integration n/a Categories Content Macros Most Recent Version 0.4 Availability Confluence v2.1 to v2.10 State Beta Support License Freeware / Open Source (BSD) Price Free Release Docs http://confluence.atlassian.com/display/CONFEXT/Conflickr Java API Docs n/a Download Source http://svn.atlassian.com/svn/public/contrib/confluence/conflickr-plugin/tags/conflickr-0.4/ Download JAR conflickr-0.4.jar

Description/Features

Flickr is groovy, just like wikis (not to mention Confluence). So why not leverage both?This Confluence macro plugin helps you to integrate Flickr photos to your wiki pages.
Add images and move your cursor over the photos to get more detailed info about their tags, dates and such.
You can use these macros also to create PDFs or Word documents from your photos.
Just for fun, it provides you also with a Google AdSense (http://www.google.com/adsense) macro.
Using these together with the standard built-in blog macros, you can turn your wiki to a more complete blog experience.

Note that the URL of the img tag in the resulting HTML code is of the form: http://. When using this macro in a Confluence installation that you want to access using HTTPS instead of HTTP your users may get browser warnings of the sort "This page contains both secure and nonsecure items" because you are serving "mixed content".

Installation

1. Download the binary distribution (see above) and expand it to a temporary dir
2. Copy conflickr.jar to CONFLUENCE_DATA/plugins
3. Restart Confluence

(For advanced users: you can hot-deploy the plugin, of course.)

Parameters

This help is available also in the "notation guide" popup window of Confluence.

Common

This set is supported by all macros (see details below):

• title: (optional) title text.
• size: (optional) image size, one of square, thumbnail, small, medium, large, original, defaults to square.
• showDetails: (optional) show title, tags, number of comments and such, defaults to true.

This set is supported by all, but flickr-photo macro:

• maxPhotos: (optional) the maximum number of photos to download, defaults to 5.
• columns: (optional) number of columns in the table, defaults to 4.

flickr-photo macro

Supports the common parameters and:

• id: Flickr ID of the photo.

flickr-photoset macro

Supports the common parameters and:

• id: Flickr ID of the photoset.

flickr-group macro

Supports the common parameters and:

• id: Flickr ID of the group.

flickr-user-photos macro

Supports the common parameters and:

• userName: Flickr user name (not ID!).

flickr-tag-photos macro

Supports the common parameters and:

• tags: (optional) comma-separated list of tags, defaults to the page labels. If neither of those is specified, it uses some default tags.

flickr-favourites macro

Supports the common parameters and:

• userName: Flickr user name (not ID!).

flickr-contacts-photos macro

Supports the common parameters and:

• userName: Flickr user name (not ID!).

flickr-text macro

Supports the common parameters and has body to specify the text to render.

Examples

Displays the photo #12345:

{flickr-photo:id=12345\|size=large}

Displays 8 photos as thumbnail from photoset #67890:

{flickr-photoset:id=67890\|maxPhotos=8}

Displays 7 photos with the tags "Hungary" or "Japan":

{flickr-tag-photos:tags=Hungary,Japan|maxPhotos=7}

Displays the 20 favourite photos of user "milesdavis":

{flickr-user-favourites:title=Miles' favs\|userName=milesdavis\|maxPhotos=20\|size=thumbnail\|columns=6}

Displays the text "wiki" composed of images (see the first screenshot):

{flickr-text:showDetails=false}wiki{flickr-text}

Implementation notes

Currently, these macros access Flickr by using the flickrj library, a thin wrapper around the REST API
of Flickr. Unfortunately, the current version of the library does not support the latest API provided by Flicker.
(As an example, sorting by "interestingness" is not possible.)
However, this blocks the implementation of some more advanced features, it may change any time soon.

For the sake of simplicity, Conflickr is packaged to a single jar bundled together with 'flickrj', its only dependency not contained by a plain vanilla Confluence deployment.

Caching These macros use a very simple caching approach: unless you change the macro parameters, image information is not reloaded from Flickr for 5 minutes. Please note that also the (physical) image itself might be cached by your browser, but it has nothing to do with these macros.

Version History

Screenshots

Conflickr logo	conflickr-text macro displaying "Wiki"	conflickr-photo macro with details	Photos tagged with "hawaii", i18n
adsense-ads macro in action