I - bolGallery|Creative features
II - Install bolGallery
III - Parameters explained
IV - Create a gallery
V - Extra notes
VI - Conditions for use
VII - Free download
VIII - bolGalleryCreative sample
I - bolGallery|Creative features
+ Only 7 parameters !
+ Give the width and the height you want to the thumbnails
knowing that with the creative version, a thumbnail aims to
show a detail of the reference image.
+ Soon image effects on 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 "bolGalleryCreative.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.
+ thumbnailWidth : thumbnail images width
+ thumbnailHeight : thumbnail image height
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 bolGalleryCreative() 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("bolGalleryCreative.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.
bolGalleryCreative("./photos/", 6,
50, 50);
? >
|
V - Extra notes
+ Why the thumbnails displaying doesn't change when
I change parameters of bolGalleryCreative()? 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.
+ Soon you'll can apply CSS style specific to
the gallery thumbnails. Creating style for the pseudo
class "bolGalleryStyle".
VI - Conditions for use
Use this script at you own risk. Not for commercial
use (contact me).
VII - Free download
bolGalleryCreative.php (7.4 Ko)
VIII - bolGalleryCreative sample
Coming soon. Searching for images for demo. Let check
my site http://ndhaussy.free.fr.
|