NAME

WWW::Pixelletter - an interface to the Pixelletter API

SYNOPSIS

  use WWW::Pixelletter;
  my $pl = WWW::Pixelletter->new( 'username' => $username, 'password' => $password, 'test' => undef );

DESCRIPTION

Interface to pixelletter (http://pixelletter.de/) to allow sending faxes.

See the included samples folder for a simple send_by_pixelletter.pl script wrapper around this module.

METHODS

new

  my $pl = WWW::Pixelletter->new( 'username'  => $username, 
                                       'password'  => $password,
                                       'test_mode' => undef );
  $pl->addFile( $filename1 );
  $pl->addFile( $filename2 );
  $pl->sendFax( $fax_number );

Variables: username Your username (email) for pixelletter password Your password test_mode [true|false] Default is false. Set to true if you want to test the interface without costs url The default url is defined in the package. Set to change to another base URL user_agent By default a LWP::UserAgent is initialised. You can pass an existing user agent here if you wish to recycle.

addFile

Add a file to the stack of outgoing files.

  $pl->addFile( $filename );

Allowed file types are: pdf doc xls ppt rtf wpd psd odt ods odp odg See the Pixelletter website for changes!

files

returns an array reference of the files already added

filecount

returns the number of files already added

sendFax

  $pl->sendFax( $fax_number );

Sends the files to the given fax number

sendPost

  $pl->sendPost( $post_center, $destination_country  );

Sends the files by post (the first file should have the address field visible through an envelope window!)

  $post_center  should be an integer indicating the post center to be used.
                Currently:  1 = Munich/Germany
                            2 = Wien/Austria
                            3 = Hamburg/Germany
                Check the Pixelletter documentation to confirm!
  $destination_countyr should be the 2 letter ISO code (e.g. 'DE', 'CH', 'AT' ...)

AUTHOR

Robin Clarke rcl@cpan.org

LASTMOD

13.01.2010

CREATED

29.12.2009