Joomla Gallery


The Gallery component is a minimalistic and completely file-based photo gallery for Joomla 2.5. File-based means that there is no need for a database and you could manage all your photos in just one place: the file system. The gallery is really simple to use: When you are creating a gallery, just upload your photos to the gallery folder and the whole gallery is automatically created.

The Joomla Gallery extension is the indirect successor of the Photoblog component.


You could find a demo of the "Gallery" component in the "Demos" section of this website.


The "Gallery" component for Joomla 2.5 is published under the GNU AGPL v3 license. See for more details.

System Requirements

To run the Gallery on your Joomla! installation your server should satisfy the system requirements below:

  • PHP 5.3
  • Apache webserver
  • MySQL 5

Maybe you are able to launch the component on other systems (e.g. running with MySQL 4), but I only have tested this configuration.


Please have a look at the install instructions below.

Unofficial Releases

Following an unofficial gallery release for Joomla 3.x provided by Kay Olutayo from Komfi Solutions. Please be aware that I published the component as provided and I have not checked it for functionality, security issues and so on.

Install Instructions

  1. Download the component archive file from this website.
  2. Install the package "com_gallery-x.x.x.tar.gz" through the Joomla extensions manager.
  3. Modify line 68 of your .htaccess file (RewriteCond %{REQUEST_URI} /component/|(/[^.]*|\.(php|html?|feed|pdf|vcf|raw))$ [NC]) if you are using SEF URL's and add |jpg to the rewrite condition. The line should look like this: RewriteCond %{REQUEST_URI} /component/|(/[^.]*|\.(php|html?|feed|pdf|vcf|raw|jpg))$ [NC]. Otherwise no images would be shown.
  4. Create a new menu item for the gallery and set the path to the gallery (relative to your Joomla root folder) in the menu settings.
  5. Access the menu item through the front-end (your website) or create a folder named "photos" in your gallery path. In the first case, the folder "photos" is automatically generated.
  6. Upload some JPG photos to the folder "photos". You could do this through the Joomla media manager or via FTP. You are free to choose your own folder structure to organise your photos. The original photos shouldn't be to large, because the PHP memory limit would maybe exceeded when generating the preview photos or thumbnails for large photos. A maximum width and height of about 1600x1600 pixels should work fine.
  7. Access the gallery via the front-end. The first call of each folder could take some time because the preview photos and thumbnails are just generated.

Note: Breadcrumbs are used as navigation. So if you like to use navigation, you have to add a breadcrumbs module!



  • initial release


  • added index.html to all folders


  • important bug fix


  • Changed license from GPL to AGPL
  • Piwik will track the clicks (next/previous) in the lightbox
  • Added detection of non existing paths
  • JQuery could be loaded optional
  • Added a backlink to (Could be deactivated in the settings)
  • Added support for lazy loading (must be activated in the settings)
  • Better error handling


  • added robots noindex for category pages
  • added support for name converter plugins
  • parameters for width/height of thumbnails and resized preview photos
  • support for iptc information (show title and description in shutterbox)
  • removed capty -> always show folder name (for usability reasons)
  • show folders and photos in one folder at the same time


  • added remove backlink code
  • one bug fix

Known Bugs

  • The lightbox does not work if Joomla SEF is completely turned out.
  • It is not possible to use the gallery as front page.

Report Bugs

The source code of the gallery is hosted on GitHub. There it is possible to report bugs. It would be really nice if you could report all bugs you will find in the gallery.

Joomla Gallery on GitHub


The google group Webguerilla Development is currently used as temporary support forum and bug tracker. A dedicated forum will follow someday.