'----------------------------------------------------------------------------------------
'- ASP Image Thumbs - Version 3.7 XHTML + JS - 14 December 2008
'- Copyright © 2005-2008 - Livio Siri (http://www.livio.net) - All Rights Reserved.
'----------------------------------------------------------------------------------------
This application let you show a nice thumbnail images presentation on your web pages.
In the presentation each thumbnail image is downsized according to a configurable value.
On mouse click over an image, it is opened in a new window with full image size.
Opened window is overwritten on each new image click. (no need to close it every time)
Just create as many subfolders as different image galleries you want to show
and fill them with your images, let the script do the rest.
Credits and thanks to Dynamic Drive for the nice Image Thumbnail Viewer.
Starting from version 3.1 Image Thumbs includes a free dll component to perform REAL thumbnail images autoresize.
This failrly reduces the time to send thumbnail images to the client browsers with slow connections.
Credits and thanks to Karl-Johan Sjögren of http://www.crazybeavers.se/)
This requires a Webhost with a cgi-bin folder with "Scripts and Executables" permissions.
More informations on Imager Resizer can be found here:
http://www.crazybeavers.se/imagerresizer/
Not having such webhost capability set the "bUseImager" to False in the configuration, the script performs
with thumbnail images scaling insthead of resizing, in this case it doesn't require the external dll component.
LICENSE:
'-------------------------------------------------------------------------------------------------
'- This script is free OpenSource; you can modify (at your own risk) any part of it
'- and use it both privately and commercially.
'-
'- This script is distributed in the hope that it will be useful,
'- but WITHOUT ANY WARRANTY; without even the implied warranty of
'- MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR ANY
'- OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED.
'-
'- You may use this script or parts of it in your own private work, but you may NOT
'- pass the whole or any part of it off as your own work. This program is freeware.
'- You may distribute it freely provided that all the copyright notices remain
'- untouched in the scripts and the outputted HTML. You are not allowed to:
'- republish the code without linking to its home page on Livio.net web site;
'- remove or alter the copyright information in the files;
'- providing this source in either text or project form to another site for their republishing;
'-
'- I have spent many unpaid hours in development and support this and other scripts
'- available for free from Livio.net. If you like using this script then please help support
'- the development and update of this and future scripts by a small donation. All scripts
'- published remain free and you may still use them as much as you like, the donation
'- is only a request to help me cover some of the costs involved.
'-
'- Should you make any improvements to this script, please be kind enough to let me
'- know so that i may improve mine for the rest of the people who use it. Thanks.
'-
'- You can read the complete License agreement here
'- You can ask for more info at: - http://www.livio.net/
'---------------------------------------------------------------------------------------
SUPPORT:
INSTALLATION:
-- Extract and save in the root of your site with full path info.
-- Ensure that the "cgi-bin" dir (or whathever named) containing the file Imager.dll have
"Scripts and Executables" permissions. (If bUseImager is set to false this is not required).
-- Run "imgthumbstest.asp" to see the application in action with images already included.
-- In the GALLERY folder (or whathever named) create as many subfolders as different image galleries you want to show.
(Note: each subfolder name will be fetched as its corresponding image gallery name)
(If only one subfolder is created then it is shown directly without any selection of galleries)
-- In each new subfolder, created under the GALLERY folder, upload your images, may be divided by theme.
-- Copy the line <!-- #include virtual="/imgthumbs/_imgthumbs.asp" -->
into the ASP page where you want to show the image gallery.
(called yourincludefile.asp in the example below)
CONFIGURATION:
-- Open the file "_imgthumbs.asp" and edit the following configuration lines according to your preferences:
imgBoxSize = 150
'--- max horizontal or vertical size in pixel of thumbnails images
imgBoxColumns = 3
'--- number of Thumbnail image columns
imgBoxPageLines = 3
'--- thumbnails lines shown in each page
bHideSelectBox = False
'--- If False the "Select Image Gallery" box is always shown on top
bUseImager = True
'--- If True the external component to resize thumbnails images is enabled
tShowPageNav = "both"
'--- Show page navigation (quadristate, "top", "bottom", "both", "none")
sGalleryFolder = "/gallery/"
'--- Path name containing the galleries subfolders
sGalleryAdmin = "/imgthumbs/" '--- Path name containing Image Thumbs files
sImagerFolder = "/cgi-bin/"
'--- Path containing "imager.dll" file (must have "script and executable" permissions)
(leave the leading and trailing "/")
bShowEmptyFolders = False
'--- Display empty folders? (node folders are always shown)
aImageExtensions = ".jpg,.gif,.png" '--- the system would consider files with that extension as images
aHideFoldersPattern = "_vti_cnf,manager" '--- these directories are not shown (separated by comma)
strDefaultSort = "DateLastModified" '--- Default image files sort type
either by "name", "size", "type", "DateCreated", "DateLastModified"
strDefaultDirection = "ascending" '--- Default sort direction, either "ascending" or "descending"
bShowSortBar = True '--- Show the sort control bar
Paths configuration Example
sGalleryFolder = "/gallery/"
sGalleryAdmin = "/imgthumbs/"
sImagerFolder = "/cgi-bin/"
the paths tree is as follow:
Root
|_____ yourincludefile.asp
|_or__ /yoursitefilesdir/yourincludefile.asp
|_____/gallery/__name of gallery 1/ (your gallery #1 image files)
|
| |__name of subgallery 1-1/ (your subgallery #1-1 image files)
|
|__name of gallery 2/ (your gallery #2 image files)
|
| |__name of subgallery 2-1/ (your subgallery #2-1 image files)
|
| |__name of subgallery 2-2/ (your subgallery #2-2 image files)
|
|__name of gallery n/ (your gallery #n image files)
|_____/imgthumbs/ (imgthumbs application files)
|_____/cgi-bin/ (imager.dll file, must have "script and executable" permissions)
TO DO:
-- SUGGESTIONS AND DONATIONS ARE WELCOME !!!
-- Script rating on Aspin, Hotscripts and Planet-Source-Code are welcome !!!
REVISION HISTORY:
'---------------------------------------------------------------------------------------
V 3.7:
-- modified the image viewer with a cross-browser DHTML version
-- updated Imager.dll to version 2.4
'---------------------------------------------------------------------------------------
V 3.6:
-- modified code for XHTML and CSS W3C compliance
'---------------------------------------------------------------------------------------
V 3.5:
-- added selectable image folder sort type and direction
'---------------------------------------------------------------------------------------
V 3.4:
-- added tree view selection for subfolders in the main gallery folder
-- added pop-up window scroll for large images
'---------------------------------------------------------------------------------------
V 3.3:
-- fixed bug, when only one image per page is shown then the navigation between images fails
-- beautified navigation bar background with image
-- updated Imager.dll to version 2.3
(Thanks to Karl-Johan Sjögren of http://www.crazybeavers.se/)
'---------------------------------------------------------------------------------------
V 3.2:
-- fixed bug on image presentation with uneven image number
-- updated Imager.dll to version 2.2 to fix a huge memory leak
-- changed closing method in the pop-up window
-- added the capability to hide upper or lower page navigation
-- improved image presentation layout
'---------------------------------------------------------------------------------------
V 3.1:
-- added thumbnail images pixel resizing with external component
(Thanks to Karl-Johan Sjögren of http://www.crazybeavers.se/)
-- added the capability to enable or disable the external component usage
-- small image presentation layout changes
'---------------------------------------------------------------------------------------
V 3.0: (thanks to users suggestions)
-- added dropdown gallery selection
-- added navigation through pages for each image gallery
-- added the capability to configure how many thumbnail lines per page are shown
-- added the capability to hide the "Select Image Gallery Box" from top of page
-- excluded view of the "_vti_cnf" folder added by FrontPage
-- improved readme installation and configuration help details
-- folders configuration changed for better script control on galleries path
'---------------------------------------------------------------------------------------
V 2.5: First release
That's it! Easy, enjoy!
|
|
|
|