NAME

Mail::IspMailGate::Filter::Banner - Add a banner message to outgoing mails

SYNOPSIS

 # Create a filter
 my($filter) = Mail::IspMailGate::Filter::Banner->new({
     'plain' => '/etc/mail/banner.plain',
     'html' => '/etc/mail/banner.html'
 });

 # Call him for filtering a given mail (aka MIME::Entity)
 my ($attr) = {
     'entity' => $entity,    # a MIME::Entity object
     'parser' => $parser     # a MIME::Parser object
 };
 my($res) = $filter->doFilter($attr); 

DESCRIPTION

This class can be used for adding a banner message to the top of outgoing E-Mails. It knows about MIME types and can deal with plain text or HTML messages.

PUBLIC INTERFACE

new $ATTR

Class method. Create a new filter instance; you may supply two attributes: plain is the name of a banner file to attach to plain text mails and html is similar for HTML mails. The difference is, that the latter may contain HTML tags.