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

Installation

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 in (Joomla-Installation)/images/stories.

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

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 - relative to (Joomla-Installation)/images/stories. In our sample the folder "panorama" is directly in the folder /images/stories, so we insert "panorama" here.

If there would be a subfolder e.g. "misc" in our folder panorama, and the image stored in the subfolder, we would insert "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-filesize.

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 (Joomla-Installation)/module/mod_bepiv/tmpl. Replace them with your own buttons, if they don´t blend with your template.

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 windowl.

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

17.) Choose the module-position.

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

19.) ... save and done.

That´s it, have fun with the module!

Support

If you use this extensions, you have the possibility to post a rating and a review at joomlaos.de or extensions.joomla.org. Furthermore I appreciate everyone, supporting me with a link back to www.bretteleben.de on his/her website. The extension itself does not produce any hidden links, eastereggs or whatever.