Home Joomla CSS Gallery
Joomla: CSS Gallery
Written by Andreas Berger   
Sunday, 14 December 2008 12:07

The bretteleben.de "CSS Gallery" Plugin for Joomla!2.5 and Joomla!3.1 is an easy to configure plugin, that enables you to display a gallery with thumbnails in a content item. Unlike other gallery-plugins the CSS Gallery works with pure X-HTML and CSS without JavaScript, Flash or any other script/player.


- supports .jpg, .png und .gif
- can be aligned in your content item left, right, centered, float left or float right
- 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 thumbnail to a different target (Links)
- optional use a default link for the whole gallery
- works without JavaScript


New in Version 1.3.7:

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


Howto Plugin Howto Plugin Howto Plugin Howto Plugin Howto Plugin Howto Plugin Howto Plugin Howto Plugin Howto Plugin Howto Plugin


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.

Not all browsers support the feature of hiding the main image on mouse:hover. This works with IE7, IE8b, FF and Opera. Google Chrome, Safari and IE up to version 6 don´t.
This is of relevance only if you have images with different proportions (width<>height) in one set. In this case the first image should be one, that does not use the full given space, this way ensuring, that it is covered by the other images.


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


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.


The plugin is licensed under the GNU Public License (www.gnu.org/copyleft/gpl.html).

update Version Joomla!2.5 and 3.1: 1.3.7

- 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_cssgallery_v1.3.7_J2.5.zip Downloads: 13.936

- plg_cssgallery_v1.3.7_J3.1.zip Downloads: 21.178

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

Last Updated on Sunday, 18 August 2013 13:15
Comments (33)
Can't install plugin
33 Wednesday, 02 May 2012 18:03

Hi, I really want to give your great plugin a try, but I can't seem to install it correctly.
I'm using the 2.5 version, and when uploading the .zip file, there's an error message, "can't find xml file". But it's there!
Then I tried installing from tmp directory, pointing directly towards the xml file. Now. the error message says "unknown file type".
What could I be doing wrong? Any assistance will be very appreciated!

Thursday, 03 May 2012 21:01

Hi again, the installation was done properly this time. Thank you very much! I'm impressed about how fast you reply for a free plugin you created years ago.

Keep up the great work, we really appreciate it!

Wednesday, 02 May 2012 20:17
A. Berger

Hi Carla!

First, try to install from URL (right click the link to the zip on this page, copy the link location and paste it into the field "Install URL". This way you make sure that you are not trying to install a package that got corrupted during your download.
If the error persists, please (in your Joomla! backend) go to Site > System Information > Directory Permissions and check if the path to the "Temp Directory" directory is writeable. If it isn't, please change it.
If the error still persists, please do some further reading: http://docs.joomla.org/Why_can't_you_install_any_extensions%3F

Best regards

problem with plugin
32 Thursday, 19 April 2012 17:09


i just want to thank you for your great plugin
when i had joomla 1.5,it worked just fine
unfortuanally i have some problem usin it in joomla 2.5
you can see what im talkin about in this goo.gl/iqAyO

Friday, 20 April 2012 22:46

Problem solved

Thanks to you

Friday, 20 April 2012 22:19
A. Berger

Hi Rash!

Install version 1.3.6 I just uploaded. It !should! solve the problem. If it doesn't, please post again.

Best regards

Thursday, 19 April 2012 23:42

Hi again

i was talkin about a template issue  due to the plugin
look in the bottom of the page

Thanks for your fast support btw

Thursday, 19 April 2012 19:42
A. Berger

Hi Rash!

I see a working gallery. Problem solved? :)

Best regards

Titles on CSS gallery in Internet Explorer
31 Wednesday, 18 April 2012 15:15
Colleen Cook

Hi -- great plugin! Just a quick question about how it looks in Internet Explorer. The titles of the captions of images appear very bold, almost unreadable, in the CSS gallery when viewed in Internet Explorer. Is there a fix for that? Thanks!

@Colleen Cook
Wednesday, 18 April 2012 20:57
A. Berger

Hi Colleen!

What version of Internet Explorer are you using and what operating system?

Best regards

auto fit screen
30 Thursday, 12 April 2012 21:56
Michael C.

Is it possible to have your plugin to auto fit different resolutions, or is it more simple to go into the .css of my template and do it that way? Reason I am asking is I have a 800x700 slideshow and on smaller resolutions it goes beyond the sheet.

Thank you for your time,
Michael C.

P.S. I really love your plugin

@Michael C.
Friday, 13 April 2012 19:45
A. Berger

Hi Michael!

The plugin has up till now no responsive-capabilities. One possible way to overcome this could be to use an extension like "Sourcerer" or a similar extensions and use it to dynamically fetch the current device and set the parameters for the CSS Gallery (using the feature "Parameter Override") accordingly.

Best regards

29 Wednesday, 11 January 2012 20:08

Hey, Love the gallery, however when I change the picture and the link address the link doesn't work any more. Is their a fix?

Thursday, 12 January 2012 10:56
A. Berger

Hi Perry!

Please provide a link to the page, I will have a look at it.

Best regards

Link to anchor causes page to crop.
28 Thursday, 15 December 2011 04:31

Hi, GREAT plugin. I love it.

Just one little issue, I have the plugin loaded into a module and it's working great through plugin to module extension.
When ever I click an image, it crops the top header section of my site completely. The scroll bar resizes and I am no longer able to access my header and therefore I cant access any of the menus.
Any ideas why this may be so?


Monday, 19 December 2011 21:39
A. Berger

Hi Noble!

I can only guess that it might have to do with the stylesheet of your template, but if you provide a link to the page with the gallery, I will have a look at it.

Best regards

Is it possible to open Gallery with a simple weblink?
27 Friday, 25 November 2011 20:17

I am trying to use this great plugin and i do want to put a link on my site where it simple open the selected Gallery. (sorry i am not a pro Joomla User)

Thanks in Advance
(Joomla 1.7.3 and newest plg from here)

Sunday, 27 November 2011 10:54
A. Berger

Hi André!

The CSS Gallery is a Content Plugin that creates a gallery within an article. This means for your purpose you have to create an article, insert the code for the gallery and link to this article.

Best regards

Textumbruch um die Gallery
26 Friday, 25 November 2011 13:16

Hallo Andreas,

tolle Arbeit! Ich möchte die Gallery in einem Beitrag links ausgerichtet veröffentlichen. Der eigentliche Text im Beitrag soll um die Gallery laufen. So wie in Word wenn ein Bild im Text steht und du dann bei Layout die Optionen für den Textumbruch einstellen kannst. Ist sowas möglich oder muss ich mir da was anderes suchen??

Danke für Deine Hilfe.

Sunday, 27 November 2011 10:45
A. Berger
CSS gallery error message
25 Tuesday, 22 November 2011 05:58
Frith McDaniel


Would you be able to help me. I have installed the gallery as per instructions, but I am getting this message on the page;

CSS Gallery: Could not find folder /home2/plbphoto/public_html/images/images_homepage/cssgallery=images/images_homepage/

Could you please advise what I am doing wrong.

Many thanks


@Frith McDaniel
Tuesday, 22 November 2011 19:52
A. Berger

Hi Frith!

If the images are stored in the folder "/images/images_homepage/cssgallery" and the parameter "Image root" in the configuration panel of the plugin is set to "/images/" the code in the article should be:
{*becssg}images_homepage/cssgallery{/becssg*} ... without the asterisks

If the problem persists, please provide:

- the setting of the parameter "Image root"
- the code you are using in the article
- the path/folder you uploaded the images
- the Joomla! version you are using
- if any possible a link to the page

I'm sure we will solve this.

Best regards

please help; I have an error
24 Friday, 11 November 2011 16:53

sorry, I did every step on your instalation text; I changed nothing except the thumbnail quality which I set to 70; I use joomla1.7.2 and your plugin 1.3.5   the 1.7.2.zip ;
the parameters contain map /images/  and within thatI have 6 foto's in .jpg format in map fotosevent2011_p1
(in total I have 40 fotos to display, but for this try-out I used only 6)

I got the following error
Fatal error: Allowed memory size of 67108864 bytes exhausted (tried to allocate 20736 bytes) in /home/deb49390/domains/itunited-event2011.nl/public_html/joomla/plugins/content/cssgallery/files/cssgalleryhelper.php on line 150  

when the gallery would work as promised I would be very glad
thanks in advance

Sunday, 13 November 2011 21:51
A. Berger

Hi Ruud!

Please check the Page "FAQ&Troubleshooting" (menu at the left), it deals with this problem.

Best regards

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


Add to circles

Who's Online
We have 101 guests online