Ron Savage > CGI-Echo-1.08 > CGI::Echo

Download:
CGI-Echo-1.08.tgz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 1.08   Source  

NAME ^

CGI::Echo - Echo form data to test form design.

Synopsis ^

This is complete, tested program:

        #!/usr/bin/perl -wT

        use lib '.';
        use strict;

        use CGI;
        use CGI::Echo;

        # -----------------------------------------------

        my($q) = CGI -> new();

        CGI::Echo -> new(q => $q) -> print();

Description ^

This module accepts form data, cleans it, and echos it.

It is designed for a HTML/CGI student enviroment. It lets, indeed encourages, students to design forms and gives their long-suffering instructors a simple way to provide a CGI script which accepts the form data, and just echos it.

Distributions ^

This module is available both as a Unix-style distro (*.tgz) and an ActiveState-style distro (*.ppd). The latter is shipped in a *.zip file.

See http://savage.net.au/Perl-modules/html/installing-a-module.html for help on unpacking and installing each type of distro.

Usage ^

See the synopsis.

Options ^

Here, in alphabetical order, are the options accepted by the constructor, together with their default values.

css => ''

This is the name of a CSS file which makes the sample form and the echoed data look pretty.

See examples/default.css for a sample CSS file.

q => ''

This is the CGI object used by CGI::Echo to do the work.

title => 'Echo Test'

This is the text used in the page title and as a heading when the form data is echoed.

Methods ^

new(%arg): The constructor

See the previous section for details.

print(%arg): Display the form data

Call this to output a table containing the form data.

print(%arg) takes the same parameters as new().

set(%arg): Set class member options

Call this to set options after calling new().

set(%arg) takes the same parameters as new().

A Sample Form ^

The synopsis in Echo.pm contains the only script you'll need. You'll find the code in examples/echo.cgi.

A sample form, examples/test-echo.html, is shipped to bootstrap the design process.

Author ^

CGI::Echo was written by Ron Savage <ron@savage.net.au> in 2002.

Home page: http://savage.net.au/index.html

Copyright ^

Australian copyright (c) 2002, Ron Savage. All Programs of mine are 'OSI Certified Open Source Software'; you can redistribute them and/or modify them under the terms of The Artistic License, a copy of which is available at: http://www.opensource.org/licenses/index.html

syntax highlighting: