A survey of the possibilities to call and modify panoramas with the code in the content item.

The "Panoramic Image Viewer" Plugin is called from within the content item. The code used offers - beside of setting the image - additional possibilities to arrange the panorama.

A.) Panorama

The code consists of the call {*bepiv}{/bepiv*} (without the asterisks) and contains the name of the folder we just uploaded the image plus the image file name. The configured path to this folder (image root, by default "/images/stories" in Joomla!1.5 or "/images/" in Joomla!1.6/1.7) 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 the set root folder is used, e. g. to use the folder /images/stories/folder/subfolder" the call in Joomla!1.5 would look such as:

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

In general that´s it and the panorama is ready to go.

B.) Parameter Overrides

Starting with version 1.2.0 the "Panoramic Image Viewer" plugin offers the possibility to change almost every default setting from the backend whilst calling the plugin within the content item. With this feature it is possible to use different settings for every single panorama.
To achieve this, the call of the plugin gets extended by the needed parameters. They are separated from the folder name and from each other by vertical bars (|). The have the syntax PARAMETER=VALUE:

List of possible parameters:

width - width of the panorama in pixel (integer) e.g.: 400

height - height of the panorama in pixel (integer) e.g.: 300

align - align the panorama within the content item; possible values: 0 (right), 1 (center), 2 (left), 3 (float left)

carousel - type of animation (carousel or swing); possible values: 0 (Swing), 1 (Carousel)

speed - timeout between two scroll-steps in milliseconds (integer) e.g.: 40

step - width of one scroll-step in pixel (integer) e.g.: 2

start- start at pageload or show control elements; possible values: 0 (no), 1 (yes)

deviation - deviation of the image in percent; (integer between -50 and 50) e.g.: 20

direct - direction to scroll when starting at pageload; possible values: l (left), r (right)

cstop - value for control-element "stop"; possible values: "empty" (default button), any text, filename of button (refer to Plugin Howto)

cfwd - value for control-element "forward"; possible values: "empty" (default button), any text, filename of button (refer to Plugin Howto)

cback - value for control-element "back"; possible values: "empty" (default button), any text, filename of button (refer to Plugin Howto)

lhref - link (complete URI) e.g.: http://www.bretteleben.de; refer to Plugin Howto

ltitle - title of the link e.g.: bretteleben.de; refer to Plugin Howto

ltarget - target of the link; possible values: 0 (same window), 1 (new window)


Samples:

{*bepiv}panorama/panorama.jpg|width=600|height=300{/bepiv*} - without the asterisks
Regardless of the settings in the backend this panorama gets displayed with a width of 600 pixel (width=600) and a height of 300 pixel (height=300).

{*bepiv}panorama/panorama.jpg|start=1|carousel=1|direct=r{/bepiv*} - without the asterisks
Regardless of the settings in the backend this panorama starts at pageload (start=1) and scrolls endless (carousel=1) to the right (direct=r).

Notice:

The parameters listed here correspond with the parameters in the plugins configuration panel. Find a details description at: Anleitung Plugin
The first parameter of the initial call always has to be the image name (path). The sorting of the other parameters is arbitrarily.

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.