Installation - Free Version 3.1

1) Unzip the files using any zip program such as Winzip. Once unzipped you should have the following files and directories.

• admin.pl
• admin-main.pl
• cgi-lib.pl
• date.pl
• setup.pl
• subs1.pl
• subs2.pl
• subs3.pl
• template.htm
• contest_tpl.htm
• survey_tpl.htm
• poll_tpl.htm
• WWCcontests.pl
• Readme.txt
   
• images (directory)
    Blackdot.gif
    Bluedot.gif
    Browndot.gif
    Greendot.gif
    hint.gif
    link.gif
    Orangedot.gif
    Purpledot.gif
    Reddot.gif
    reset.gif
    submit.gif
    Whitedot.gif
    WWCctitle.gif
    

1) Create a directory such as WWCcontests on your server in which the script will run.  This most likely will be located in the cgi-bin directory.
Example: http://www.domain.com/cgi-bin/WWCcontests

2) Upload all of the files to the directory which was created in step 1 above. With exception of the files in the image directory.
This can be done using any FTP client such as CuteFTP.
When uploading the "pl" files, you should be sure to use ASCII mode transfer.
If you are importing the files on an NT server using FrontPage, you more than likely don't have to worry about the ASCII transfer mode. However if you do encounter problems running the scripts, you should try uploading the files in ASCII mode with an FTP program.

3) Create a subdirectory such as contests under the directory which you created in step 1.
Example: http://www.domain.com/cgi-bin/WWCcontests/contests/

4) Create a subdirectory called images in an area where image files can be read. Some servers cannot read image files from within the cgi-bin directory. If you place this directory under the cgi-bin directory, and the images don't show up, try moving it to a location outside of the cgi-bin directory.
Example: http://www.domain.com/contests/images/

5) Upload all the files from image directory in the zip file to the new image directory which you created in step 6.

1) If using NT, you can ignore this step.  If PERL is setup properly on your server, the .pl files should already be associated with the PERL installed on the server.

2) For UNIX servers. The perl location is the first line of the following files:

• admin.pl - Admin script for setting up contest.
• admin-main.pl - Admin script for setting main script variables and adding new ID's as well as adding contests.
• subs2.pl - Library of subroutines.
• subs3.pl - Library of subroutines.
• WWCcontests.pl - The main contest script.

The line will look like this:

#!/usr/local/bin/perl

This is the absolute path to PERL on your server.  If you do not know what this is, contact your server administrator to find out.

Perl 5 is required for this script to run.

1). Windows NT
You will need the following permissions set for the directory in which you put the script files.

IUSR_XXX (RWXD)  (RWXD)

Your server administrator should be able to do this for you.

Note: This is the directory which you created in step1 of the section above titled "Create Directories and Upload Files".

2.) UNIX (CHMOD settings)

CHMOD 777

1. WWCcontests directory (main directory where all your files are located)
2. contests directory

CHMOD 666

1. setup.pl
2. cgi-lib.pl
3. date.pl
4. subs1.pl
5. template.htm
6. contest_tpl.htm
7. poll_tpl.htm
8. survey_tpl.htm

CHMOD 755

1. admin.pl
2. admin-main.pl
3. subs2.pl
4. subs3.pl
5. WWCcontests.pl

1) UNIX installs can ignore this step.

2) For NT Servers

At the top of each .pl file you will see require statements that look like:

require "setup.pl";
require "subs1.pl";
require "cgi-lib.pl";
require "date.pl";

Some NT servers will require that you put the full absolute (real)   path to these files.

If you are unsure whether your server requires the full path, you can do one of two things:

1. Contact your server administrator and they should be able to tell you. (preferred method)
   OR
2. Test the script once you are done with all the other install steps.   If you get blank screens or a message that states "Documents contains no data", you should then try the full path on the require statements.

If your server requires the full path, you should change each of these to look something like:

require "d:/www/www.domain.com/cgi-bin/WWCcontests/setup.pl";
require "d:/www/www.domain.com/cgi-bin/WWCcontests/subs1.pl";
require "d:/www/www.domain.com/cgi-bin/WWCcontests/cgi-lib.pl";

The path you would use would be dependent on where you put the contest files.

1) Editing the setup.pl file. Instructions on what to do are located within this file.

1) Run the Script Administration (admin-main.pl) to set all of your main script variables.  When running this for the first time, you don't need a username or password.

1) This step is not a must at this moment. It can be done at any point down the line.

The template files are used to make your script look as though it is part of your site.

Note: When editing A template file, you must always include the $REPLACE variable.  This is to indicate where the script should insert the HTML which is generates.

From this point you are ready to start creating your contests using the Contest Administration (admin.pl).