|
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
- 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
- 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.
- 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.
- 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).
- 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.
- 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.
- Using a text
editor, open
config.pl (from the cgi-bin directory)
and set $display_lightbox from 0 to 1.
- 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.
- 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)
- Create a directory
inside
if_lightbox called Archive
- 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.
- 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.
|