Announcer

Installation v1.2 and below

Upgrading from v1.0? Click here.

1. You can print this out an refer to it as needed.

Unzip the files to a location of your choice. 

After unzipping you should have the following to files.

announcer.pl
setup.pl
template.htm

For UNIX servers. You may need to change the location of your Perl in the announcer.pl file.

By default, the location is set to:

#!/usr/local/bin/perl

This Perl location is the first line of the file.

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:

announcer.cgi
setup.cgi

Once you have renamed each of these files, you must edit the announcer.cgi file such that it refers to the use of the 'cgi' extensions.

To edit the file, open the file in a text editor. Find the line towards the tp that says:

$cgiext = 'pl';

This line must be changed so that it reads:

$cgiext = 'cgi';

1. Login to your ftp server. This can be done using any FTP client such as CuteFTP.
     
2. Create a directory such as announcer 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/announcer
     
3. Using your ftp client, change to the directory which you created in step 2 above.
     
4. Upload all files to the new directory.
    
   When uploading the files, you should be sure to use ASCII mode transfer.

If NT server, you will want to give the IUSR_XXX (Internet Guest Account) account CHANGE (RWXD) (RWXD) permissions to the new directory you created as well as all files.

Note: You may need to ask your system administrator to set the permissions for you.

For Unix servers, please refer to the chart below for the permissions on the files.

cgi-bin/announcer - 777
    |----- announcer.pl - 755
    |----- setup.pl - 666
    |----- template.htm - 666

Note: Some servers may require 755 permissions on the announcer directory.  If you receive an error when you attempt to run the announcer.pl file, try using 755 permissions.

Edit your template file (template.htm)

This step is not a must at this moment. It can be done at any point down the line.

The template file is to make your script look as though it is part of your site.

For details on the use of 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.

1. Open the announcer.pl in a browser of your choice.
2. Upon first run, the admin screen will appear.
3. Choose the option to 'Edit Script Settings'. Leave the password blank and click the submit button.
4. Complete the script settings as they fit your needs and submit them.
5. Your script is now setup.

Start Using Announcer

1. At this point you can start using Announcer.
2. We recommend you create a test list and test the script to ensure everything is setup and working properly.
3. For info on executing and calling the script, click here.