View on
Dave Rolsky > Plone-UserAgent > Plone::UserAgent



Annotate this POD


Open  0
View/Report Bugs
Module Version: 0.01   Source  


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


    use Plone::UserAgent;

    my $ua =
            ( username => 'foo',
              password => 'bar',
              base_uri => '',


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

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


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).


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.


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


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.


Dave Rolsky, ><


Please report any bugs or feature requests to, or through the web interface at I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.


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 or use the button on this page:


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: