The simple PHP photo gallery
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.
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.
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.
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.
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
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:
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.
![]() |
Tweet |