BizDesign ImageFolio
Home | User's Home | Report A Bug | List Your Site | Download Area | Documentation | Message Board
ImageFolio Lightbox Mod User's Guide

VERSION: 1.0 build 500
LAST MODIFIED: 09/06/2001

What You Will Need

  • The same requirements as the ImageFolio requirements
  • A working ImageFolio 2.2 "lightbox ready" version.
  • A mail program installed on your server (like sendmail for UNIX) to use the "send lightbox feature". To find out if it is installed and in which path download and install Perl script.
  • Compress::Zlib and Archive::Zip modules need to be installed on your server in order to use the "zip" feature of the lightbox. To find out if they are installed download and install Perl script. If your webhost only has Compress::Zlib installed and does not want to install Archive::Zip, then read Appendix A on how to install Archive::Zip youself.
  • If those modules are correctly installed this Perl script should give you a file download screen.



Lightbox Installation
  1. Using a Zip decompression utility, extract the contents of Lightbox_mod.zip to a new directory on your personal computer.

    You should see the following top-level directories:

    cgi-bin - this contains all of your scripts

    lightbox - this contains the slideshow and JavaScript source files
  2. Using an FTP utility, login to your Web server. Your ISP should have provided you with a username, password, and details for transferring files to your server.

  3. Upload all of the files and all of the directories in the cgi-bin/if_lightbox directory to the directory where you installed ImageFolio. Make sure you transfer all files in ASCII text mode!

    Permissions settings for Unix/Linux users...
    • Set permissions on all *.cgi files to 755 (rwxr-xr-x).
    • Do not set permissions on any other files.

     

  4. Upload the lightbox directory and subdirectories to any Web accessible location on your server other than the cgi-bin. Transfer all files in ASCII text mode.

    Permissions settings for Unix/Linux users...
    • Set permissions on the lightbox directory to 777 (rwxrwxrwx).
    • Set permissions on the lightbox/emailed directory to 777 (rwxrwxrwx).
    • Set permissions on the lightbox/zipped directory to 777 (rwxrwxrwx).

     

  5. Using a text editor, open all *.cgi files (from cgi-bin/if_lightbox) and verify that the first line of each script points to the proper location of Perl on your server, unless yours is #!/usr/bin/perl.

    Note for Unix/Linux users...
    Most text editors are set up to save files with Windows line endings. If you experience server errors when executing a script, you may need to change/set the preferences in your text editor to save files with Unix line endings.
  6. Using a text editor, open lightbox_config.pl (from the cgi-bin/if_lightbox directory) and answer all of the questions. This is your Lightbox configuration file and all variables regarding your server will need to be defined within this file. If you have trouble determining server and mail paths, download and install Perl script.

  7. Using a text editor, open config.pl (from the cgi-bin directory) and set $display_lightbox from 0 to 1.

  8. Save any modified files, then, using an FTP utility, login to your server and upload the files you modified. Be sure to overwrite existing files to preserve any permissions settings.

  9. RUN lightbox_build.cgi !!!
    Open your Web browser and type in the URL to lightbox_build.cgi. Whenever you make a change to config.pl or lightbox_config.pl you need to run lightbox_build.cgi in your browser. This will create the file config.js in your lightbox directory. This is a JavaScript Source file with all the settings that the lightbox needs in order to function. Just remember: always run lightbox_build.cgi as the last step! ImageFolio 2.2 Pro owners can run lightbox_build.cgi from within the admin area (only after you set "$display_lightbox=1;" in your config.pl). If lightbox_build.cgi does not return a result page then check all your paths settings in lightbox_config.pl and all permissions on the lightbox directory.

Appendix A
(If your webhost does not want to install Archive::Zip)
  1. Create a directory inside if_lightbox called Archive

  2. Download the Archive::Zip modules and decompress it. Upload the file Zip.pm in ASCII text mode to your cgi-bin/if_lightbox/Archive directory.

  3. Done!




© Copyright 1999-2002 BizDesign, Inc. All rights reserved.
BizDesign® is a registered trademark of BizDesign, Inc.
Permission to distribute, in any form, whole or part, is forbidden.

Home | Report A Bug | List Your Site | Download Area | Documentation | Message Board
Powered by ImageFolio