NAME

Liz::Banner - Simple banner sending module, allows sending of attachments


SYNOPSIS

 use Liz::Banner;

 $banner = new Liz::Banner;


EXAMPLES

 #!/usr/local/bin/perl

 use Liz::Banner;

 Liz::Banner::new(  );


DESCRIPTION

The Liz::Banner package allows an easy to use interface for sending ebanner, optionally including files that can be sent as MIME-attachments.


BASIC METHODS

The following methods are the basic methods of the Liz::Banner module.


new

Create a new Liz::Banner object. Intended to be called from another module.

Input Parameters

 1 account name to be used
   (default: lower case ref of object, e.g. HN.pm )
 2 server to be used
   (default: 'Banner.xxLINK.nl')
 3 name of variable to store HTML info of banner in
   (default: 'BANNER')
 4 target for clickthrough of banner
   (default: none)
Output Parameters

 1 instantiated object
Example

 $banner = new Liz::Banner( 'search','Banner.xxLINK.nl' );
 print $banner->Random;

 <PRINT "HN->Banner->Random">


CONTENT METHODS

The following methods allow changes to information that is associated with a banner.


Random

Method to generate global variable ``banner'' in the callers namespace. Also returns the banner information.

Input parameters

 1 query for which to find an appropriate banner
   (default: none)
 2 namespace of the variable in which to store HTML
   (default: caller's namespace)


RandomFromGroup

Method to generate global variable ``BANNER'' in the callers namespace randomly selected from a banner group. Also returns the banner HTML information and puts it in the HTML field of the object.

Input parameters

 1 banner group number to use for this banner
   (default: any banner group)
 2 query for which to find an appropriate banner
   (default: none)
 3 namespace in which to set variable
   (default: callers)


Specific

Method to generate global variable ``banner'' in the callers namespace with the HTML information of a specific banner. Also returns the banner HTML information and puts it in the HTML field of the object.

Input parameters

 1 banner number to obtain info of
 2 flag: whether or not to log the banner as displayed
   (default: 0 = log as displayed, 1 = do not log)
 3 namespace of the variable in which to store HTML
   (default: caller's namespace)


INTERNAL METHODS

The following methods are intended for internal use only, but can also be used by experienced developers directly.


GET

Get the contents of an URL on the web, using the banner User Agent and Referrer documentation. Sets the ERROR field.

Input Parameters

 1 path_info to be sent to server
Output Parameters

 1 contents of URL


AUTHOR

Elizabeth Mattijsen ( lizperl@INC.nl )


COPYRIGHT

(C) 1996-2000 International Network Consultants


HISTORY

Version 0.35, 14 June 2000

Method Random now calls RandomFromGroup as a method to fix problems with sub-classed modules.

Version 0.34, 30 August 1999

Now -use-s Liz.pm instead of Liz::SQL.pm.

Now longer places Exporter in ISA, it wasn't necessary.

Updated to new source typography.

Version 0.33, 24 August 1999

Added extra parameters to Random and Specific to indicate the namespace of the variable in which to store the HTML.

Version 0.32, 5 November 1998

Support added for TARGET= in method Specific.

Version 0.31, 6 October 1998

Further reduced the footprint by fully qualifying global variables.

Version 0.3, 24 September 1998

Loading of all Liz.pm routines removed. This should reduce the memory footprint significantly.

Version 0.2, 7 August 1998

Added TARGET functionality to new.

Version 0.1, 28 May 1998

First version of this true Perl module, based on routines developed previously in PHP.