Installation

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

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

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.

6.) optional: If you want to display image-buttons for your control-elements, we have to take care of these images too. So, again navigate to the folder "Media" > "stories".

And create a folder called bepiv_buttons. This is the place the plugin looks for the images we will set later for the control elements.

And therefore we upload them here.

Notice: The plugin does NOT create this folder automatically, neither comes the plugin with button-sets. If you want to use the buttons from the demo at bretteleben.de, feel free to do so. Anyway, there are a lot of websites that offer buttons for free or the possibility to create them online. Be creative! :)

Konfiguration and Usage

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

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

3.) First we set the width of the panorama in pixel ...

4.) ... 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.

5.) The next parameter sets the position of the panorama within the available space. You may choose between left - centered - right.

6.) Deviation sets the starting position of your panorama. Per default, the image is centered at start (empty or value 0). Here you may choose a different position. You may move the image up to half of its width to the left or right. The values are given in percent from -50 up to 50. Just try it out.

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.) The next 3 parameters set the text, you want to use for the links. The links are displayed below the panorama in the order (from left to right) "left", "stop" and "right".

If you want to use your own links, placed wherever on your page, the easiest way to do so is to enable this feature, copy the created links from the source of the page and then disable it again. This way, you ensure that your links will work.

Buttons:

Instead of text links you may also use buttons. Just insert the name of the image-file you want to be used (including the suffix). The plugin detects .jpg, .gif and .png and searches for the corresponding file in the folder "/images/stories/bepiv_buttons". If the file exists, the image is shown.

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

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.) Activate the plugin.

17.) Next, go to "Article Manager" and open the article you want to display the panorama.

18.) At the place you want the panorama to be shown insert the code to call it.

The code consists of the call {*bepiv}{/bepiv*} (without the asterisks) and contains the name of the folder with your image and the image itself. The path to this folder "/images/stories" is added by the plugin automatically and must not be inserted.

The complete call in our sample would look such as:

{*bepiv}panorama/panorama.jpg{/bepiv*} - without the asterisks

To use a folder within a folder, the path below "/images/stories/" is used, e. g. to use the folder /images/stories/myimages/yourimages" the call would look such as:

{*bepiv}myimages/yourimages/panorama.jpg{/bepiv*} - without the asterisks

19.) Save - done!

That´s it. Have fun with the plugin!

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.