EasyThumbs

Version History
Short information
Restrictions
Requirements
Long Information
Installation notes
Usage notes
Known Bugs

Category: PHP Version:2.2
Last page update:14.04.2003

»Download EasyThumbs.

Version History

- 2.2 New functionality, last and first page and navigation on the image page
- 2.1 Minor bugfixing with branding and unused directory switch
- 2.0 Templated, generates flat HTML pages now
- 1.0 Initial release

Short information

EasyThumbs is a customisable script to generate the HTML for thumbnail-galleries. Simply drop your images and thumbnails in a folder and write an HTML template for the gallery and the image display page,or use the sample templates. EasyGallery creates all the HTML pages needed to navigate through you gallery.

Restrictions

- Do not use it for non-private, profit orientated sites.
- Keep the information and link back on the page.

Requirements

- PHP 4
- correct folder attribute settings

Long information

EasyThumbs generates a fully navigational thumbnail gallery from some images and their thumbnails. You define the look and feel and the functionality in a template.

The whole script is template and comment driven so you do not need to know PHP at all to use it.

EasyThumbs allows you to define how many thumbnails in each row and how many per page to display and generates the links to navigate back and forth through these pages. Furthermore there is a display page for each image, that links to the next and previous images or back to the thumbnail page.

EasyThumbs generates flat HTML files that do not need the script itself to work, when you add new images, simply re-create the HTML files by calling EasyThumbs in your browser.

Installation Notes

Create a new folder on your server, set the file permissions to Read/Write all (chmod 777 or chmod 666).

If wanted, create a folder for your images (if you want to use the demo template call this folder "pics").

Copy all the images and thumbnails in this folder, or create an own folder for the thumbnails and copy them seperately (if you want to use the demo template, call your thumbnails tn_image.jpg).

Copy the two HTML templates and easythumbs.php into the main folder.

Rename easythumbs.php to any other name.php, to avoid surfers regenerating your pages over and over again, thus flooding your server.

Usage Notes

To use EasyThumbs, simply change the templates. They both come with extensive explanations in comments.

easythumbs_template.html

Is the gallery template, add/change the following comments to set the variables

Mandatory settings:

images:

the list of allowed files to read from the folder.

pagename:

the HTML filename of the gallery files (generated from this template). EasyThumbs automatically adds the digits for more than one page.

imagepagename:

the HTML filename of the image display files (generated from easythumbs_bigtemplate.html). EasyThumbs automatically adds the digits for the pages.

imagesonpage:

defines how many pictures are displayed on each page.

imagesinrow:

defines after how many pictures EasyThumbs shall add a break.

Additional settings:

imagesfolder:

The folder where the images can be found. This folder will be scanned for the files specified in "images". If you do not set this variable, the folder EasyThumbs resides in is the folder. Make sure to end this setting with a "/".

thumbnailfilter:

The addon to the filename to specify which images are thumbnails. Not needed when you put the thumbs in a seperate folder. Necessary when thumbs and images are in the same folder to prevent EasyThumbs to create entries for the thumbs as well. The files are checked via regular matching, if you set this filter to "tn_" "lalatn_.jpg" and tn_lala.jpg" will both be filtered.

Anything in between <!-- start:back -->and <!-- end:back --> will be displayed as the link to the previous page, the word %previous% in there will be replaced with the html filename to the previous page (to use in an href).

"first", "last" and "next" work the same way.

Anything in between <!-- start:image -->and <!-- end:image --> will be displayed for each image. %imagecounter% will be the number needed to link to the correct big image and %pic% is the name of the image itself.

If needed, add your image folder name to the src in the image. In any case, add the thumbnail prefix.

EasyThumbs will be replaced with the name of the image (underscores and file extension get replaced with spaces to allow wrapping).

If this sounds too complicated, check the template and you will see how it works.

%branding% will be replaced by a line saying that this was created with EasyThumbs, please add this to your templates as well.

easythumbs_bigtemplate.html

Is the image template, add/change the following comments:

Anything in between <!-- start:image -->and <!-- end:image --> will be displayed as the image.

%sourcepage%

will be replaced with the filename to link back to.

%pic%

is the image folder and image name, do NOT add the image folder name here!

%size%

are the HTML size definitions.

EasyThumbs

The name of the image (underscores and file extension get replaced with spaces to allow wrapping).

%branding%

The EasyThumbs link and info, please leave it in.

Known Bugs

- The thumbnail size gets not added automatically, you need to do that either by hand, or leave it to the browser to display them in the correct size.