Pricing/Ordering

EventHandler

Registered Members

Demos
- Events

- Admin Screens
- Visitor Created Test Events

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

Documentation
-Index
-
Install
-Feature List
-Requirements
-License Agreement

Support/Info/Help
-Forums
-Install Request Form
-Mailing List
-Contact Us

Download
-
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

-RatingsHandler
-AccountHandler
-Announcer
-Smartlist Manager
-Downloader


 

 

First Time Installation

Professional Version v3.5

Special Notes:
  1. You can print this out an 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).

CGI
    |----- admin-event.pl
    |----- admin-member.pl
    |----- admin-script.pl
    |----- date.pl
    |----- diagnose.pl
    |----- EventHandler.pl
    |----- readme.txt
    |----- setup.pl
    |----- SSI.pl
    |----- subs1.pl
    |----- subs2.pl
    |----- subs3.pl
    |----- subs4.pl
    |----- translator.pl
    |----- data
    |----- translate
                |----- English.pl
                |----- master.pl
    |----- plugins
                |----- UBB.member.pl

NONCGI
    |----- 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:

#!/usr/local/bin/perl

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:

admin-event.pl
admin-member.pl
admin-script.pl
diagnose.pl
EventHandler.pl
SSI.pl
subs2.pl
subs3.pl
subs4.pl
translator.pl

The line will look like this:

#!/usr/local/bin/perl

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.

Example:

admin-event.cgi
date.cgi
admin-script.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:

admin-event.cgi
admin-member.cgi
admin-script.cgi
diagnose.cgi
EventHandler.cgi
SSI.cgi
subs2.cgi
subs3.cgi
subs4.cgi
translator.cgi

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.

    Example: http://www.domain.com/cgi-bin/EventHandler
      
  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:

    data
    translate
    plugins


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

    http://www.domain.com/cgi-bin/EventHandler/data
    http://www.domain.com/cgi-bin/EventHandler/translate
    http://www.domain.com/cgi-bin/EventHandler/plugins
     
  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 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 in which you uploaded the cgi files in the previous section.

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

    Examples:

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

    Example: http://www.domain.com/EventHandler
     
  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.

    images
    templates
    users

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

    http://www.domain.com/EventHandler/images
    http://www.domain.com/EventHandler/templates
    http://www.domain.com/EventHandler/users
     
  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:

http://www.domain.com/cgi-bin/EventHandler/
http://www.domain.com/EventHandler/

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-event.pl - 755
    |----- admin-member.pl - 755
    |----- admin-script.pl - 755
    |----- date.pl - 666
    |----- diagnose.pl - 755
    |----- EventHandler.pl - 755
    |----- readme.txt - 666
    |----- setup.pl - 666
    |----- SSI.pl - 755
    |----- subs1.pl - 666
    |----- subs2.pl - 755
    |----- subs3.pl - 755
    |----- subs4.pl - 755
    |----- translator.pl - 755
    |----- data - 777
    |----- translate- 777
                |----- English.pl - 666
                |----- master.pl - 666
    |----- plugins - 755
                |----- UBB.member.pl - 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.

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.

 

 
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 admin.htm file which you uploaded. Most likely this is:

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

where domain is your domain.

Set The Main Script Variables

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

For the first time login, you will leave the  login username and password blank.

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

We suggest you check the option labeled Use Multiple Users (ID's). This allows multiple users right off.  If you do not use this option and you change it in the future, you will have to manually move event files that you already have. This can be a hassle. It's easier to start with the option of using ID's.

Make sure you set a new username and password.

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

Translate

If you are translating into a language other than English, you'll need to translate the lines at this point. To do that, log into the Translator and follow the instructions.  The translator uses the same username and password as the other script admin features.

Creating a user ID

If you decide to use ID's, you will need to create at least one ID to get started. This can be using the admin link labeled User Tasks.

Begin Creating Events

At this point you are ready to start creating and administering your events.

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