Eine Schritt für Schritt Anleitung für Installation und Verwendung des VSIG for Hot Property Plugins.

Installation

1.) In die Administrationsoberfläche einloggen

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

3.) Die Paketdatei mit dem VSIG for Hot Property Plugin auswählen

4.) Auf "Hochladen und Installieren" klicken

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

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

7.) Das "Very Simple Image Gallery for Hot Property" Plugin suchen und anklicken

8.) "Gallery width" ist die Gesamtbreite. Werden die Thumbnails unterhalb des Hauptbildes angezeigt, dann entspricht das der Breite des Hauptbildes, werden die Thumbnails rechts vom Hauptbild angezeigt, dann entspricht das der Gesamtbreite der Galerie (Hauptbild + Thumbnails).

9.) Der nächste Parameter legt die Positionierung der Galerie relativ zum verfügbaren Platz fest. Zur Auswahl stehen Links, Zentriert, Rechts, float left und float right. Die beiden letzten Optionen ermöglichen es, die Galerie mit Text umfliessen zu lassen. Sie machen die Galerie gleichzeitig aber auch wesentlich abhängiger vom verwendeten Template und werden wohl nicht immer den gewünschten Effekt haben.

10.) Der nächste Parameter ist die Breite der Thumbnails in Pixel.

11.) Als nächstes kann der Abstand der Thumbnails zueinander in Pixel festgelegt werden. Welcher Wert hier passend ist, muss im Einzelfall entschieden werden. Fixe Regeln gibt es keine.

12.) Die Thumbnails können wahlweise neben oder unter dem Hauptbild angezeigt werden. Welche Option die passendere ist, hängt vom verwendeten Template ab.

Wählt man die Option "Justified - below the main image", dann versucht das Plugin, ausgehend von den getroffenen Einstellungen, die Größe der Plugins und des Hauptbildes soweit zu ändern, dass der rechte Rand des Hauptbildes exakt mit dem rechten Rand der Thumbnails abschließt.

13.) Lässt man die Thumbnails rechts vom Hauptbild anzeigen, dann wird hier festgelegt, wieviel der Gesamtbreite in Prozent für die Thumbnails verfügbar sein soll. Abhängig von Gesamtbreite, Thumbnailbreite und Thumbnailzwischenraum wird man hier nicht darum herumkommen, die passende Einstellung durch Probieren herauszufinden. Sollen die Thumbnails unter dem Hauptbild angezeigt werden, dann ist dieser Parameter ohne Bedeutung.

14.) Der Parameter "Sets" bietet die Möglichkeit, die Galerien in mehrere Sets zu unterteilen. Wird hier nichts eingegeben oder ist der eingegebene Wert größer als die Anzahl der gefundenen Bilder, dann zeigt das Plugin alle Thumbnails auf einer Seite an.
Jeder andere Wert (3, 4, ...) erzeugt einzelne Sets, zwischen denen mit automatisch angezeigten Buttons/Links navigiert werden kann. Zusätzlich wird ein Counter erzeugt, der die Anzahl der verfügbaren Sets angibt.
Gibt man als Wert 1 an, dann werden keine Thumbnails angezeigt und man kann sich Bild für Bild durch die Galerie klicken.

15.) "Label Sets" legt fest, wie der Counter die einzelnen Sets bezeichen soll. Ob "Set", "Desk", "Page" ... wie es gefällt.

16.) Die Parameter "Link/Button forward" und "Link/Button backward" legen den Button/Text für die Links fest, mit denen zwischen den einzelnen Sets navigiert wird:

Lässt man die Felder leer, dann werden die automatisch installierten Buttons verwendet.

Gibt man Text ein, dann wird der Text verwendet.

Alternativ zu Standardbuttons und Textlinks können auch eigene grafische Buttons verwendet werden. Findet das Plugin die Endungen .jpg, .png oder .gif, dann sucht es im Ordner /media/plg_hotproperty_vsig/ nach Bildern dieses Namens. Sind sie vorhanden, dann werden sie angezeigt.

17.) "Show Captions" Aktiviert man diesen Parameter, dann werden Titel und Beschreibung des Bildes angezeigt.

18.) "Position of Captions" legt fest, ob Titel und Text halbtransparent über das Bild eingeblendet oder unter dem Hauptbild angezeigt werden sollen.

19.) Aktiviert man den Parameter "Use Links" dann werden die Bilder der Galerie automatisch mit dem Originalbild verlinkt. Dieses öffnet sich in einem neuen Fenster.
Voraussetzung für die Nutzung ist, dass man das Original beim Hochladen gespeichert hat (siehe Einstellungen Hot Property)

20.) "Stylesheet" legt fest, welches Stylesheet für die Galerie verwendet werden soll. Das Standardstylesheet ist die Datei /media/plg_hotproperty_vsig/vsig.css. Wer sich ein eigenes Stylesheet erstellt hat, kann es in den Ordner /media/plg_hotproperty_vsig/ hochladen und hier auswählen. Zu Testzwecken beinhaltet das Plugin die Datei vsig2.css, die die Thumbnails ohne Schlagschatten darstellt.

21.) Der Parameter "JavaScript File" bietet die selbe Möglichkeit für das verwendete Script.

22.) Das Plugin aktivieren.

23.) Auf Speichern klicken.

Da das Plugin die Standardgalerie von Mosets Hot Property ersetzt, muss diese jetzt noch deaktiviert werden.

Verwendung

Damit man mit dem Plugin etwas anfangen kann, brauchen man auch die entsprechenden Bilder.

1.) Diese werden bei der jeweiligen Property in Mosets Hot Property hochgeladen.

Der für das Bild eingegebene Titel kann in der Galerie als Titelzeile der Captions angezeigt werden.

Die für das Bild eingegebene Beschreibung kann in der Galerie als Textbereich der Captions angezeigt werden.

Die hier festgelegte Reihenfolge bestimmt auch die Reihenfolge, in der das Plugin die Bilder anzeigt.

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.