Home Joomla Very Simple Image Gallery
Joomla: Very Simple Image Gallery
Written by Andreas Berger   
Saturday, 19 April 2008 07:47

The bretteleben.de "Very Simple Image Gallery" Plugin for Joomla!2.5 and Joomla!3.1 is a downgrade of the ingenious plugin "Simple Image Gallery" from Fotis Evangelou und George Chouliaras back to a "Web 1.0" gallery. The modified version comes without a lightbox, the plugin shows one large image, followed by thumbnails.

Why? Look, as stylish and usability-oriented the whole category of "Web 2.0" galleries may be, they have - from my point of view - a serious disadvantage. The hide the web page from the visitor. If you run ads on your site, this is a not-so-desired effect. You don´t care about search engine optimization, keywords, backlinks and so on to see your banners, skyscrapers, rectangles and link blocks disappear behind a black curtain - out of sight and unclickable.


- supports .jpg, .png und .gif
- can be aligned in your content item left, right, centered, float left or float right
- thumbnails optional below, left or right of the main image
- optional split galleries into multiple sets
- as many galleries per content item as you want
- every gallery can be configured individually (Parameter Overrides)
- optional show title and/or text with every single picture (Captions)
- optional show default title/text for the whole gallery
- optional link every single image to a different target (Links)
- optional use a default link for the whole gallery
- optional link the image to the original image file
- scale thumbnails optional proportionally or cropped
- works with and without JavaScript
- does not require a JavaScript Framework (Mootools, JQery)!
- change main image onClick or onHover

New in Version 1.6.8:

- language files
- available for Joomla!3.1

Installation and Usage

A step by step tutorial on installation and usage can be found at Howto Plugin .
The possibilities the code inside the article offers can be found at Howto Plugin Code .
In addition you find some samples in the menu at the left.

If you modified the stylesheet vsig.css, you should save it because it gets overwritten during an update.


bwd  Set 1/2  fwd


This version of the plugin uses one script, doing the whole work. This may cause - when using very large image-files - the maximum execution time of PHP to be exceeded on your server. If this happens, the script fails with an error.

In this case, just refresh the page one or two times. This should be enough to get all images scaled. As soon as the plugin in configured and all images are scaled, everything works fine and your visitors will not be affected. Anyway, the next version of the plugin will come with an extra-file, doing the work of scaling.


The plugin requires the PHP GD library to generate the images and thumbnails.


The plugin is tested successful with Joomla 2.5 and 3.1. Anyway, using it aside with one or another existing plugin/modul/component may bring to light problems i haven't foreseen. I suggest a test run before using it on a live site and stand by for your questions and suggestions.


Following the guidelines of the original, the "Simple Image Gallery", the plugin is licensed under the GNU Public License (www.gnu.org/copyleft/gpl.html).

update Version Joomla!2.5 and 3.1: 1.6.8

- fixes a bug with PHP5.4
- available for Joomla!3.x
- language files


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


The ZIP-archive contains the plugin, by downloading it you agree to the terms of the GNU Public License. The ZIP-Archive can be used for both, upgrade and fresh installation. Please choose the file that fits your Joomla! installation. _J2.5 for Joomla! 2.5.x and _J3.1 for Joomla! 3.x

J!2.5.x - plg_verysimpleimagegallery_v1.6.8_J2.5.zip Downloads: 26.499

J!3.1.x - plg_verysimpleimagegallery_v1.6.8_J3.1.zip Downloads: 37.478

If you use this extensions, please post a rating and a review at extensions.joomla.org.

Last Updated on Friday, 16 August 2013 07:29
Comments (105)
Remove the backround border
105 Thursday, 10 May 2012 20:33

first of all would like to congratulate you for your work.
My problem has to do with the background of the images. Since my site background has a percentage of transparency all the colors of the backround doesnt look nice. Is there a way to insert an image with out having a background at all?
I use Joomla 2.5.4

thanks in advance

Thursday, 10 May 2012 20:39
A. Berger

Hi Konstatinos!

All the backgrounds/borders are specified in the stylesheet of the plugin located at /plugins/content/verysimpleimagegallery/files/vsig.css. Just set to transparent whatever fits your needs. :)

Best regards

Links to original images don't work
104 Wednesday, 09 May 2012 16:53
Tapani Räikkönen


I just can't figure out why some photos are linked properly to the original photos and some don't. The page is www.vantaacup2012.com/fi/kuvat/143-friday

I noticed that working images have ending .jpg and others not, e.g. 'kuva 204.jpg' works but 'Kuva 207' don't. Why is the ending not seen in every image? Original images are ok. Should I delete all thumbs and main images? Does vsig create them again automatically?
I have Joomla 2.5.4 and vsig 1.6.7.


@Tapani Räikkönen
Wednesday, 09 May 2012 21:03
A. Berger

Hi Tapani Räikkönen!

Thanks for pointing me to this - it's a bug of the plugin. The parameter to auto link the original image does not work with uppercase-imagenames.
I will fix this with the next update.

Best regards

Link to original
103 Tuesday, 08 May 2012 20:56

The "link to original is broken" in my installation (Joomla2.5). I fixed it by editing the code directly.
There is a line


which creates the $setlinks variable which is never used as far as I can tell. I just put the following code immediately after and problem fixed.

$cur_link = array($_link2,$_link3,"_blank");

Am I the only one who has found this? If so what else could be wrong?
Otherwise very good plugin and very simple.


Wednesday, 09 May 2012 20:53
A. Berger

Hi kw!

The parameter to link the original image works fine for me. If you could provide a link to a sample page (with the unpatched script), I will have a look at it.

Best regards

Simple Image Gallery
102 Tuesday, 08 May 2012 15:56
Greg Smith

VSIG 1.6.7  Joomla 2.5.4  PHP 5.4.1  GD 2.0.34

Problem, plugin was creating frames only in article when page displayed.
VSIG was not creating valid images in the sub folders ( vsig_images and vsig_thumbs)
Reverted to PHP 5.2.17 and images were crated and displayed properly.

Thought you might like to know.
This is a great plugin, thanks

@Greg Smith
Wednesday, 09 May 2012 20:37
A. Berger

Hi Greg!

Thanks for the tip - I will check this.
Was PHP 5.4.1 compiled with libJPEG (shown in the GD section of PHP info)?

Best regards

neu geladene Bilder werden nicht angezeigt
101 Wednesday, 02 May 2012 15:37


Hat alles 1a funktioniert (Joomla 2.5, site noch offline), allerdings hatte ich im Bilderordner nur 2 Bsp Pics. Nach erfolgreicher Konfiguration hab ich neue Bilder in den Ordner geladen, gespeichert, refresh, neu geladen etc. - nur leider werden die neuen Pics nicht angezeigt. Die Galerie zeigt nur 2 Thumbnails statt 6.

Reicht die info für Hilfe und wieviele Bilder kann die Galerie max. beinhalten? :-) Danke!

Wednesday, 02 May 2012 20:23
A. Berger

Hallo Kresch!

Erstens, bitte überprüfe - wenn Du mit Windows arbeitest - die Dateieigenschaften der "neuen" Bilder. Stell sicher, dass sie nicht "schreibgeschützt" sind, genauso das Verzeichnis mit den Bildern und die Unterverzeichnisse. Arbeitest Du mit OSX oder einem sonstigen *NIX, dann check die Dateirechte/Verzeichnisrechte (755 - Ordner, 644 - Dateien).
Löst das das Problem nicht, dann schalte mal im Joomla! Backend den Cache aus (und leere ihn komplett), System Cache, Page Cache, eventuelle Drittanbietererweiterungen.

Was die maximale Anzahl der Bilder angeht - ich habe kein Limit gesetzt. :)


double image folder
100 Saturday, 28 April 2012 21:28
Axel Martinez


Is anybody knows why I have a double image folder.
I typed /images/lensofmanoj/ in the script...

CSS Gallery:
Could not find folder /home/ceasarpr/public_html/images/images/lensofmanoj/


@Axel Martinez
Tuesday, 01 May 2012 15:23
A. Berger

Hi Axel!

Because the folder /images/ is already set as the default image root in the configuration panel of the plugin (see parameter "Image root"). Don't repeat it in the code.

Best regards

Is it posible to change the image sets alignment to center or left?
99 Friday, 27 April 2012 14:33
B. Angelov

Hello , I think the plugin is great too. But I have a little problem , is it possilble to change the position where the image sets are displayed ? I found the option about the thumbnails but it seems not to affect the "sets" text/links above them (I can't see such effect in the samples on this site either).In the source code there is also unused div tag with class "vsig_ctrl_left" before the sets div (class "vsig_ctrl_right")  but it doesn't look posible to manage the sets to use the left instead  the right div tag.

@B. Angelov
Tuesday, 01 May 2012 15:40
A. Berger

Hi B. Angelov!

It is possible. Set a fixed width for "vsig_ctrl_right" (e.g. 98% ... give it a try, I didn't test this) and you will be able to use "text-align" to move the elements around.

Best regards

Changing attributes of the text
98 Monday, 23 April 2012 20:28

This is a great little plugin! However, I would like to increase the font size for the text under each image and increase the number of characters the text area can contain. Is this doable?

Changin Attributes
Thursday, 26 April 2012 01:49

This solved the caption for me. Thanks for all your help!


Tuesday, 24 April 2012 20:33
A. Berger

Hi mfoxx75!

The text of your captions is there, the plugin just isn't able to reserve the necessary space for them itself. Just add 2 or 3 linebreaks or paragraphs after the code of the slideshow (you are using the "Simple Picture Slideshow", not the "Very Simple Image Gallery") in your article and you should see the complete captions.

Best regards

Changing attributes
Tuesday, 24 April 2012 01:52

I'm actually using the Simple Picture Slideshow. I was able to increase the font size following your instructions. Looks great! Thanks so much for your quick response. However, I'm still having problems getting all the text to display. I don't think it is being truncated, I just don't think the text area has been set large enough to display all the text. Below is a link I hope will illustrate what I mean.


Thank you so much for your assistance. I'm a newbie to Joomla and am still learning how everything fits together. Your plugin was super simple to use and I really appreciate that.

Monday, 23 April 2012 21:09
A. Berger

Hi mfoxx75!

First, to change the captions, open the stylesheet (/plugins/content/verysimpleimagegallery/files/vsig.css) with a text editor. You find the settings for the captions in the following lines:
.vsig_top div span {...}
.vsig_top div span + span {}
The first sets the general settings (title+text), the second line sets the parameters the are different for the second line, the „text“-line.

Second, you found a limit for the charcters of the captions? Interesting, because I didn't include one. Check the third image of the sample gallery above.

Best regards

weitere Bilder hinzufügen
97 Saturday, 21 April 2012 16:19


die Image Gallery finde ich supper, ich habe nur ein kleines Problem: wenn ich einem bestehenden Bildordner später weitere Bilder hinzufüge, werden diese nicht angezeigt. Was mache ich falsch, bzw. wie muss ich vorgehen? Vielen Dank für einen hilfreichen Tipp.

Beste Grüsse

Sunday, 22 April 2012 09:45
A. Berger

Hallo Kathrin!

Wenn die Bilder nicht sofort angezeigt werden, dann kann das am Joomla!-Cache liegen (einfach mal komplett leeren). Wenn sie überhaupt nicht angezeigt werden, dann überprüfe bitte die Datei-/Verzeichnisrechte des Ordners, in dem die Bilder liegen (Ordner 755, Bilder 644).
Stell außerdem sicher, dass die Bilder in den Hauptordner hochgeladen wurden, also in den Ordner, den Du im Code angibst und nicht in einen der vom Plugin für die skalierten Bilder und Thumbnails erzeugten Unterordner.
Hilft das alles nichts, dann poste bitte einen Link zur Seite mit der Galerie und die Dateinamen der Bilder, die nicht angezeigt werden.


Modifying navigation
96 Saturday, 21 April 2012 12:44


I need your help. I would like to modify the navigation part in this way. Placing the buttons at the begining and the end of the thumbnails and removing the set and numbers. Is it possible ? And if yes, anyone can help me.

Thanks for this great plugin

Sunday, 22 April 2012 09:32
A. Berger

Hi Dimitri!

Yes of course it is possible, but it is definitely beyond the scope of the free support I can offer.
Anyway, the extension is GPL-licensed, so maybe you find someone else who is willing to modify it for you.

Best regards

Panoramic Image Viewer
Follow me on Facebook
Follow me on Google+


Add to circles

Who's Online
We have 103 guests online