PHP Simple Gallery

Overview

PHP SimpleGallery is a free script used to create SEO friendly browsable galleries on the fly.

Images are resized automatically (configurable) and thumbnails are created on-the-fly only once, after that all requests are made directlyto the saved images, minimizing the server load and page load speed.

Features

Easy to install and use
Very fast - the number of requests to PHP scripts is very limited to support many visitors
Very low memory usage - the script uses under 1MB of memory for most requests
Valid XHTML
SEO optimized
Image resize on-the-fly - you can upload the images at any resolution and have them resized automatically
Image thumbnails generated on-the-fly - no need to worry about thumbnails, they are created when needed
Supports multiple galleries and sub-galleries

Requirements

PHP 5.1+
GD support for PHP
Apache with mod_rewrite

Installation

Unzip the package contents to temporary location.
Put the content of public/ directory to the image gallery in a public location on your server and the content of library/ outside the public folder.

Example:
```
/home/SimpleGallery/library/
                                   SimpleGallery/
/home/public_html/YourGallery/
                                   ImagesFolder1/
                                   ImagesFolder2/
                                   index.php
                                   config.php
                                   style.css
                                   .htaccess
```
Please note that although you can have as many image galleries as you want, they need to be stored in a public location (accesible through the browser). Don't worry, direct browsing of the folders is disabled using the provided .htaccess file.
Upload images in the public directory using FTP (or other method of your choice).
Edit config.php (see Configuration).
Test the installation by opening the gallery location in your browser.

Configuration

To configure PHP SimpleGallery you just need to edit the provided config.php file.

The source directory is the path to the image gallery. If you copied the config.php directly to the image gallery root there is no need to change this. You can however alter this value if you have a custom setup (not recommended).

    /**
     * Full path to the images source directory
     */
    'source_directory' => dirname(__FILE__),

The public url value must point to the public http location of your gallery.

    /**
     * Public url for the gallery
     */
    'public_url' => 'http://localhost/TestGallery/',

Image thumbnails will be created in a directory, the name of this directory can be customized (usually you can leave this value default).

    /**
     * Thumbnails directory name
     */
    'thumbnail_directory' => 'thumbnails',

Customize your gallery name.

    /**
     * The gallery name
     */
    'gallery_name' => 'SimpleGallery',

The script supports automatic image resize. Please be careful with this value since the operation will resize the images WITHOUT ANY BACKUP! If you do not want your images altered just set this parameter to false.

    /**
     * Automaticaly resize images
     *
     * WARNING! This will resize ORIGINAL images, no backup is made!
     */
    'auto_resize' => true,

    /**
     * Maximum image width
     *
     * NOTE: Only used when auto_resize is set to true
     */
    'max_width' => 800,

    /**
     * Maximum image height
     *
     * NOTE: Only used when auto_resize is set to true
     */
    'max_height' => 600,

You can customize the width and height of the thumbnails (normally you can leave these default).

    /**
     * Thumbnail width
     */
    'thumbnail_width' => 100,

    /**
     * Thumbnail height
     */
    'thumbnail_height' => 100,

If you want you can customize the values of accepted file extensions (separated by comma).

    /**
     * The accepted file extensions
     */
    'file_extensions' => 'jpeg,jpg,gif,png',

By default an image count for each gallery is displayed. You can turn this off for a small performance improvement or if you don't want to display the number of images in each gallery.

    /**
     * Display image count for each gallery
     */
    'count_images' => true,

When each image is viewed a number of thumbnails are displayed in the navigation bar before and after the current one. You can customize this value if you want (usually you can leave this default).

    /**
     * Maximum number of images to show before and after the current one
     */
    'max_nav_images_around' => 2

Demo

If you wish to test the product give the SimpleGallery demo a try.

Download

Download the latest version here:

simplegallery-1.0.0.zip (2.15 MB)

Documentation

Here is the documentation for PHP Simple Gallery.

Changelog

1.0.0 - 18/02/2011 - First release