Dave Rolsky > Plone-UserAgent-0.01 > Plone::UserAgent

Download:
Plone-UserAgent-0.01.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.01   Source  

NAME ^

Plone::UserAgent - An LWP agent with "logging into Plone" built-in

SYNOPSIS ^

    use Plone::UserAgent;

    my $ua =
        Plone::UserAgent->new
            ( username => 'foo',
              password => 'bar',
              base_uri => 'http://my.plone.site.example.com',
            );

    $ua->login();

    my $page_uri = $ua->make_uri( '/some/page' );

    my $response = $ua->get($page_uri);

DESCRIPTION ^

This module is a fairly trivial subclass of LWP::UserAgent that knows how to log in to a Plone site. It's been tested with 3.2.2.

Patches are welcome to add additional Plone-specific features (as long as they're nice patches, not gross, ugly patches).

METHODS ^

This class provides these methods;

Plone::UserAgent->new( ... ) ^

This method creates a new user agent object.

The constructor accepts the following parameters:

The constructor requires a username and password, but if you don't pass these , it will try to look them up the config file.

$ua->login()

Attempts to log in to the site. Throws an error if it fails.

$ua->make_uri($path)

Given a path, returns a URI based on the base_uri passed to the constructor. This is provided for convenience since it's used internally.

AUTHOR ^

Dave Rolsky, >autarch@urth.org<

BUGS ^

Please report any bugs or feature requests to bug-plone-useragent@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

DONATIONS ^

If you'd like to thank me for the work I've done on this module, please consider making a "donation" to me via PayPal. I spend a lot of free time creating free software, and would appreciate any support you'd care to offer.

Please note that I am not suggesting that you must do this in order for me to continue working on this particular software. I will continue to do so, inasmuch as I have in the past, for as long as it interests me.

Similarly, a donation made in this way will probably not make me work on this software much more, unless I get so many donations that I can consider working on free software full time, which seems unlikely at best.

To donate, log into PayPal and send money to autarch@urth.org or use the button on this page: http://www.urth.org/~autarch/fs-donation.html

COPYRIGHT & LICENSE ^

Copyright 2009 Dave Rolsky, All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: