Perl: Coding Domain Modules

Downloads Perl Modules

Description

Coding Domain Perl Modules Version: Author: Diederik van der Boor Date: Requirements: o For CGI Scripts: A webserver (personal or remotely hosted) o For CGI Scripts: CGI support; Server has to allow/be able to run *personal* CGI programs. o Perl 5.005 installed for processing scripts. o Perl modules: Fcntl. o Optional E-mail functionality: sendmail (UNIX mostly) or the Net::SMTP module (Win32 mostly). o Some brains ;-)

Features:

• Detection of script's location at the webserver
• Better error messages, posibility to show a personal message (callbacks)
• Template file parsing for better integration in your website
• Converting high ASCII's to HTML escape codes and back
• Simple routines for using flat text databases
• Input validation
• Mail sender module
• Changing the epoch time in written time string, using language packs.
• Timezone convertor.
• Location script fixes some bugs caused by Microsoft ® Internet Information Server ® Software
• Hiding of server absolute paths in the error message
• Testing IP addresses and blocks

Module Documentation

CGI::ErrorTrap	Display advanced error messages
CGI::Location	CGI Location Detection
CGI::Template	Easy to use template parser
File::PlainIO	Simple object interface for file input and output
HTML::EscapeASCII	Converts special ASCII characters to HTML escape codes
INet::Mailer	E-mails a message via SMTP
Test::Input	Tests for input validation
Test::IPAddress	Tests for IP addresses and blocks
Time::Text	Converting epoch time into a normal format
Time::Zones	Converting GMT to different timezones

How to install

• If you have root access to your machine/webserver, copy file directoy structure to the perl/lib folder.
• Alternatively, copy the files into the 'current directory' of the (CGI) script (usually cgi-bin for CGI scripts).
• For CGI scripts running under the Microsoft ® Internet Information Server ® (version 5.0 and lower),
  copy the directoy structure to the WWW-root folder.

How to use the modules for your scripts

Please don't change the names for the modules. You're allowed to use them, not abuse them. If any bugs show up, let me know. Don't re-distrubute new versions of the modules yourself.

Here is a sort sample in Perl:

#!/usr/bin/perl -w

use strict;
use CGI qw(:cgi);

use CGI::Location;
use CGI::ErrorTrap;
use CGI::Template;
use HTML::EscapeASCII;

my $Copyright = "Copyright © 2001 Diederik van der Boor";
FormatFieldHTML( $Copyright ); # Converts © to © pretty useless here

TemplateLoad('template.html') or die "Can't load template: $!";
TemplateSetReplace('COPYRIGHT' => $Copyright);


print header('text/html');
print_TemplateUntil('TITLE' => 'Using the Coding Domain Perl Modules');
print_TemplateUntilLabel('BODY');


# The variables used here are added by the Location module
print "Current URL is: $THIS_URL";
print "Website home page is: $THIS_SITE/index.html";


print_TemplateUntilEOF();
exit;