Upgrading Instructions
Free Edition v3.3
For users of version 2.9 and above only.

These instructions are for the update files only.
For instructions on installing the full version, click here.

  1. If you are using a version prior to 2.9, you cannot upgrade.  You must perform a new full install since the data format is not the same.
  2. The file 'WWCcontest.pl' will still exist but only for compatibility. It is nothing more than an exact copy of the 'EventHandler.pl' file. This allows sites to maintain any links to the file 'WWCcontests.pl' without any interruption of operation. The 'WWCcontests.pl' file will be called initially, but it will eventually redirect over to the 'EventHandler.pl' file. You do not have to change your links which are pointed to 'WWCcontests.pl'. We do recommend that you change them over time due to the fact that the file 'WWCcontests.pl' will eventually be removed from the distribution  in future versions.
  3. The 'WWCcontests' directory is now referred to as the 'EventHandler' directory. You do not have to rename the directory but we recommend that you do rename it some time in the future.
  4. The directory 'contests' has been changed to 'data'. The upgrade will not automatically change this for you. You must rename it yourself. You can continue to use the directory 'contests' but we recommend renaming it to 'data' since we will refer to the data directory in the documentation. If you rename it, don't forget to make sure you change the path for the 'data' directory in the Script Variables .  The upgrade has been designed to recognize the directory change and should automatically correct any template paths that are pointed to use the 'contests' directory. However, after the upgrade, it is recommend that you check all your paths.
  5. The Contest Administration (admin.pl) is now called User/Event Admin
  6. All contests, surveys, and polls are now referred to as events.
  7. When upgrading, you should never replace the setup.pl file or the files in your 'data' (contests) directory.
  8. cookie-lib.pl, cgi-lib.pl and version.pl are no needed.
  9. Some new files may have been added depending on the version you are upgrading from.
Unzip Files

Unzip the files to a location of your choice. 

After unzipping you should have two main folders called CGI and NONCGI

The directory and file structure for these should look like the charts:
(directories are in bold).

    |----- admin-main.pl
    |----- admin.pl
    |----- diagnose.pl
    |----- EventHandler.pl
    |----- readme.txt
    |----- subs1.pl
    |----- subs2.pl
    |----- subs3.pl
    |----- WWCcontests.pl
    |----- data

    |----- admin.htm
    |----- links.htm
    |----- welcome.htm
    |----- images
    |           |----- bg.gif
    |           |----- bg2.gif
    |           |----- Blackdot.gif
    |           |----- Bluedot.gif
    |           |----- Browndot.gif
    |           |----- EventHandler.gif
    |           |----- Greendot.gif
    |           |----- hint.gif
    |           |----- link.gif
    |           |----- Orangedot.gif
    |           |----- Purpledot.gif
    |           |----- Reddot.gif
    |           |----- reset.gif
    |           |----- submit.gif
    |           |----- Whitedot.gif
    |           |----- Yellowdot.gif
    |----- templates
    |           |----- cont_tpl.htm
    |           |----- poll_tpl.htm
    |           |----- surv_tpl.htm
    |           |----- template.htm

Set Perl Location in PL Files (UNIX Only)

For UNIX servers. You may need to set the location of your Perl in the scripts. The default location set for Perl in the script is:


If this path is correct for your server, you can skip to the next section.

The Perl location is the first line of the following files:


The line will look like this:


If need to run CGI extensions

If your server allows you to run Perl scripts with the pl extension or you have other Perl scripts on your server that use the extension pl, you can skip this step. Most server will allow pl extensions. 

If your server only allows CGI extensions to be ran, at this point you must rename all the pl files to cgi files.



Once you have renamed each of these files, you must edit the following files and indicate in them that you are using the CGI extension:


To edit them, open each files in a text editor. Find the line that says:

$cgiext = 'pl';

This line must be changed so that it reads:

$cgiext = 'cgi';

Once you have edited each file and saved them, you are ready to go using the CGI extension.

Update cgi-bin files
  1. Login to your ftp server. This can be done using any FTP client such as CuteFTP.
  2. Change to the directory where your cgi scripts are installed.

    Example: http://www.domain.com/cgi-bin/EventHandler
  3. Upload all the newest version of the files.  You will want to overwrite the following old files with the new ones.:


    When uploading the .pl files, be sure to use ASCII mode transfer.

    Never overwrite the setup.pl file.  We don't include the setup.pl to prevent this from happening.
  4. If you have an images directory located here, these files have been moved to a NONCGI directory.  You can delete the images directory here and all image files. If you have any custom images located in this directory, you don't want to delete them. You will need to move them to the new images directory that you will be created in step below. 
  5. If you have the cookie-lib.pl, cgi-lib.pl or version.pl files, they are no needed. You can delete them.
Edit your links.htm file
  1. Open the file links.htm in an editor of your choice. This is located in the NONCGI directory that was created when you unzipped the files.
  2. In this file you will find a line that looks like the following:

    <BASE HREF="
    http://www.domain.com/cgi-bin/EventHandler/" target="main">

    Edit this line so that it points the location where your cgi script files exist.

    You will only edit the part that is in red above. Do not edit


    <BASE HREF="http://www.hotmail.com/cgi-bin/EventHandler/" target="main">
    <BASE HREF="http://www.microsoft.com/cgi-bin/EventHandler/" target="main">

Make sure you have the trailing / (slash) at the end.

The links.htm file has additional information in it for you to read.

Create non cgi-bin Directories and Upload NONCGI Files
  1. Create a directory called EventHandler under the root directory (main directory for your website) for your website.

    Example: http://www.domain.com/EventHandler
  2. Using your ftp client, change to the directory that you created above in step 2.
  3. Create a directory structure that mimics the structure of the NONCGI directory. This means you will create the following directories.


    These directories will be subdirectories under the directory that you created in step two. Examples:

  4. Upload all the image files to the images directory. 
  5. If you are using version 3.1 or above, you should move your master template files to the templates directory. These are the template files which normally existed under the main cgi-bin/EventHandler directory such as:


    Once moved, they will exist at:


    Do not overwrite any of your existing templates files with the ones in the zip file.
  6. If you are using version 3.0 or below, upload any new template files to your templates directory. If you have a master template file (template.htm) in the cgi-bin/EventHandler directory, you should move it into this directory. 


Set Permissions for NT servers

If NT server, you will want to give the IUSR_XXX (Internet Guest Account) account CHANGE (RWXD) (RWXD) permissions for both main EventHandler directories. These are the directories you created such as:


When setting change permissions, you will want have NT propagate (apply) those permission to all subdirectories and files under each directory also.

Note: You may need to ask your system administrator to set the permissions for you.

Set Permissions for UNIX servers

For unix servers, please refer to the chart below for the permissions on the files.

cgi-bin/EventHandler - 777
    |----- admin-main.pl - 755
    |----- admin.pl - 755
    |----- date.pl - 666
    |----- diagnose.pl - 755
    |----- EventHandler.pl - 755
    |----- readme.txt - 666
    |----- setup.pl - 666
    |----- subs1.pl - 666
    |----- subs2.pl - 755
    |----- subs3.pl - 755
    |----- WWCcontests.pl - 755
    |----- data - 777

EventHandler - 777
    |----- templates - 777
    |           |----- cont_tpl.htm - 666
    |           |----- poll_tpl.htm - 666
    |           |----- surv_tpl.htm - 666
    |           |----- template.htm - 666

Only the files listed above require special permissions. All other files can use the default permissions.


Some UNIX servers will not allow 777 permissions to be set on the cgi EventHandler directory. If you follow the instructions completely and you continue to get a server error while attempting to run the scripts, set the permissions to 755 or 775 on the '/cgi-bin/EventHandler' directory.


Open your NEW administration page in your browser

Point your browser to admin.htm file which you uploaded. Most likely this is:


where domain is your domain.

You will no longer call the admin-main.pl or the admin.pl files directly.
You can if you want but it is recommended that you use the new admin.htm file.

Set The Main Script Variables

Click on the left hand side link labeled Script Variables. This is under the Script Admin section.

Once you are in the Script Variables screen, you want to go through of the fields and set each and every variable.

Since you may have moved your image files along with your master template files, you need to change the paths to them accordingly. 

Once you have set all the fields properly, click on the button labeled Modify Main Variables.

That's all.

Your upgrade should be complete.

If you are having problems, please check out our support forums. The answer to your question may already be there. If not, just leave your question and we will answer it as soon as possible.


Copyright © 1994-2001 UbiDog Productions. All Rights Reserved.
Formerly known as Wolfcountry Web Creations