|
Übersicht über die Möglichkeiten des Aufrufs direkt aus dem Artikel.
Das "Very Simple Image Gallery" Plugin wird aus dem jeweiligen Artikel aufgerufen. Dabei gibt es - neben der Wahl des Ordners, in dem die Bilder liegen - weitere Möglichkeiten, die Galerie aufzuwerten oder zu gestalten.
A.) Die Galerie selbst
Der Code besteht im einfachsten Fall aus dem Aufruf selbst {*vsig}{/vsig*} (ohne die Sterne) und enthält den Namen des Ordners, in dem wir gerade die Bilder abgelegt haben. Der im Backend festgelegte Pfad zum Ordner, also per Default "/images/stories/" in Joomla!1.5 bzw. "/images/" in Joomla!1.6/1.7 wird vom Plugin automatisch ergänzt und ist nicht mit anzugeben.
Ein Aufruf sieht also zum Beispiel so aus
{*vsig}verysimple{/vsig*} - ohne die Sterne
Um einen Ordner in einem Unterordner zu verwenden, wird sinngemäß der Pfad unterhalb des im Backend festgelegten Pfades angegeben, also zum Beispiel für den Ordner "/images/stories/ordner/unterordner" in Joomla!1.5:
{*vsig}ordner/unterordner{/vsig*} - ohne die Sterne
An sich war es das und die Galerie ist einsatzfertig.
B.) Parameter Overrides
Beginnend mit Version 1.3 bietet die "Very Simple Image Gallery" die Möglichkeit, nahezu alle im Konfigurationspanel des Plugins gesetzten Werte direkt im Aufruf zu überschreiben. Damit können verschiedenst gestaltete Galerien erstellt werden. Hat man zum Beispiel voreingestellt, dass die Thumbnails unten angezeigt werden soll, dann kann man sie im Aufruf auch nach rechts verschieben. Man kann verschieden breite und hohe Galerien erstellen, mit verschieden breiten und hohen Thumbnails, etc. etc.
Dazu wird der Aufruf des Plugins um die benötigten Parameter erweitert. Diese folgen dem Ordnernamen, von diesem und untereinander jeweils getrennt durch einen vertikalen Trennstrich und haben das Format PARAMETER=WERT:
Übersicht über die möglichen Parameter:
width - Breite der gesamten Galerie in Pixel (ganze Zahl) z.B.: 600 height - maximale Höhe der Bilder in Pixel; mögliche Werte: leer (gesamte Breite ausnützen), (ganze Zahl) z.B.: 600 imquality - Qualität der Bilder in Prozent (ganze Zahl von 1-100) z.B.: 90
align - Ausrichtung der Galerie im Artikel; mögliche Werte: 0 (rechts), 1 (mitte), 2 (links), 3 (float left), 4 (float right)
twidth - Breite der Thumbnails in Pixel (ganze Zahl) z.B.: 80
theight - Höhe der Thumbnails in Pixel (ganze Zahl) z.B.: 60 crop - Sollen die Thumbnails proportional skaliert oder beschnitten werden; mögliche Werte: keep (proportional), crop (beschnitten), quality - Qualität der Thumbnails in Prozent (ganze Zahl von 1-100) z.B.: 80
space - Platz zwischen den Thumbnails (ganze Zahl in Pixel) z.B.: 3
right - Lage der Thumbnails; mögliche Werte: 0 (unten), 1 (rechts), 2 (unten und am rechten Bildrand ausgerichtet), 3 (links)
area - ab Version 1.6.5 nicht mehr in Verwendung!
cols - Anzahl Spalten Thumbnails rechts/links vom Hauptbild (ganze Zahl) z.B.: 2
sort - Sortierung der Bilder; mögliche Werte: 0 (A-Z - DEFAULT), 1 (Z-A), 2 (alt-neu), 3 (neu-alt), 4 (zufällig)
sets - Zahl der Thumbnails je Set
setstxt - Bezeichnung der Sets
cfwd - Wert für das Kontrollelement "Vor"; mögliche Werte: leer (Standardbutton); beliebiger Text; Dateiname eines Buttons (siehe Plugin Howto)
cbwd - Wert für das Kontrollelement "Zurück"; mögliche Werte: leer (Standardbutton); beliebiger Text; Dateiname eines Buttons (siehe Plugin Howto)
caps - Captions anzeigen; mögliche Werte: 0 (nein), 1 (ja)
inout - Position der Captions; mögliche Werte: 0 (unter dem Hauptbild), 1 (überblendet über das Hauptbild)
links - Links anzeigen; mögliche Werte: 0 (nein), 1 (ja)
autolink - automatisch Links zum Originalbild erzeugen; mögliche Werte: 0 (nein), 1 (ja)
script - soll JavaScript verwendet werden; mögliche Werte: 0 (nein), 1 (ja)
hover - Bildwechsel onhover; mögliche Werte: 0 (nein), 1 (ja)
preload - sollen Bilder und Thumbnails vorgeladen werden; mögliche Werte: 0 (nein), 1 (ja)
tooltip - soll der Dateiname für ALT/TITLE verwendet werden; mögliche Werte: 0 (nein), 1 (ja)
folderid - Name des Ordner als Identity des obersten DIV-containers; mögliche Werte: 0 (nein), 1 (ja)
Beispiele:
{*vsig}verysimple|width=600|right=2{/vsig*} - ohne die Sterne Ungeachtet der Voreinstellungen wird diese Galerie mit einer Breite von 600 Pixel (width=600) angezeigt. Die Thumbnails sind unter dem Hauptbild und werden mit diesem rechtsbündig ausgerichtet (right=2) {*vsig}verysimple|width=600|right=1|cols=2{/vsig*} - ohne die Sterne Breite 600 Pixel (width=600), Thumbnails rechts (right=1) in zwei Spalten (cols=2)
{*vsig}verysimple|twidth=80|theight=60|space=3|quality=80{/vsig*} - ohne die Sterne Die Thumbnails sind 80 Pixel breit (twidth=80), 60 Pixel hoch (theight=60), zwischen den Thumbnails sind jeweils 3 Pixel (space=3) und sie werden mit 80% der möglichen Qualität erzeugt (quality=80)
Hinweise:
Die Parameter entsprechen den Parametern im Konfigurationspanel des Plugins und sind auf der Seite Anleitung Plugin ausführlich erläutert. Der erste Parameter innerhalb eines Aufrufs ist immer der Ordner mit den Bildern. Danach ist die Reihenfolge, in der die Overrides angegeben werden frei wählbar.
C.) Captions
Überschriften und Texte werden mit einem eigenen Aufruf angegeben. Dieser lautet:
{*vsig_c}Galerienummer|Bilddatei|Titel|Text{/vsig_c*} - ohne die Sterne
Galerienummer: Die Galerien innerhalb eines Beitrages werden vom Plugin automatisch von 0 beginnend durchnummeriert. Diese Eingabe ist unbedingt erforderlich.
Bilddatei: Der exakte Name der Datei "meinbild.jpg". Wird hier nichts eingegeben, dann wird der Aufruf als Default-Wert für die Galerie verwendet. Das bedeutet, er wird bei allen Bildern angezeigt, für die keine eigene Eingabe vorhanden ist.
Titel: Die Überschrift. Wird hier nichts eingegeben . . . dann wird keine Überschrift angezeigt.
Text: Der Text unterhalb der Überschrift. Wird hier nichts eingegeben . . . dann wird kein Text angezeigt.
Beispiele:
{*vsig_c}0||meinTitel|meinText{/vsig_c*} - ohne die Sterne Dieser Aufruf legt für die erste Galerie im Beitrag den Standardtitel "meinTitel" und den Stadardtext "meinText" fest, indem kein Bild angegeben wird. Hinweis: natürlich muss man keinen Stadardtext festlegen. Findet das Plugin für ein Bild keine Angabe, dann wird eben nichts angezeigt.
{*vsig_c}1|bild01.png||meinText{/vsig_c*} - ohne die Sterne Bei bild01.png in der zweiten Galerie im Beitrag wird keine Überschrift und als Text "meinText" angezeigt.
{*vsig_c}0|bild02.png||{/vsig_c*} - ohne die Sterne Bei bild02.png in der ersten Galerie im Beitrag wird nichts angezeigt (Auch nicht der weiter oben festgelegte Standardtext/-titel.)
{*vsig_c}0|bilda.jpg|meinTitelA|meinTextA{/vsig_c*} - ohne die Sterne {*vsig_c}0|bildb.jpg|meinTitelB|meinTextB{/vsig_c*} - ohne die Sterne {*vsig_c}0|bildc.jpg|meinTitelC|meinTextC{/vsig_c*} - ohne die Sterne {*vsig_c}0|bildd.jpg|meinTitelD|meinTextD{/vsig_c*} - ohne die Sterne ... ich glaube, das Prinzip ist klar
Hinweise: Wer keine Captions anzeigen möchte, der kann Sie nutzen, um über die Titelzeile der Captions die Attribute "alt" und "title" der Bilder zu setzen. Findet das Plugin für ein Bild einen Caption-Call, dann wird die Titelzeile auch dann als ALT/TITLE verwendet, wenn Captions nicht aktiviert sind.
Wo im Beitrag und in welcher Reihenfolge diese Angaben gemacht werden ist ohne Belang. Die Anzahl der Parameter in einem Aufruf muss immer 4 sein. Das bedeutet, es müssen immer 3 vertikale Trennstriche (broken vertikal bar) angegeben sein, auch wenn zum Beispiel kein Text angegeben wird, der Trennstrich nach dem Titel muss vorhanden sein! Diese Trenner sind hier geschützte Zeichen und dürfen im Text der Eingaben nicht verwendet werden.
D.) Links
Möchten wir die Bilder der Galerie selektiv verlinken, dann kommt zusätzlich noch eine dritte Form des Aufrufs zum Einsatz:
{*vsig_l}Galerienummer|Bilddatei|Verweisziel|Titel|target{/vsig_l*} - ohne die Sterne
Galerienummer: Die Galerien innerhalb eines Beitrages werden vom Plugin automatisch von 0 beginnend durchnummeriert. Diese Eingabe ist unbedingt erforderlich.
Bilddatei: Der exakte Name der Datei "meinbild.jpg". Wird hier nichts eingegeben, dann wird der Aufruf als Default-Wert für die Galerie verwendet. Das bedeutet, er wird für alle Bilder verwendet, für die keine eigene Eingabe vorhanden ist.
Verweisziel: Die URL zu der verlinkt werden soll. Z.B.: http://www.bretteleben.de
Titel: Der Text, der beim Überfahren des Bildes für den Link angezeigt werden soll. z.B.: bretteleben.de target: Das Fenster, in dem das Verweisziel geöffnet werden soll. z.B.: _blank (neues Fenster), _self (selbes Fenster) Beispiele:
{*vsig_l}0||http://www.bretteleben.de|bretteleben.de|_blank{/vsig_l*} - ohne die Sterne Dieser Aufruf legt durch den leeren Bildnamen für die erste Galerie im Beitrag den Standardlink www.bretteleben.de mit dem Text bretteleben.de fest, geöffnet wird der Link in einem neuen Fenster.
{*vsig_l}1|bild01.png|http://www.disney.com|Disney|_self{/vsig_l*} - ohne die Sterne bild01.png in der zweiten Galerie wird mit www.disney.com verlinkt, der Link öffnet im selben Fenster.
{*vsig_l}0|bild02.png|||{/vsig_l*} - ohne die Sterne bild02.png in der ersten Galerie im Beitrag soll nicht verlinkt werden. Ein Sonderfall, denn wenn man Links aktiviert hat, dann werden alle Bilder der Galerie verlinkt. bild02.png wird in diesem Fall einen leeren Verweis haben und auf die selbe Seite verlinken.
{*vsig_l}0|bilda.jpg|http://www.meine.domain.com/meinTollesProdukt1|tollesProdukt1|_self{/vsig_l*} - ohne die Sterne {*vsig_l}0|bildb.jpg|http://www.meine.domain.com/meinTollesProdukt2|tollesProdukt2|_self{/vsig_l*} - ohne die Sterne {*vsig_l}0|bildc.jpg|http://www.meine.domain.com/meinTollesProdukt3|tollesProdukt3|_self{/vsig_l*} - ohne die Sterne {*vsig_l}0|bildd.jpg|http://www.meine.domain.com/meinTollesProdukt4|tollesProdukt4|_self{/vsig_l*} - ohne die Sterne ... usw.
Hinweise: Wo im Beitrag und in welcher Reihenfolge diese Angaben gemacht werden ist ohne Belang. Die Anzahl der Parameter in einem Aufruf muss immer 5 sein. Das bedeutet, es müssen immer 4 vertikale Trennstriche (broken vertikal bar) angegeben sein, auch wenn eine Angabe (zum Beispiel der Name der Bilddatei) leer bleibt! Diese Trenner sind hier geschützte Zeichen und dürfen im Text der Eingaben nicht verwendet werden.
Für Fragen und Anregungen steht die Kommentarfunktion zur Verfügung. Bitte geben Sie bei Ihrer Frage die verwendete Joomla! Version an und posten Sie bei Problemen - soweit möglich - einen Link zur betroffenen Seite.
Wer für sein Projekt zusätzliche Funktionen oder Adaptierungen über die Möglichkeiten des hier gebotenen Supports benötigt, der ist eingeladen, mich mit einer Beschreibung der gewünschten Leistungen und dem angedachten Budget per Email zu kontaktieren (Menüpunkt "Kontakt" im Topmenü).
Wer die Erweiterung nutzt den bitte ich, sie auf extensions.joomla.org zu bewerten und einen Erfahrungsbericht zu posten. |
Hi, congratulations for all your plugins.
It's possible the thumbnails appear darker when mouse is out and lighter when mouse is over the thumbnail ?
Thanks
Hi Cesar!
I haven't tried to modify the CSS this way myself up till now but if you want to give it a try, the stylesheet of the plugin is /plugins/content/plugin_vsig/vsig.css (Joomla!1.5).
Best regards
Andreas
Hi there,
very nice extension. Please let me know if this would be possible to set:
I am using plugin code for captions and for links. I would like on mouse over a thumb to see caption as tooltip. When mouse over a large image I would to have text I set in link code as a tooltip. Is this doable?
thanks
Hi Branko!
No, the tooltips for thumbnails and images are always set to the same values.
Best regards
Andreas
Great Plugin
I use an application that allows user to upload there pictures. It creates thumbnails. Is there a way i can filter my images. I have 40 images with thumbnails and I only want to display the images not the thumbnails using {*vsig}foldername{/vsig*} format.
cheers
ray
Hi Ray!
It is not possible out of the box but it should be not too complicated to patch the plugin to select the images to show e.g. following a naming convention.
Best regards
Andreas
Hi, Great Plugin!
Installed this on 1.7, and everything is working great, but I am having issues with the Captions, they won't show up.
Location on Website: promontory.cloudaccess.net/home-builder/homes.html
Show Captions: Yes
{*vsig_c}0|IMG_0379|Downes Road., Abbotsford|dfgdfh{/vsig_c*}
{*vsig_c}0|IMGP0707|Carnarvon Street.,Abbotsford|{/vsig_c*}
What is wrong ?
Hi Jessica!
The second parameter is the image file name WITH the suffix:
{*vsig_c}0|IMG_0379.jpg|Downes Road., Abbotsford|dfgdfh{/vsig_c*}
{*vsig_c}0|IMGP0707.jpg|Carnarvon Street.,Abbotsford|{/vsig_c*} ... without the asterisks
Best regards
Andreas
Hallo Andreas,
Gratulation für die Galerie - sie ist wunderbar einsetzbar und ganz toll. Ich hätte nur eine Frage:
Ich möchte die Bilder verlinken, was mit Deiner Angabe ja eigentlich auch kein Problem darstellt. Allerdings möchte ich, dass der Link nicht nur vom großen Bild funktioniert, sondern bereits schon von den Thumbsnails weg. Ist das möglich und habe ich da nur eine falsche Einstellung getroffen oder bietet die Galerie diese Möglichkeit noch nicht?
Vielen Dank für Deine Hilfe.
Liebe Grüße
Dagmar
Danke für die schnelle Antwort - werd mich gleich in der CSS Galerie umsehen! Super
LG
Dagmar
Hallo Dagmar!
Nein, das ist nicht möglich. Mit dem Aktivieren der Option "Switch on hover thumb" ist es zwar bei aktiviertem JavaScript nicht mehr nötig, das Thumbnail anzuklicken um das Hauptbild zu wechseln, trotzdem bleibt das die primäre Nutzung des Links am Thumbnail. Für eine externe Verlinkung steht er nicht zur Verfügung.
Wenn Du das unbedingt brauchst, dann könntest Du Dir die "CSS Gallery" ansehen (Link im Menü links), die ohne JavaScript nur mit CSS funktioniert und wo das nicht nur möglich sondern die vorgesehene Einstellung ist. Dafür hat dieses Plugin aber andere Einschränkungen.
Gruß
Andreas
Hello! What a wonderful plugin. I am very happy with it. Today, though, I am seeing some strange behavior with the autolink function. Autolink is turned on, but only some of the images in my gallery have links to their original image.
Article is here: www.vividmotion.org/press-releases/105-nb11-press (only the two right-hand photos in the thumbnail set have links that point to their source photos)
My Joomla configuration is set to Cache = OFF
Autolinking is working normally on other articles on my website: www.vividmotion.org/show-gallery/86-ss10
I have not set any override parameters in the {vsig} code on the article.
Any insight you can offer into why this is happening would be very useful.
Thank you,
~Ayprille
Hi Andreas,
There were no specific links for the photos in the article, but there *were* capital letters in the filenames. Changing those to lower case fxed my issue. Thank you very much. I really, really like your plugin.
Regards,
~Ayprille
Hi Ayprille!
Please check if:
There is a specific link set for these images in the article. If so, remove it.
The image files have an uppercase suffix (JPG, PNG, GIF). If so, change it to lowercase (jpg, png, gif). A bug to fix in the next version.
Best regards
Andreas
Hi guys,
Very nice plugin, thank you!
However, I can't manage to activate the caption/text for the images.
location on the website: http://www.040uit.nl/index.php?option=com_content&view=article&catid=3:cafes&id=449:cafe-wilhelmina&Itemid=41
Joomla 1.5.23
image root: images/website/
folder for images for this article: images/website/vsig_wilhelmina_01/
Show Captions: Yes
Position of Captions: Inside
in article:
{*vsig}vsig_wilhelmina_01{/vsig*}
{*vsig_c}0|vsig_wilhelmina_01/benjamin_hermans_800.jpg|Benjamin Hermans{/vsig_c*}
{*vsig_c}0|vsig_wilhelmina_01/connie_lush_800.jpg|Connie Lush{/vsig_c*}
the gallery is working fine, but the captions/texts don't show.
What is wrong here?
Kind regards,
Edze de Boer
Hi Edze!
The second parameter is just the image file name, no path (this is already set within the initial call).
Give this a try:
{*vsig}vsig_wilhelmina_01{/vsig*}
{*vsig_c}0|benjamin_hermans_800.jpg|Benjamin Hermans|{/vsig_c*}
{*vsig_c}0|connie_lush_800.jpg|Connie Lush|{/vsig_c*} ... without the asterisks
An additional note: Even if you are using the title line only, please always add the third vertical bar.
Best regards
Andreas
Hallo,
danke für das super plugin!
In Deiner Anleitung beschreibst Du nicht, dass der Bildwechsel durch Überfahren eines thumbnails mit der Maus JavaScript erfordert. Bei mir funktioniert es aber nur, wenn ich unter "other settings" "Use JavaScript" YES aktiviere. Ich finde Dein plugin gerade so toll, weil es doch eigentlich auch nur per CSS funktionieren soll, oder nicht? In der CSS Gallery ist es ja so...
Ausserdem würde ich gerne wissen, ob Dir eine Erwähnung/Link im Impressum entgegenkommt oder lieber nicht.
Danke für Dein Bemühen und lieben Gruß
Hallo Holley!
Danke, dass Du mich auf dieses mögliche Missverständnis aufmerksam machst. Ich habe auf der Seite "Anleitung Plugin" - auf die hier im Zusammenhang mit dem Feature "Parameter Overrides" für eine ausführliche Erklärung der einzelnen Parameter verwiesen wird unter "Anleitung" > "Punkt 30" den Hinweis: "Voraussetzung dafür ist, dass JavaScript aktiviert ist." in "Voraussetzung dafür ist, dass der Parameter "Use JavaScript?" aktiviert ist." geändert. Ich hoffe, das ist unmissverständlicher.
Betreffend des Funktionierens ausschließlich per CSS: Ja, das ist bei der "CSS Gallery" so, deshalb auch der Name. Was die "Very Simple Image Gallery" angeht, das Plugin ist auch bei deaktiviertem JavaScript (gleich ob im Backend oder einfach beim Benutzer) funktionstüchtig, auf nette Features wie Bildwechsel ohne Seitenreload und Bildwechsel per Hover muss man allerdings verzichten.
Über Erwähnung/Link im Impressum freue ich mich natürlich. Danke
Gruß
Andreas
Hello Andreas,
Thanks for a beautiful plugin. My questions is: is it possible to use the links, so that the original photo is shown, but not in a new window but in a pop-up?
I'm working with Joomla 1.7.2 .
Regards,
Conny Roukens
Hi Conny!
No. Please check the category Photos & Images at extensions.joomla.org. You will find hundreds of extensions using modal windows of any kind you can imagine. This one does intentionally not.
Best regards
Andreas
hallo und vielen dank für deine galerie! ich habe eben versucht die galerie zu installieren, auch mit erfolg, nun meine frage wie kann ich es schaffen, dass bei klick auf mein großes bild automatisch das nächste kommt? ist das überhaupt möglich? ich würde gerne vermeiden immer auf die kleinen bilder klicken zu müssen. vielen dank für deine hilfe!
gruß marion
Hallo Marion!
Nein, der Klick auf das Hauptbild wird bei diesem Plugin vom Feature "Links" genutzt, um auf externe Ziele oder das Originalbild zu verlinken und steht damit für die Navigation nicht zur Verfügung.
Gruß
Andreas