A step for step tutorial on how to install and use the bretteleben.de Panoramic Image Viewer Module.

Installation

1.) Log into your administration interface

2.) Go to "Extensions" > "Install/Uninstall"

3.) Select the Package File with the bretteleben.de Panoramic Image Viewer Module

4.) Click "Upload file & Install"

5.) If everything worked fine, you get the message "Install Module Success"

Imagefolder

Next we need the image. We upload it to a folder within the Joomla! root. In this sample I am placing the folder within the folder /images/stories, the default image folder in Joomla!1.5. Using Joomla!1.6/1.7 you would probably choose the folder /images/. Everything else stays the same.

1.) Go to "Site" > "Media Manager"

2.) Navigate to the folder "Media" > "stories"

3.) Create a new subfolder for your image. In this sample I choose the name "panorama"

4.) Navigate to the new folder.

5.) ... and upload your image to it. In this sample its the file panorama.jpg.

Konfiguration and Usage

1.) Select "Extensions" > "Module Manager"

2.) Find the "Panoramic Image Viewer Module" and click it

3.) The first parameter is the folder we just created for our image - starting at the Joomla! root directory. The module suggests the default image folder (/images/stories/ in Joomla!1.5 and /images/ in Joomla!1.6/1.7) which we have to modify or to add to. In our sample the complete path is /images/stories/panorama/.

If there would be a subfolder e.g. "misc" in our folder panorama, and the image stored in the subfolder, we would insert "/images/stories/panorama/misc"

4.) The next parameter is the name of the image-file, in our sample "panorama.jpg"

5.) Now we set the width of the panorama in pixel ...

6.) ... and the height of the panorama in pixel.

An image that exceeds this value will get scaled within the visitors browser. Best practice is to scale the image offline. Doing so you get the best-possible image-quality combined with the smallest-possible image file size.

7.) The parameter "Scroll Speed" sets the timeout between two scroll-steps in milliseconds. Smaller means faster.

8.) "Scroll step" sets, how many pixel one step should move the picture. The larger the value the faster the scrolling, the smaller the value the smoother the scrolling.

9.) "Start at pageload" sets if the panorama starts to scroll at page load or if we show control-elements.

10.) If we start automatically, here we choose the direction.

11.) If we show control-elements, this parameter sets if text-links or buttons are shown.

The extension installs the images left.png and right.png to the folder /modules/mod_bepiv/tmpl (Joomla!1.5) or /modules/mod_panoramicimageviewer/tmpl (Joomla!1.6/1.7). Replace them with your own buttons, if they don´t blend with your template.

12.) Panorama link: If we want to have the panorama linked, this is the place to set the URI. Insert the complete link, including the protocol.
e.g.: http://www.bretteleben.de

If the parameter is empty, no link is created by the module.

13.) "Panorama link title" allows to set a title for the above created link.
e.g.: bretteleben.de

If parameter 12.) stays empty, a given title is used for the alt- and title-tag of the panorama-image.

14.) "Target for link - if set" decides if to open the link in the current (Top) or a new (Blank) browser window.

15.) The tab "Advanced Parameters" contains the parameter "Module Class Suffix" that allows to set a specific CSS class for this module.

Starting with Joomla!1.6 you find here the Joomla! specific Cache-settings too.

16.) Next, set the title of the module to fit your needs and decide if to show it.

17.) Activate the module.

18.) Choose the module-position.

19.) Choose the menu-items to show the module ...

20.) ... save and done.

If you have questions or suggestions, please use the comment-function. Please include the installed Joomla! version and if you have problems - if any possible - the affected page in your comment.

If you need additional features or customizations for your project that exceed the scope of support offered through the comments, you are invited to submit your requirements specification and the planned budget by email (menu item "Contact" in the menu at the top).

If you use this extensions, please post a rating and a review at extensions.joomla.org.