PHP Classes

ImgBrowz0r: Display galleries of images stored in files

Recommend this page to a friend!
  Info   Screenshots Screenshots   View files View files (4)   DownloadInstall with Composer Download .zip   Reputation   Support forum (1)   Blog    
Last Updated Ratings Unique User Downloads Download Rankings
2009-09-22 (7 years ago) RSS 2.0 feedNot yet rated by the usersTotal: 682 All time: 4,599 This week: 697Up
Version License PHP version Categories
imgbrowz0r 0.3.4Custom (specified...5.0PHP 5, Graphics, Content management
Description Author

This class can be used to display galleries of images stored in server side files.

It scans a given directory for images with file name extensions of GIF, JPEG and PNG image formats.

The class can generate thumbnail image files which are used to display the gallery images in an HTML table.

The thumbnails are presented as links to pages to show the full size images.

Name: Frank Smit <contact>
Classes: 1 package by
Country: The Netherlands The Netherlands
Age: 27
All time rank: 271575 in The Netherlands The Netherlands
Week rank: 997 Up28 in The Netherlands The Netherlands Up


# Introduction

ImgBrowz0r is a class written in PHP5 (tested with 5.2.9) that enables you to set up
a simple gallery with basic configuration in 10 minutes. It's also possible to integrate
it into a CMS or your existing website. You can also configure various other things like
sorting order and thumbnail sizes (etc. etc.).

It does things like generating thumbnails, generating pagination/breadcrumbs and outputs
XHTML that is provided with classes and ID's so everything can be extended and changed
with Javascript and CSS.

The only thing you have to do is install it and upload your images. And maybe clean
the cache once in a while.

# Features

 - Infinite nesting of directories.
 - Automatic thumbnail creation and caching.
 - Thumbnail is refreshed if the orginal image is changed.
 - Transparency in PNG and GIF images is preserved in the thumbnail.
 - Valid XHTML 1.0 Strict output.
 - Easy to integrate into any website or CMS.
 - Easy to style and extend with CSS and Javascript.
 - Ability to configure time display, timezone and DST.
 - Represent a directory with a (random) thumbnail.
 - Sorting of images can be configured.
 - Div (<div>) based layout for the gallery.
 - Images (and the cache) can be stored on different locations/(sub)domains on the
   server as long it's reachable by the browser.
 - Support for gif, jpg, jpeg, jpe, jif, jfif, jfi and png images.
 - Page navigation and breadcrumbs.

# Get it running

 - Drop the files from this package into a web accessible directory.
 - Make two directories named "images" and "cache" in the ImgBrowz0r directory.
 - Make "cache" writable (linux command: chmod -R 0777 cache).
 - Drop some images and directories in "images".

That's a really basic setup. It's recommended to play with the condiguration
and try various things (url rewriting, CMS integration, etc.).

# Get help/info

The project page:
The forum:
The demo:

# Development

You can take a look at the development progress here:

And bugs can be reported here:

# Extra information

Information about certain things.

  ## Character blacklist

  Certain characters are not allowed in directory names.

  < > " ' & ;

  ## read_thumb_limit

  When the "random thumbnail" function is enabled it reads the cache of the current
  category/directory to choose a random thumbnail. If there are a lot thumbnails in
  the cache it will take more time to read all the files in the cache.

  You can set this to 10 to speedup the process, but it will only choose a random
  thumbnail of out 10.

  ## Description for directories

  With imgbrowz0r::description() you can search for a description in the currently
  viewed directory. The function return the content of the description file when it
  found it and "null" is returned when nothing is found.

  You can add a description to a directory by adding a .desc file in the directory
  and put your description in that file.

  Html tags are stripped from the description except the following tags:
  <p>, <strong>, <em>, <a>, <br />, <h1>, <h2> and <h3>

   - Use valid HTML in your description to avoid unexpected behaviour.
   - Look for more info at:
  • imgbrowz0r_img_small.jpg
  • imgbrowz0r_cats_small.png
  Files folder image Files  
File Role Description
Plain text file COPYING Lic. License
Accessible without login Plain text file imgbrowz0r.php Class ImgBrowz0r class
Plain text file README Doc. Readme/manual
Plain text file index.php Example Usage example

 Version Control Unique User Downloads Download Rankings  
This week:0
All time:4,599
This week:697Up