Professional Version v3.7
- This upgrade is designed for users of version
3.4 and above. This is due to the fact that many significant changes have been
made in versions 3.4-3.6.
- If you are using v3.3 and below, you can
perform this upgrade. However you want to make sure that you check all of your
Script Settings, your User Settings for all user (if using users), as well as
your Event Settings for all events.
Many settings have been added that you will need to define as we as many
settings have changed that will require you to re-set them.
- We always recommend you backup your current
- The file WWCcontests.pl no longer
exists. If you are still using links that point to WWCcontests.pl,
you need to change them to the new EventHandler.pl file.
- When upgrading, you should never replace
the setup.pl file or the files in your 'data' directory.
- When upgrading, you should never replace
any of your existing template files. Only upload new template files
if you do not already have them. If you replace any of your modified
template files, you will have to modify them again.
Unzip the files to a location of your
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).
For full details on each of the files and
directories, you can
|Set Perl Location in PL Files
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
If your server only allows CGI extensions
to be ran, at this point you must rename all the pl files to 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
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.
Login to your ftp server.
This can be done using any FTP client such as CuteFTP.
Change to the directory where your cgi scripts are installed.
Upload all the newest versions of the files. You will want to
overwrite the following old files with the new ones.:
Upload the newest version of the following file to the plugins directory:
Upload the newest version of the following files to the translate
When uploading the .pl files, be sure to use ASCII mode transfer.
Open the file index.htm in an editor of your choice. This
is located in the NONCGI directory that was created when you
unzipped the files.
In this file you will find a line that looks like the following:
here to login</a>
Edit this link so that it points the admin-event.pl
You will see help inside of the file to aid you in editing this file.
Upload the files index.htm
Note: The links.htm
and the welcome.htm files are no longer needed and can be
We have included the images
directory with the update since some images have changed and
some of the older images are no longer needed.
You can delete all of the images
you have from older versions and upload the new images.
All you will need in the images directory are the image files
included in this update.
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
When setting change permissions, you will want
have NT propagate (apply) those permission to all subdirectories and files under
each directory also.
You may need to ask your system administrator
to set the permissions for you.
for UNIX servers
For unix servers, follow the steps below
to set permissions.
1. Set CHMOD 755 on ALL .pl
files (.cgi if you changed them)
2. Set permission on files below as
directed (directories in bold):
- 777 (see special note below)
|-- setup.pl - 666
|----- translate- 777
|-- English.pl - 666
|----- templates - 777
|-- cont_tpl.htm - 666
|-- poll_tpl.htm - 666
|-- quiz_tpl.htm - 666
|-- surv_tpl.htm - 666
|-- template.htm - 666
|----- users- 777
3. All files not mentioned above need no special permissions. Default
permissions are fine.
the Script Settings
Point your browser to the NONCGI directory such
This should call the new index.htm file.
At this point use the link 'click here to
login' to get to the login screen.
By default now, you are taken to the User Login.
You will want to use the 'Script Admin Login'
link towards the bottom to get into the Script Administration now and in the
Once logged in to the Script Administration, you
will need to check all of your Script Settings.
By default all events will be disabled. You will
need to enable them again once you re-set all of your Script Settings.
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.
and Setup New User
If you are upgrading from a
previous version in which you were already using user ID's, skip this step.
If you are upgrading from a previous version
where you were not using ID's, you must create a new ID at this point.
Version 3.6 and all versions following will require the use of ID's.
To do this, while logged into the Script
Administration Section, go to User Tasks under the Script
Administration navigation menu and follow the steps to create a new
If you had existing events, you can now
import the events into the data directory for the new user. To do
this, go to Import Events under the Script Administration
navigation and follow the instructions for importing the events.
The Import Events option will only exist in the navigation menu
if there are events to import. If the application cannot find any
existing events to import, the Import Events option will
Once you have created the new user, you are ready to
setup the User Settings.
To do this, you need to click on the link provided
at the top where it says:
Click here to return to the
This will return you to the User Login
screen. Login using the new user you just created.
Once logged in, you will be at the User
Settings Screen. Read all the options and set them as you need them.
These are your default settings for this user.
At this point, you will need to re-set the
Event Settings for all of your Events. Once this is done, you are ready to go.
Note: Now that you are using users, the URL
to call specific events will change. You must now add &id=xxx (where xxx
is the user id) to the URL.
If your old link was something like:
it must now be changed to:
The &id=xxx tells EventHandler that
you are now calling that event under the user xxx.
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