Skip to content


Subversion checkout URL

You can clone with
Download ZIP
File-based Gallery for Joomla 2.5 and Joomla 3
branch: master
Failed to load latest commit information.
src added license and copyright info to header updated readme

Joomla Gallery


The Gallery component is a minimalistic and completely file-based photo gallery for Joomla 2.5 and Joomla 3. 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 my 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.

Install Instructions

  1. Download the component archive file.

  2. Install the package "" through the Joomla extensions manager.

  3. Create a new menu item for the gallery and set the path to the gallery folder relative to your Joomla root folder in the menu settings.

  4. Upload some JPG photos to the folder selected folder. 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.

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


  • core htaccess hack is no longer needed
  • fixed lightbox if mod_rewrite is not used


  • gallery is now compatible with Joomla 3


  • fixed an issue with the backing removal code
  • fixed a routing issue
  • fixed lazy loading issue
  • refactored to use native Joomla cache for thumbnails and preview images
  • the protection of the images with a htaccess file is now optional

Known Bugs

  • It is not possible to use the gallery as front page.

Report Bugs

Please report bugs directly on GitHub with the provided functions. It would be really nice if you could report all bugs you will find in the gallery.

Something went wrong with that request. Please try again.