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



First Time Installation

Professional Version v3.6

Special Notes:
  1. You can print this out and refer to it as needed.
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
    |----- index.htm
    |----- images
    |           |----- Blackdot.gif
    |           |----- Bluedot.gif
    |           |----- Browndot.gif
    |           |----- EventHandler.gif
    |           |----- Greendot.gif
    |           |----- hint.gif
    |           |----- Orangedot.gif
    |           |----- Purpledot.gif
    |           |----- Reddot.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 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.

Create cgi-bin Directories and Upload CGI Files
  1. Login to your ftp server. This can be done using any FTP client such as CuteFTP.
  2. Create a directory called EventHandler on your server in which the script will run.  This most likely will be located as a subdirectory of your  cgi-bin directory.

  3. Using your ftp client, change to the directory which you created in step 2 above.
  4. On your server, created a directory structure that mimics the structure of the CGI directory which you unzipped.  This means you will create the following subdirectories:


    These directories will be subdirectories under the directory that you created in step two. Examples:
  5. Upload all files from the CGI directory to their respective directories on your server. Ignore the files under the NONCGI directory for now.

    When uploading the .pl files, you should be sure to use ASCII mode transfer.
Edit your index.htm file
  1. 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.
  2. In this file you will find a line that looks like the following:

    <a href="../cgi-bin/EventHandler/">Click here to login</a>
    Edit this link so that it points the file.

    You will see help inside of the file to aid you in editing this file.
Create non cgi-bin Directories and Upload NONCGI Files
  1. Login to your ftp server once again.  You may still be logged in from before.
  2. Create a directory called EventHandler under the root directory (main directory for your website) for your website.

  3. Using your ftp client, change to the directory that you created above in step 2.
  4. 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:
  5. Upload all files from the NONCGI directory to their respective directories on your server.
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, 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):

cgi-bin/EventHandler - 777 (see special note below)
    |-- - 666
    |----- data - 777
    |----- translate- 777
    |            |-- - 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.


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.


Edit your template files
  1. This step is not a must at this moment. It can be done at any point down the line.
    The templates files are used to make your script look as though it is part of your site.

    For details on template files, click here.
    Note: When editing the template file, you must always include the $REPLACE variable.  This is to indicate where the script should insert the HTML which is generates.
Open your administration page in your browser

Point your browser to the NONCGI directory that you created. Most likely this is:

where domain is your domain.

This should call the index.htm file as present a welcome screen with a login link..

Define the Script Settings

Click on the link 'click here to login'.

Follow the instructions provided to login to the Script Administration Area..

Once logged in, you will be at the Script Settings section.

Follow all the instructions and set your Script Settings as you need them.

It is important that you read through all the settings and set them accordingly since these are the settings that make your install of EventHandler run properly.


If you are translating into a language other than English, you'll need to translate the lines at this point.

To do that, got to Translator  under the Script Administration navigation menu. Follow the instructions to create a translation.

Creating a user ID

Next step is to create a user ID.

To do this, while logged into the Script Administration Section, go to User Tasks under the Script Administration navigation menu.

You will now be able to create a new user.

Setup the New User

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 login screen

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.

Create and Administer Events

At this point you are ready to begin creating events and administering them.

To create am event, go to Create/Delete Event under the Event Administration navigation.

In this section you can create an event.  Just follow all the instructions to create an event.

Look Around

Now, take some time to look around the admin screens. You will want to get familiar with them.

The admin screens have online help and docs to help you get around.

Make sure you read all instructions carefully.

That's All

At this point you are ready to begin using your EventHandler.

To call a list of your users, you will call EventHandler such as:

If you want to call the events for a specific user, you will call EventHandler such as:

where xxx is the user ID  for the user.


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