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:

• base_uri

  The root URI of your Plone site. required.

• username

  The username to use when logging in to the site. required, but see below.

• password

  The username to use when logging in to the site. required, but see below.

• config_file

  An optional config file. This should be an INI config file. All that is expected to be in the file is a username and password, with no section header:

    username = foo
    password = bar

  This defaults to $HOME/.plone-useragentrc.

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.