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

Installation

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

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

4.) Auf "Hochladen und Installieren" klicken

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

Bildordner

Damit man mit dem Plugin etwas anfangen kann, brauchen wir das Panoramabild. Dieses legen wir in einem Ordner unter (Joomla-Installation)/images/stories ab.

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

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.

6.) Optional: Sollen unterhalb des Panoramas grafische Buttons angezeigt werden, dann müssen wir uns auch um diese kümmern. Dazu wechseln wir nochmals in den Ordner "stories".

Und erstellen hier den Ordner bepiv_buttons. In diesem Ordner sucht das Plugin nach den Bildern, die wir später für die Navigationselemente festlegen werden.

Also laden wir sie hier auch hoch.

Hinweis: Das Plugin erzeugt diesen Ordner NICHT automatisch und installiert auch keine Buttons. Wer die Buttons des Beispiels auf bretteleben.de verwenden möchte, ist herzlich eingeladen, das zu tun. Ansonsten gibt es jede Menge Seiten, die fertige Buttons anbieten, oder auf denen man sich selbst Buttons online erstellen kann.

Konfiguration und Verwendung

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

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

3.) Zuerst legen wir die Breite des Panoramas in Pixel fest ...

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

5.) Als nächstes legen wir fest, ob das Panorama - in Bezug auf den zur Verfügung stehenden Platz - links, zentriert oder rechts ausgerichtet werden soll.

6.) Deviation legt die Startposition fest. Der Default-Wert 0 bedeutet, die Mitte des angezeigten Ausschnittes ist die Mitte des Bildes.
Dieser Startpunkt kann nun um je eine halbe Bildbreite nach links oder rechts verschoben werden. Die Eingabe erfolgt dabei in Prozent, von -50 bis +50. Einfach probieren.

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.) Die nächsten 3 Parameter legen die Texte fest, die für die Links angezeigt werden sollen. Die Links werden unterhalb des Panoramas angezeigt und haben (von links nach rechts) die Reihenfolge "Links", "Stop" und "Rechts".

Wenn Sie eigene Links an anderer Stelle anzeigen möchten, dann ist am einfachsten, die Anzeige hier temporär zu aktivieren uns die gewünschten Links direkt aus dem Quelltext der Seite zu kopieren. Damit stellen Sie sicher, dass die Aufrufe stimmen. Dann kann die Anzeige wieder dekativiert werden.

Buttons:

Statt Textlinks können auch Bilder verwenden werden. Dazu gibt man den Namen des jeweiligen Bildes inklusive Dateiendung ein. Das Plugin erkennt die Eingabe .jpg, .gif und .png und sucht im Ordner "/images/stories/bepiv_buttons" nach der entsprechenden Datei. Ist sie vorhanden, dann wird sie angezeigt.

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.) Das Plugin aktivieren.

17.) Jetzt im Menüpunkt "Inhalt" > "Beiträge" den gewünschten Beitrag öffnen.

18.) An der gewünschten Stelle den Code zum Aufruf des Plugins eingeben.

Der Code besteht aus dem Aufruf selbst {*bepiv}{/bepiv*} (ohne die Sterne) und enthält den Namen des Ordners, in dem wir gerade das Panoramabild abgelegt haben sowie den Namen der Bilddatei. Der Pfad zum Ordner, also "/images/stories/" wird vom Plugin automatisch ergänzt und ist nicht mit anzugeben.

Ein Aufruf sieht also zum Beispiel so aus

{*bepiv}panorama/panorama.jpg{/bepiv*} - ohne die Sterne

Hat man eine umfangreichere Ornderstruktur und soll das Panorama zum Beispiel im Ordner "/images/stories/meinebilder/deinebilder" liegen, dann ist auch das möglich. Der Aufruf lautet dann sinngemäß:

{*bepiv}meinebilder/deinebilder/panorama.jpg{/bepiv*} - ohne die Sterne

19.) Speichern - Fertig!

Das wars, viel Spass mit dem Plugin!

Support

Für Fragen und Anregungen steht die Kommentarfunktion zur Verfügung, Erfahrungsberichte (ob positiv oder negativ) sind hochwillkommen.