UberGallery

An easy to use, simple to manage, web photo gallery written in PHP.

Programming language: PHP

License: MIT License

Tags: Photo and Video Galleries    

Latest version: v2.4.8

README

UberGallery - The simple PHP photo gallery

Created by, Chris Kankiewicz

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.

Like this project? Make a donation.

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)

Requirements

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

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

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

3. Upload images to the gallery-images/ directory

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

     chmod 777 /path/to/resources/cache
   

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

Custom Installation

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

2. Upload the resources/ folder to your web server

3. 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'); ?>
   

4. Include the UberGallery and ColorBox style sheets 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" />
   

   ℹ️ You can replace the 1 with a value between 1 and 5 for different ColorBox themes.

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

6. Include the ColorBox jQuery call in your header

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

7. Upload images to your images directory

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

     chmod 777 /path/to/resources/cache
   

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

Install with Git

1. SSH into the your server and clone the UberGallery repository and submodules

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

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

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

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

     chmod 777 /path/to/resources/cache
   

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

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

cd /path/to/gallery-directory
git pull origin master
git submodule update

ℹ️ 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

Please report bugs to the Github issue tracker.

If you're having issues with UberGallery here are a few 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

News & Updates

For UberGallery updates and news follow @UberGallery on Twitter.

License

UberGallery is is licensed under the MIT License.