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

Notes

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.

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.

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.

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.

The Contest Administration (admin.pl)
is now called User/Event Admin.

All contests, surveys, and polls are now
referred to as events.

When upgrading, you should never replace
the setup.pl file or the files in your 'data' (contests) directory.

cookie-lib.pl, cgi-lib.pl and
version.pl are no needed.

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

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.

Example:

admin.cgi
date.cgi
admin-main.cgi
EventHandler.cgi

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:

Never overwrite the setup.pl file. We don't include the setup.pl
to prevent this from happening.

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.

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

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.

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:

Do not overwrite any of your existing
templates files with the ones in the zip file.

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.

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:

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

Note

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:

http://www.domain.com/EventHandler/admin.htm

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.