BolGallery - Simple PHP image gallery

Demo - Download - Install - Parameters - FAQ - TODO

A powerful & simple PHP gallery script !

Is bolGallery what I am searching for my website?
If you want just put your numerous images in a folder and don't want to waste your time making all the thumbnails by hand, lay them out, link them to the big one, check for errors... but you still want to have some parameters to integrate bolGallery in your site design. YES, bolGallery is the tool you want. Just put your images in a folder and let it do all!

What does bolGallery do?
Automatically lists your images directory, on-the-fly creates thumbnails and displays them into a simple table. On clicking an image it open a smart one-click-close popup. You can choose between two thumbnail style modes : creative which focuses on a detail of the big image (by default) and classic which creates a simple miniature of the big one. Innovative static page system displays your galleries quicker! And much more.

Nicolas d'Haussy

	Script features or Why using bolGallery !
	Easy to install 4 parameters only 2 thumbnail display styles Simple display & smart integration to your site design Well documented Free	One-click-close popup Thumbnails sorted by date Now Supports JPG, GIF and PNG Optimized source & HTML output Automatic static page system New Does not use MySQL

Featured by :

Demo

Creative mode example using : bolGallery("./creativeDemoImages/", 8, 85, 85)
(You could also check http://ndhaussy.free.fr)





Generated by bolGallery

Quick install

Put all your images in a directory on your FTP server (using a ftp client such as FileZilla).

Download and put bolGallery.php file (or wherever you want on your FTP). It contains the bolGallery() function that you will call to create galleries.

Make a .php file (for instance "index.php") with a simple text editor (such as Note Pad) in which you paste the following lines. The gallery will be displayed where you call bolGallery() function in your page.

Then you can give your parameters at the seconde line (described below) for your gallery setup.

Do not forget the "<? ?>" and to end your images url by a slash "/".

<?
include("./bolGallery.php");
bolGallery("./images/", 5, 80, 50);
?>

That's all! Upload this php page to your remote FTP and launch yit with a browser (such as FireFox) and let's its magic!

Parameters

To work, bolGallery needs at least 4 parameters (in bold). There are also two extra parameters you are not obliged to give (in italic). Those arguments must be given in the right order.

bolGallery($referenceImagesDirectory, $tableColumnsNb, $thumbnailWidth, $thumbnailHeight, $switchClassic);

$referenceImagesDirectory : gives the directory url address where the big images files are located.
$tableColumnsNb : gives the gallery table columns number (the number of images by line).
$thumbnailWidth & $thumbnailHeight : give the thumbnail images size.
$switchClassic : enable you to switch thumbnails displaying style between creative (value 0 by default) or classic (value 1). Creative creates thumbnails with the size you want focusing on a detail of the image. Classic create miniatures of the big images. Give 0 or 1 to switch to a mode to another (note that you must delete thumbnails directory to see the changes, see FAQ).

Frequent Asked Questions

General questions

Why have you scripted bolGallery?
For my own pleasure (he must be mad). In fact, I was searching for a simple and powerful gallery script for a while... And there was no relevant scripts online. So I decided to code it myself. I had no particular skills at scripting. Today, I'm glade to share it to you... And Bolga, that's my nickname.

How to have a the thumbnails to be reel miniatures of big images?
In your bolGallery setup, you can turn on classic mode adding a "1" at the end like bolGallery("./images/", 5, 80, 50, 1);

How to prevent many images not to be displayed by bolGallery?
All marked images won't be processed by bolGallery. For that, add a "#" at the begging of a image file name (e.g. "#hiddenImage.jpg").

Why is their a file "bolGallery.html" in my FTP?
This page is a bake file of bolGallery. It is a HTML page which is updated each time you add or remove an image from your reference image directory. Because it is a simple HTML page it is quicker to load it. It works a bit like permalink of forum or blog scripts. Even though you server lags, many visitors would get your galleries quickly.

How to resize reference images?
It would be useful to reduce digital camera output thanks to bolGallery. This feature is not available for now but will appear in the next versions of bolGallery.

I've an idea or spotted something to improve, should I contact you?
Sure ! I'm really willing to provide the better.

Problem solving

Why thumbnails appearance does not change even though I've modify bolGallery parameters?
Once the thumbnails are created they won't be recreated next time for speed reasons. If you want to modify thumbnails features (width and height or even style) you have to delete through FTP the "bolGallery" directory (that contains created thumbnails) which is in the reference images directory. The first time you setup bolGallery you might often do that.

The thumbnail images can not be created.
Maybe GD library (which creates images) is not installed on your server. Create a *.php file in which you copy : <? phpinfo(INFO_MODULES); ?> Put this file on your FTP and run it with your internet browser. Check if GD table is on the displayed page. Else you can't run bolGallery (even not another PHP gallery system). Sorry, ask you server admin to install GD.

Scripting tasks At your own risk

How to to have a gap between thumbnails?
Edit bolGalleryCreate(). Edit the <TABLE> HTML tag (e.g. change cellspacing to 2).

How to have the older image first ?
Edit mtime_sort() function. Swap arguments order ($a and $b).

I want the images not to be sorted by date, how to?
Edit bolGallery(). Delete line from "@usort(". You should remove the mtime_sort() function.

How to have bolGallery not to open images in popup windows?
Edit bolGalleryCreate(). Remove the Javascript popup function decalration. Delete Javascript syntax in <A> HTML tag from "onClick=".

What workflow do you advice for massive use of bolGallery?
I would advice you to use one php file containing the variables you use to setup bolGallery. Then include this small configuration file before calling bolGallery() in all your pages. I would also advice to read the FAQ about CSS style. Note that in next versions of bolGallery their may be a kind of permalink system with baked pages.

TODO
In the next version...

Documentation improvements
Have this documentation traduced in french and german. Create a install assistant for beginners. Adding a forum for users to communicate.

Script improvements
>Provide several directory sorting methods. For now, Bolgallery sorts by date.
>Reducing URLs string work in the script.

Creative thumbnails creation
I will to improve the way the detail focusing thumbnails are created (creative mode). Just to see much details, but not too much.

Resize big images automatically
It would be just nice to resize digital camera output images. I plan to implement this feature basing it on a bolGallery already existing function : resizeImage()