UberGallery - The simple PHP photo gallery

Help keep UberGallery free for all, donate today.

Introduction

UberGallery is an easy to use, simple to manage, web photo gallery written in PHP and distributed under the MIT License. UberGallery does not require a database and supports JPEG, GIF and PNG file types. Simply upload your images and UberGallery will automatically generate thumbnails and output standards compliant XHTML markup on the fly.

Features

Simple first time installation
Database-less configuration
Include galleries within pre-existing sites
Create multiple galleries with a single installation
Easily customize your gallery styles via CSS
Install and update the gallery easily wth Git (optional)

Demo

View the Stand-alone Demo | View the Multi-directory Demo

Download Current Version: 2.4.8

Download as zip Download as tar.gz

UberGallery requires PHP 5.2+ and the PHP-GD image library to work properly.
For more information on PHP and the PHP-GD image library, please visit http://php.net.

Simple Installation

Copy resources/sample.galleryConfig.ini to resources/galleryConfig.ini and modify the settings to your liking.

Upload index.php, resources/ and gallery-images/ to your web server.

Upload images to the gallery-images/ directory.

Make the resources/cache/ directory writable by the web server:

chmod 777 /path/to/resources/cache

Open your web browser and load the page where you installed UberGallery.

Custom Installation

Copy resources/sample.galleryConfig.ini to resources/galleryConfig.ini and modify the settings to your liking.

Upload the resources/ folder to your web server.

Insert the following code into the PHP page where you would like the gallery to be displayed (be sure to change the include and image folder path to match your configuration):

<?php include_once('path/to/resources/UberGallery.php'); $gallery = UberGallery::init()->createGallery('path/to/images-folder'); ?>

Include the UberGallery and desired Colorbox style sheet in your page header:

<link rel="stylesheet" type="text/css" href="path/to/resources/UberGallery.css" />
<link rel="stylesheet" type="text/css" href="path/to/resources/colorbox/1/colorbox.css" />

Include the jQuery and Colorbox javascript files in your page header:

<script type="text/javascript" src="//ajax.googleapis.com/ajax/libs/jquery/1.10.2/jquery.min.js"></script>
<script type="text/javascript" src="path/to/resources/colorbox/jquery.colorbox.js"></script>

Include the Colorbox jQuery call in your header (below the jQuery and Colorbox javascript includes):

<script type="text/javascript">
$(document).ready(function(){
    $("a[rel='colorbox']").colorbox({maxWidth: "90%", maxHeight: "90%", opacity: ".5"});
});
</script>

Upload images to your images directory.

Make the resources/cache/ directory writable by the web server.

chmod 777 /path/to/resources/cache

Open your web browser and load the page where you installed UberGallery.

Install with Git

ssh into the your server and clone the UberGallery repository:

git clone --recursive git://github.com/UberGallery/UberGallery.git /path/to/ubergallery

Copy resources/sample.galleryConfig.ini to resources/galleryConfig.ini and modify the settings

cp resources/sample.galleryConfig.ini resources/galleryConfig.ini
nano resources/galleryConfig.ini

Upload images to the gallery-images/ folder within your gallery directory.

Make the resources/cache/ directory writable by the web server.

chmod 777 /path/to/resources/cache

Open your web browser and load the page where you installed UberGallery.

When using this method to install UberGallery, you can update your installation by running the following commands:

cd /path/to/ubergallery
git pull origin master

NOTE: If you are installing UberGallery via git into an existing git repository, you will need to add it as a submodule.

git submodule add git://github.com/UberGallery/UberGallery.git path/to/ubergallery
git submodule update --init --recursive path/to/ubergallery

Troubleshooting

Pages / Images Loading Slow or Not at All

If pages are loading slow or not loading at all, ensure your images are not too large. We recommend 1024px - 1280px for the longest side. Large images can slow down page and/or image load times or considerably.

If you have too many large images to resize one at a time here are a few batch image resizing tools:

Other Issues

Here are a few additional troubleshooting tips:

Verify that you have PHP 5.2 or later installed. You can verify your PHP version by running:
```
php --version
```
Make sure you have the latest version of UberGallery installed.

Replace your galleryConfig.ini with sample.galleryConfig.ini to ensure proper configuration:

rm resources/galleryConfig.ini
cp resource/sample.galleryConfig.ini resources/galleryConfig.ini

Clear your cache and make sure the directory is writable by the web server:
```
rm -f resources/cache/*
chmod 777 resources/cache
```
Enable debugging by setting the enable_debugging option in resources/galleryConfig.ini to true, try loading your gallery in a web browser then inspect the debug.log file in your cache directory for any errors.

If you continue to have issues, send us an email explaining your issue.

Frequently Asked Questions (F.A.Q.)

Does UberGallery support multi-directory listing?: Not directly. I'd love to add support for this eventually, but at the moment is not possible. However, generating multiple galleries from a single UberGallery installation is rather painless. You can check out a working example or see the code behind the examle on Github.
Can I use UberGallery on a site I'm developing for a client / company?: Yes, UberGallery is open source and released under the MIT license. The rights granted by these licenses should be sufficient to suit any situation. Also, while not required, it's encouraged that you leave the "Powered by, UberGallery" link below the gallery list.
How can I get news and updates pertaining to UberGallery?: You can follow us on Twitter: @UberGallery; We also have a blog at http://news.ubergallery.net; You can subscribe to the blog feed at http://news.ubergallery.net/feed
Can you add X as a feature?: At the moment I'm the sole developer of UberGallery and my time is severly limited thus limiting my ability to add new features. However, UberGallery is open source and hosted on Github. This means you are allowed to fork the code and make changes to suit your needs. You're also encourage to submit a pull request of the changes you make so I may review your changes and, upon approval, merge them into the UberGallery code base.

More Info

Have a question? Need help getting your gallery working?: Post your questions to our Google Group online or email our public mailing list at [email protected].; We do our best to answer all questions promptly, but sometimes life gets in the way. Please be patient.
Want the latest info on UberGallery?: UberGallery updates and news can be found on our blog or by following @UberGallery on Twitter.
Find a widespread bug?: Report it by opening an issue on our GitHub issue tracker.