I - bolGallery|Classic features
II - Install bolGallery
III - Parameters explained
IV - Create a gallery
V - Extra notes
VI - Conditions for use
VII - Free download
VIII - bolGalleryClassic sample

 


I - bolGallery|Classic features
+ Only 6 parameters !
+ Give the size you want to the thumbnails.
+ The thumbnail images are sorted by date.
+ Resizes reference images (if you set $resizeReferenceImage to "true"). Useful feature when you use high quality photos.
+ Simple comments system.
+ Resizes reference images. Useful when you use high quality photos.
+ Works with jpeg images only.
+ Does not use MySQL.
+ This right optimized script.
+
Coders I added for you some comments where the script can be improved.

II - Install bolGallery
First, make sure your server support php and has the GD library. If your are sure of it, leave this step. Else, you'll quickly check it by creating a simple php file calling the phpinfo() function. Create a text file and put it in "<? phpinfo(); ?>". Then name the text file "my_server_infos.php" (! Make sure the extension is *.php and not *.txt). Now send your php file to your server by FTP and lauch it (note you can delete this file when you want). A page with a lot of informations should be displayed, search for GD section. Now you are sure bolGallery works on your server.
So second, send to your server "bolGalleryClassic.php" file by FTP : bolGallery is installed!


III - Parameters explained
+ referenceImagesDirectory : where the big images are (must be ended by "/") (Example : "http://mySite.com/myBigPhotos/")
+ tableColumnsNb : Number of columns of the html table that diplays thumbnails.
+ thumbnailImagesMaxSize : thumbnail images max width or height (depends to the image proportions)

Reference images specific (You are not abliged to declare those parameters)
+ resizeReferenceImages : reference images resize switcher ("true" or "false"). "false" by default (so won't resize images).
+ referenceImagesMaxSize : reference images resize width or height (depends to the image porportions) max size. 640 by default.
+ referenceImageJpegQuality : reference images jpeg compression (0=bad 100=best). 70 by default.

IV - Create a gallery
Simply call the bolGalleryClassic() function on your php pages (Don't forget to include "bolGalleryCreative.php" before!) giving the parameters. Some parameters have default value, so you are not obliged to give values to those parameters. Note you can get include troubles if you use a free server. Contact your server for more infos about it. Or place "bolGalleryCreative.php" in the references images directory. That all!

<?php

// Include bolGallery

include("bolGalleryClassic.php");

// Create a gallery from the images from "./photos/" folder on a table of 6 columns with thumbnails of 50x50. The reference images resizing isn't activated.

bolGalleryClassic("./photos/", 6, 128);

? >


V - Extra notes
+ Why the thumbnails displaying doesn't change when I change parameters of bolGalleryClassic()? To be speeder, bolGallery doesn't recreate existing thumbnails. Even if you change parameters, if the thumbnails have already been created, none will change. So, on testing bolGallery setuping, delete the "thumbnails" directory created from your images directory each time you change parameters.

+ Comments system. A text with yellow background appears on mouse roll over thumbnails. Two ways to comment. First one, type name the reference images like "Mike_and_his_new_car.jpg" using "_" that will be displayed as spaces " ". Second, for longer comments, simply type your comment into a text file named using the image name : "image_name.jpg" adding ".txt" (like "myGirlfriend.jpg.txt").

+ If you create a site with several galleries using bolGallery, I advice you to create a little php file with your bolGalleryCreative setup. And use this setup on whole galleries by including it. Within this file, write your setup by declaring some variables you'll use when you call bolGalleryCreative() on your pages.

+ Why some of images from a folder are not displayed on the gallery? bolGallery works only with jpeg images (because that the most used format) maybe your images are in another file format. No rights to use gif image format. Coders could add a png support.

VI - Conditions for use
Use this script at you own risk. Not for commercial use (contact me).

VII - Free download
bolGalleryClassic.php (6 Ko)

VIII - bolGalleryClassic sample
Coming soon. Searching for images for demo. Let check http://enfantsdasie.free.fr/albums.