Registered Members

- Events

- Admin Screens
- Visitor Created Test Events

Click here to test the admin screens and create test events.

-Feature List
-License Agreement

-Install Request Form
-Mailing List
-Contact Us

Free Version

Mailing List
-Click here
to stay updated. 

Rate this script at The CGI Resource Index:

Thank you for support and interest in our products!

Don't forget to take a look at our other scripts

-Smartlist Manager



Upgrading Instructions
Professional Version v3.4

These instructions are for the update files only.

  1. This upgrade will work for users of WWC Contests Pro and EventHandler Pro versions 2.7 and above. Users of versions prior to 2.7 should perform a new install since their data is not compatible with this version.
  2. The file '' will still exist but only for compatibility. It is nothing more than an exact copy of the '' file. This allows sites to maintain any links to the file '' without any interruption of operation. The '' file will be called initially, but it will eventually redirect over to the '' file. You do not have to change your links which are pointed to ''. We do recommend that you change them over time due to the fact that the file '' 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 ( is now called User Administration
  6. All contests, surveys, and polls are now referred to as events.
  7. When upgrading, you should never replace the file or the files in your 'data' (contests) directory.
  8., and are no needed.
  9. Some new files may have been added depending on the version you are upgrading from.
  10. The modules is required for a few of the new features such as uploading. If this module is not installed on your server, you will not be able to use these features. has been a standard part of the Perl 5 distribution since 5.004 release of Perl. You must be running Perl version 5.003, patchlevel 7 or higher in order to use
Notify Users

If you are using ID's, you should notify your users that you are going to upgrade.

By default, all events will disabled for all users.

The users will not even be able to login into the Event Admin screens until you have finished the upgrade and reset the main script variables.

After you have complete the steps below, your users will be able to login.  However their events will be disabled until they reset their user variables.

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).

    |----- readme.txt
    |----- data
    |----- translate
    |----- plugins

    |----- 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
    |           |----- quiz_tpl.htm
    |           |----- surv_tpl.htm
    |           |----- template.htm
    |----- users

For full details on each of the files and directories, you can click here.

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 file 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.

  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 file.  We don't include the to prevent this from happening.
  4. Upload all the following files.

    These files are replacements for the older files and  You can delete the and once you have uploaded these.
  5. Create the new plugins directory. It will exist at:
    Once this directory has been created, upload any files that belong in this directory.
  6. If you had a temp directory, it is no longer used. You can delete it.
  7. If you have it, the uploads directory is no longer used also.  If you do not have any uploaded files in this directory, you can delete it.  If files exist in this directory, do not delete it.  These files will be moved as the users login to their accounts.  You can periodically check this directory.  Once it is empty, you can delete it. 
  8. If you have an images directory located here, these files have been moved to a non-cgi 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. 
  9. Upload the newest version of the following files to the translate directory:

    When uploading the .pl files, be sure to use ASCII mode transfer.
  10. If you have the, or 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="" 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="" target="main">
    <BASE HREF="" 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

If upgrading from version 3.3, follow the next steps.
  1. Upload the new files for admin.htm, links.htm, and welcome.htm.
  2. Upload the new quiz_tpl.htm file to the noncgi templates directory.  Once done it will exist at:
  3. You won't need to make any changes to the images directory or the users directory. 

If upgrading from versions prior to 3.3, follow the next steps.

  1. Create a directory called EventHandler under the root directory (main directory for your website) for your website.

  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
    |----- - 755
    |----- - 755
    |----- - 755
    |----- - 666
    |----- - 755
    |----- - 755
    |----- readme.txt - 666
    |----- - 666
    |----- - 666
    |----- - 755
    |----- - 755
    |----- - 755
    |----- - 755
    |----- - 755
    |----- data - 777
    |----- translate- 777
                |----- - 666
                |----- - 666
    |----- plugins - 755
                |----- - 666

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

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 or the 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.


If you are translating into a language other than English, at this point you'll need to log into the Translator and translate any new lines as well as check all your existing translations. 

Notify users

You can now notify the users that the upgrade has been complete.

You should notify them where the new admin screen is located. This was the URL mentioned above:


Inform the users that all of their events have been disabled and that they need to login to the User Settings screen. Once they are in this screen, they will be presented with instructions on steps they should take. Inform them to pay close attention to the instruction so they don't run into any difficulties.

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.


Featured Site

Used By

and many more




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