Module Installation

To install modflickr log into your Joomla! site's administrator panel wih Super Administrator privliges and install it as you would any other 3rd party Joomla! module.

1. From the top menu select Extensions > Install/Uninstall.
   
2. Browse to and select your modflickr module zip file that you downloaded.
   
3. Click on Upload file and install.
   

Module setup

To set up modflickr to show your flickr© photosets, photostream or galleries using the Basic layout follow these simple steps:

Module parameters section

1. Add your flickr© API key.
   
2. Add your flickr© NSID.
   
3. Select the Basic layout from the dropdown list.
   

Flickr.com Photo Options

1. Select the type of flickr© list you'd like to select images from, from the dropdown list.
   
2. If you selected "set" from the dropdown list enter your photoset ID.
   
3. If you want to limit the number of photgraphs shown
   Just enter many photographs you'd like to show. Limiting does not apply to flickr© galleries as they are limited to 18 (eighteen) by flickr© or to sets overview. If no limit is set then by default the flickr api will return a maximum of 100 images, if your photostream or set contains more than 100 images and you would like to show them all then enter the number of images your photostream or set contains.
   
4. If you set a limit to the number of photgraphs shown you can choose which page to show images from (i.e. if you have 100 images and you have set the limit to 10 then you can show images 11 -to- 20 by selecting page 2
   
5. If you selected "gallery" from the dropdown list enter the gallery number
   (the most recent gallery that you set up in flickr© will be number "1", the next most recent number "2" and so on).
   
6. Select the thumbnail photo size from the dropdown list.
   You can select from the following sizes: square (75px x 75px); thumbnail (100px x 75px); small (240px x 180px).
   
7. Select the large photo size from the dropdown list.
   You can select from the following sizes: small (500px x 375px); medium (640px x 480px); large (1024px x 768px) - if you select the large photo size first ensure that this photo size is available on your flickr© account.
   
8. Select whether or not to show the descriptions from your flickr© photos.
   

Thumbnails Layout Options

1. Select whether or not to load the module's basic stylesheet.
   
2. Select whether or not to show the owner's name as a title when in sets overview mode.
   
3. Select whether or not to show image filename as a caption.
   
4. If you elected to show your photo descriptions then select whether you want to show the descriptions on the pop up window only or on the pop up window and the thumbnail list.
   
5. Select whether or not to link the thumbnails to their larger image.
   
6. Select the overlay type you would like to use, choose from: Joomla's native modal window library, MediaBox Advanced, or None.
   If you select None, then your images will open in a new browser window instead
   
7. If you elected to use the Mediabox Advanced overlay type then choose the theme that you would like to use, choose from: Black or White.
   
   

Other parameters section

1. Select whether or not to load the module's JQuery library.
   If your site/template loads JQuery prior to the module then you can elect to switch off loading JQuery
   
2. Select whether or not to load the module in diagnostic mode.
   If you have trouble with loading your flickr© photos then you can elect to switch on diagnostic mode to help with troubleshooting, diagnostic mode will show your flickr© settings in your site's front-end.
   
3. You can select whether or not to show the module's logo.
   Although you can switch the logo off we'd of course appreciate if you left it in place to provide a visual link back to Bulletproof Templates.
   
4. You can select whether or not to show the module's flickr© disclaimer.
   If you choose not to show the flickr© disclaimer then the module will still print it in the source code of your page to keep you in line with flickr©'s terms and conditions.