Eine Schritt für Schritt Anleitung für Installation und Verwendung des bretteleben.de Panoramic Image Viewer Moduls.

Installation

1.) In die Administrationsoberfläche einloggen

2.) Den Menüpunkt "Erweiterungen" > "Installieren/Deinstallieren" auswählen

3.) Die Paketdatei mit dem bretteleben.de Panoramic Image Viewer Modul auswählen

4.) Auf "Hochladen und Installieren" klicken

5.) Wenn alles geklappt hat, erhält man die Meldung "Modul erfolgreich installiert"

Bildordner

Damit man mit dem Modul etwas anfangen kann, brauchen wir das Panoramabild. Dieses legen wir in einem Ordner innerhalb der Joomla! Installation ab. Im Beispiel erzeugen wir den Unterordner im Ordner /images/stories.

1.) Den Menüpunkt "Site" > "Medien" auswählen

2.) Hier in den Ordner "Media" > "stories" wechseln

3.) Einen neuen Unterordner für das Bild anlegen. Im Beispiel wähle ich dafür den Namen "panorama".

4.) In den neu angelegten Ordner wechseln.

5.) Und hier die Bilddatei hochladen. Im Beispiel ist das die Datei panorama.jpg.

Konfiguration und Verwendung

1.) Den Menüpunkt "Erweiterungen" > "Module" auswählen

2.) Das "Panoramic Image Viewer Modul" suchen und anklicken

3.) Der erste Parameter ist der Pfad zum Ordner, in dem das Bild abgelegt ist - beginnend mit dem Joomla! Rootverzeichnis. Der Pfad zum Joomla! 1.5 Default-Bilderverzeichnis /images/stories/ wird vom Module bereits vorgeschlagen und ist entsprechend zu ergänzen oder abzuändern. In unserem Beispiel ist das also /images/stories/panorama/.

Hätten wir im Ordner panorama noch einen Unterordner "verschiedene" und dort unser Bild, dann wäre die Eingabe "/images/stories/panorama/verschiedene/"

4.) Der nächste Parameter ist der Dateiname des Bildes, in unserem Fall "panorama.jpg"

5.) Jetzt legen wir die Breite des Panoramas in Pixel fest ...

6.) ... und die Höhe des Panoramas in Pixel.

Ein höheres Bild wird entsprechend dieser Angabe im Browser skaliert. Es empfiehlt sich aber, das Panorama möglichst offline auf die gewünschte Höhe zu skalieren, da man so die bestmögliche Qualität mit der kleinstmöglichen Datei erzielt.

7.) Der Parameter "Scroll Speed" setzt das Timeout zwischen zwei Bewegungsschritten in Millisekunden. Kleiner ist hier schneller.

8.) "Scroll step" legt fest, um wieviele Pixel das Bild bei jedem Schritt verschoben werden soll. Je größer der Wert, desto schneller die Bewegung, je kleiner, desto flüssiger.

9.) "Start at pageload" legt fest, ob das Panorama beim Laden der Seite automatisch starten soll, oder ob Navigationselemente angezeigt werden.

10.) Startet man automatisch, dann kann man hier festlegen, ob nach links oder rechts.

11.) Werden Navigationselemente angezeigt, dann kann man hier festlegen, ob Textlinks oder Bilder verwendet werden sollen.

Das Modul installiert im Ordner (Joomla-Installation)/module/mod_bepiv/tmpl automatisch die Dateien left.png und right.png. Passen sie nicht zum Template, dann kann man sie durch zwei eigene Bilder ersetzen.

12.) Panorama link: Hier kann das Panorama verlinkt werden. Anzugeben ist der komplette Link inklusive Protokoll.
z.B.: http://www.bretteleben.de

Bleibt der Parameter leer, dann wird kein Link erzeugt.

13.) Bei "Panorama link title" kann für den soeben eingegebenen Link ein eigener Titel angegeben werden.
z.B.: bretteleben.de

Hat man unter 12.) keinen Link angegeben, dann wird ein hier eingegebener Titel als Alt- und Titel-Attribut des Panoramabildes verwendet.

14.) "Target for link - if set" legt fest, ob ein angegebener Link im selben Fenster (Top) oder in einem neuen Fenster (Blank) geöffnet werden soll.

15.) Unter dem Reiter "Erweiterte Parameter" findet sich der Parameter "Modul-Klassen-Suffix" der es erlaubt, für dieses Modul eine spezifische CSS Klasse festzulegen.

16.) Als nächstes wird der Titel des Moduls angepasst und festgelegt, ob er angezeigt werden soll.

17.) Das Modul aktivieren.

18.) Die gewünschte Position festgelegen.

19.) Jetzt noch die Menüpunkte auswählen, bei denen das Modul angezeigt werden soll ...

20.) ... speichern und fertig.

Das wars, viel Spass mit dem Modul!

Für Fragen und Anregungen steht die Kommentarfunktion zur Verfügung.

Wer die Erweiterung nutzt den bitte ich, sie auf extensions.joomla.org zu bewerten und einen Erfahrungsbericht zu posten. Darüber hinaus freue ich mich über jeden, der die Möglichkeit findet, mich durch einen Link zu www.bretteleben.de auf seiner Webseite zu unterstützen. Das Plugin selbst produziert keine versteckten Links oder sonstige Nettigkeiten welcher Art auch immer.